g&dZddlmZddlZddlmZmZddlmZddl m Z ddl m Z dd l mZdd lmZGd d e ZdS) Controlled unitary gate.) annotationsN)OptionalUnion) CircuitError)QuantumCircuit)Gate)QuantumRegister)_ctrl_state_to_intcteZdZdZ d,ddd-fdZed.fd Zejd/dZed0dZejdZedZ e jdZ ed1d Z e jd2d"Z ed#Z e jd$Z d3d%Z d4d'Z d5d6fd+ ZxZS)7ControlledGaterNr) _base_labelnamestr num_qubitsintparamslistlabel Optional[str]num_ctrl_qubits Optional[int] definitionOptional['QuantumCircuit'] ctrl_stateOptional[Union[int, str]] base_gateOptional[Gate]c |dn||_t||||| | d|_||_tj||_d|_d|_ ||_ ||_ dS)a7Create a new ControlledGate. In the new gate the first ``num_ctrl_qubits`` of the gate are the controls. Args: name: The name of the gate. num_qubits: The number of qubits the gate acts on. params: A list of parameters for the gate. label: An optional label for the gate. num_ctrl_qubits: Number of control qubits. definition: A list of gate rules for implementing this gate. The elements of the list are tuples of (:meth:`~qiskit.circuit.Gate`, [qubit_list], [clbit_list]). ctrl_state: The control state in decimal or as a bitstring (e.g. '111'). If specified as a bitstring the length must equal num_ctrl_qubits, MSB on left. If None, use 2**num_ctrl_qubits-1. base_gate: Gate object to be controlled. Raises: CircuitError: If ``num_ctrl_qubits`` >= ``num_qubits``. CircuitError: ctrl_state < 0 or ctrl_state > 2**num_ctrl_qubits. Examples: Create a controlled standard gate and apply it to a circuit. .. plot:: :alt: Circuit diagram output by the previous code. :include-source: from qiskit import QuantumCircuit, QuantumRegister from qiskit.circuit.library.standard_gates import HGate qr = QuantumRegister(3) qc = QuantumCircuit(qr) c3h_gate = HGate().control(2) qc.append(c3h_gate, qr) qc.draw('mpl') Create a controlled custom gate and apply it to a circuit. .. plot:: :alt: Circuit diagram output by the previous code. :include-source: from qiskit import QuantumCircuit, QuantumRegister from qiskit.circuit.library.standard_gates import HGate qc1 = QuantumCircuit(2) qc1.x(0) qc1.h(1) custom = qc1.to_gate().control(2) qc2 = QuantumCircuit(4) qc2.append(custom, [0, 3, 1, 2]) qc2.draw('mpl') N)rdurationunitr) copyrsuper__init___num_ctrl_qubitsrdeepcopyr _ctrl_state _open_ctrlr_name) selfrrrrrrrrr!r"r __class__s S/granary/edev/quantum/lib/python3.11/site-packages/qiskit/circuit/controlledgate.pyr%zControlledGate.__init__sP"+!2 8H8H z6X\]]] !.- 33$ returnr cF|jr|}d|_t|jdd|j}t |jd}t|}t|dddD] \}}|dkr| |!| ||ddt|dddD] \}}|dkr| |!|Stj S)zReturn definition in terms of other basic gates. If the gate has open controls, as determined from :attr:`ctrl_state`, the returned definition is conjugated with X without changing the internal ``_definition``. Nq0)qargs)r) to_mutablerbinzfillrr rr enumeratexappendr$r)r+ closed_gatebit_ctrl_stateqreg qc_open_ctrlqindvalr,s r-rzControlledGate.definitionqs% ? &//++K%)K " 11!""5;;D where is the gate name for the default case of closed control qubits and is the integer value of the control state for the gate. _o)r)r*rr+s r-rzControlledGate.names. ? j55DO55 5: r.c||_dS)z}Set the name of the gate. Note the reported name may differ from the set name if the gate has open controls. N)r*)r+name_strs r-rzControlledGate.names  r.c|jS)ztGet number of control qubits. Returns: int: The number of control qubits for the gate. )r&rHs r-rzControlledGate.num_ctrl_qubitss $$r.c|t|krtdt|}|jt|jddz }|dks||kr|jdnd}td|d||_dS) zSet the number of control qubits. Args: num_ctrl_qubits (int): The number of control qubits. Raises: CircuitError: ``num_ctrl_qubits`` is not an integer in ``[1, num_qubits]``. z0The number of control qubits must be an integer.rrrNz!num_qubits - base_gate.num_qubitsz-The number of control qubits must be in `[1, z]`.)rrrgetattrrr&)r+r upper_limitlimits r-rzControlledGate.num_ctrl_qubitss c/22 2 2QRR Ro..o a(P(PP Q  /K"?"?$(N$:LL@cEYuYYYZZ Z /r.c|jS)z:Return the control state of the gate as a decimal integer.)r(rHs r-rzControlledGate.ctrl_states r.Union[int, str, None]cpt||j|_|jd|jzdz k|_dS)zSet the control state of this gate. Args: ctrl_state: The control state of the gate. Raises: CircuitError: ctrl_state is invalid. r1rN)r rr(rr))r+rs r-rzControlledGate.ctrl_states8.j$:NOO/At/C,Ca,GGr.cF|jr |jjStd)zGet parameters from base_gate. Returns: list: List of gate parameters. Raises: CircuitError: Controlled gate does not define a base gate ?Controlled gate does not define base gate for extracting params)rrrrHs r-rzControlledGate.paramss) > b>( (`aa ar.c|jr-|jjr||j_dS|rtddStd)zSet base gate parameters. Args: parameters (list): The list of parameters to set. Raises: CircuitError: If controlled gate does not define a base gate. z,cannot set parameters on immutable base gaterTN)rmutablerr)r+ parameterss r-rzControlledGate.paramssb > b~% S(2%%% S"#QRRR S S`aa ar.ctj|}|j|_|jrtj|j||_|SN)r#rrEr')r+memocpys r- __deepcopy__zControlledGate.__deepcopy__sKioo++--   D"mD,1133;;$<LL!77??Y???Lr.)NrNNNNN)rrrrrrrrrrrrrrrr)r/r )rBrC)r/r)r/r)rrQrY)r/r])F)rcr]r/rd)__name__ __module__ __qualname____doc__r%propertyrsetterrrrrr\rbrf __classcell__)r,s@r-rrs"" $)*1504$( PPPPPPPPPd&&&&&X&.''''   X  [[ %%X%000(   X  H H H H b bX b ]bb]b"     r.r)rl __future__rr#typingrrqiskit.circuit.exceptionsrquantumcircuitr gater quantumregisterr _utilsr rr.r-rxs"""""" """"""""222222+*****,,,,,,&&&&&&xxxxxTxxxxxr.