g(dZddlmZddlmZmZddlZddlm Z ddl m Z ddl m Z mZmZdd lmZGd d eZdS) Unitary gate.) annotations)IteratorIterableN)ParameterExpression) CircuitError)AnnotatedOperationControlModifier PowerModifier) InstructionceZdZdZ d-d.fd ZdZd/dZd0d1dZd2dZd2dZ d3d4d Z e d5d#Z e d6d&Z e d7d(Zd8d+Zd,ZxZS)9GaterNdtnamestr num_qubitsintparamslistlabel str | NonereturnNonec fd|_t||d||||dS)zCreate a new gate. Args: name: The Qobj name of the gate. num_qubits: The number of qubits the gate acts on. params: A list of parameters. label: An optional label for the gate. Nr)rdurationunit) definitionsuper__init__)selfrrrrrr __class__s I/granary/edev/quantum/lib/python3.11/site-packages/qiskit/circuit/gate.pyr z Gate.__init__s:" z1fEH[_````` np.ndarrayct|dr|tStdt |)aBReturn a Numpy.array for the gate unitary matrix. Returns: np.ndarray: if the Gate subclass has a matrix definition. Raises: CircuitError: If a Gate subclass does not implement this method an exception will be raised when this base class method is called. __array__)dtypezto_matrix not defined for this )hasattrr(complexrtype)r!s r# to_matrixzGate.to_matrix3sG 4 % % 1>>>00 0IT$ZZIIJJJr$Fexponentfloat annotatedboolcddlm}ddlm}|s5||||d|jd|St |t|S)aRaise this gate to the power of ``exponent``. Implemented either as a unitary gate (ref. :class:`~.library.UnitaryGate`) or as an annotated operation (ref. :class:`.AnnotatedOperation`). In the case of several standard gates, such as :class:`.RXGate`, when the power of a gate can be expressed in terms of another standard gate that is returned directly. Args: exponent (float): the power to raise the gate to annotated (bool): indicates whether the power gate can be implemented as an annotated operation. In the case of several standard gates, such as :class:`.RXGate`, this argument is ignored when the power of a gate can be expressed in terms of another standard gate. Returns: An operation implementing ``gate^exponent`` Raises: CircuitError: If gate is not unitary r)Operator) UnitaryGateT)assume_unitary^)r)qiskit.quantum_info.operatorsr30qiskit.circuit.library.generalized_gates.unitaryr4powerrr r )r!r.r0r3r4s r#r9z Gate.powerAs. ;:::::PPPPPP E;$$Xd$CCdiKdKdZbKdKd &dM(,C,CDD Dr$'Gate'c,||SN)r9)r!r.s r#__pow__z Gate.__pow__bszz(###r$cxt|jd||jg}|j|_|j|_|S)N*)rrr)rrrvalidate_parameterr)r!r.gates r#_return_repeatzGate._return_repeatesBDI2222tWYZZZ"&"9k  r$r num_ctrl_qubits ctrl_stateint | str | None bool | Nonecl|sddlm}|||||St|t||S)aReturn the controlled version of itself. Implemented either as a controlled gate (ref. :class:`.ControlledGate`) or as an annotated operation (ref. :class:`.AnnotatedOperation`). Args: num_ctrl_qubits: number of controls to add to gate (default: ``1``) label: optional gate label. Ignored if implemented as an annotated operation. ctrl_state: the control state in decimal or as a bitstring (e.g. ``'111'``). If ``None``, use ``2**num_ctrl_qubits-1``. annotated: indicates whether the controlled gate is implemented as an annotated gate. If ``None``, this is set to ``False`` if the controlled gate can directly be constructed, and otherwise set to ``True``. This allows defering the construction process in case the synthesis of the controlled gate requires more information (e.g. values of unbound parameters). Returns: Controlled version of the given operation. Raises: QiskitError: unrecognized mode or invalid ctrl_state r ) add_control)rCrD)rHr r )r!rCrrDr0rHs r#controlz Gate.controlks[>  0 0 0 0 0 0;t_eZHH H&ooR\]]] r$qargIterator[tuple[list, list]]c#"K|D] }|ggfV dS)zXExpands a single argument. For example: [q[0], q[1]] -> [q[0]], [q[1]] N)rJarg0s r#_broadcast_single_argumentzGate._broadcast_single_arguments6  D&"*      r$qarg0qarg1c#PKt|t|kr t||D] \}}||ggfVdSt|dkr|D]}|d|ggfVdSt|dkr|D]}||dggfVdStd|d|)Nr rz4Not sure how to combine these two-qubit arguments: z )lenzipr)rPrQrNarg1s r#_broadcast_2_argumentszGate._broadcast_2_argumentss u::U # #"%// ' ' dTlB&&&&& ' ' ZZ1__ + +Qx&***** + + ZZ1__ + +U1X&***** + +YYYRWYY r$qargsc#KtfdDr!tD]}t|gfVdStdd)Nc3dK|]*}t|tdkV+dS)rN)rS).0rJrWs r# z1Gate._broadcast_3_or_more_args..s8< [q[0]],[q[1]] * If len(qargs) == 2:: [[q[0], q[1]], [r[0], r[1]]] -> [q[0], r[0]], [q[1], r[1]] [[q[0]], [r[0], r[1]]] -> [q[0], r[0]], [q[0], r[1]] [[q[0], q[1]], [r[0]]] -> [q[0], r[0]], [q[1], r[0]] * If len(qargs) >= 3:: [q[0], q[1]], [r[0], r[1]], ...] -> [q[0], r[0], ...], [q[1], r[1], ...] Args: qargs: List of quantum bit arguments. cargs: List of classical bit arguments. Returns: A tuple with single arguments. Raises: CircuitError: If the input is not valid. For example, the number of arguments does not match the gate expectation. zThe amount of qubit(z)/clbit(z1) arguments does not match the gate expectation (z).c3K|]}| VdSr<rM)rZrJs r#r[z+Gate.broadcast_arguments..s$**D4x******r$z&One or more of the arguments are emptyrr zThis gate cannot handle z arguments)rSrranyrrOrVr_)r!rWr`s r#broadcast_argumentszGate.broadcast_argumentss^J u:: ( (E (Hs5zzHH3u::HH48OHHH  **E*** * * IGHH H u::??R  u::??2258<< < ZZ1__..uQxqBB B ZZ1__11%88 8P#e**PPPQQ Qr$ct|trIt|jdkr|S|sd|j}t ||St|ttfr|St|tj tj fr| St dt|d|jd)z>## #\T)__\\PTPY\\\]] ]r$)NNr) rrrrrrrrrr)rr&)F)r.r/r0r1)r.r/rr:)r NNN)rCrrrrDrEr0rF)rJrrrK)rPrrQrrrK)rWrrrK)rWrr`rrra)__name__ __module__ __qualname____doc__r __array_priority__r-r9r=rBrI staticmethodrOrVr_rgr@ __classcell__)r"s@r#rrs|! aaaaaaa* K K K KEEEEEB$$$$ ! '+!% (((((T\\*^^^\^9R9R9R9Rv^^^^^^^r$r)rv __future__rtypingrrnumpyrm"qiskit.circuit.parameterexpressionrqiskit.circuit.exceptionsrannotated_operationr r r instructionr rrMr$r#rs""""""%%%%%%%%BBBBBB222222SSSSSSSSSS$$$$$$n^n^n^n^n^;n^n^n^n^n^r$