gk(JdZddlmZddlmZmZddlZddlmZm Z ddl m Z m Z m Z ddlmZddlmZd d lmZd dgdd ggZeeGd d e Ze ed Gdde Ze eddGdde ZdS)zZ, CZ and CCZ gates.)pi)OptionalUnionN)with_gate_arraywith_controlled_gate_array) SingletonGateSingletonControlledGatestdlib_singleton_key)QuantumRegister) StandardGate) PhaseGatec eZdZdZejZdddddeeffdZ e Z dZ dd e deed eeee fd effd Zdd efdZdded efdZdZxZS)ZGateuThe single-qubit Pauli-Z gate (:math:`\sigma_z`). Can be applied to a :class:`~qiskit.circuit.QuantumCircuit` with the :meth:`~qiskit.circuit.QuantumCircuit.z` method. **Matrix Representation:** .. math:: Z = \begin{pmatrix} 1 & 0 \\ 0 & -1 \end{pmatrix} **Circuit symbol:** .. code-block:: text ┌───┐ q_0: ┤ Z ├ └───┘ Equivalent to a :math:`\pi` radian rotation about the Z axis. .. note:: A global phase difference exists between the definitions of :math:`RZ(\pi)` and :math:`Z`. .. math:: RZ(\pi) = \begin{pmatrix} -i & 0 \\ 0 & i \end{pmatrix} = -i Z The gate is equivalent to a phase flip. .. math:: |0\rangle \rightarrow |0\rangle \\ |1\rangle \rightarrow -|1\rangle Ndt)durationunitlabelcVtddg|||dS)zCreate new Z gate.zr )rrrN)super__init__)selfrrr __class__s ]/granary/edev/quantum/lib/python3.11/site-packages/qiskit/circuit/library/standard_gates/z.pyrzZGate.__init__Os. a58$OOOOOcddlm}ddlm}t dd}|||j}|t |dggfg}|D]\}}}||||||_dS)NrQuantumCircuitr )U1Gateqname) qiskit.circuit.quantumcircuitr u1r!r r$r_append definition) rr r!r"qcrulesinstrqargscargss r_definez ZGate._defineUs@@@@@@ As # # ^ADI . . .&**qtfb)*#( , , E5% JJueU + + + +rr Fnum_ctrl_qubits ctrl_state annotatedc|s|dkrt|||j}n%t||||}|S)a2Return a (multi-)controlled-Z gate. One control returns a CZ gate. Args: num_ctrl_qubits: number of control qubits. label: An optional label for the gate [Default: ``None``] ctrl_state: control state expressed as integer, string (e.g.``'110'``), or ``None``. If ``None``, use all 1s. annotated: indicates whether the controlled gate should be implemented as an annotated gate. Returns: ControlledGate: controlled version of this gate. r )rr0 _base_label)r/rr0r1)CZGaterrcontrol)rr/rr0r1gaters rr5z ZGate.controlcs^, _11*$*UUUDD77?? /%# #D  rctS)aReturn inverted Z gate (itself). Args: annotated: when set to ``True``, this is typically used to return an :class:`.AnnotatedOperation` with an inverse modifier set instead of a concrete :class:`.Gate`. However, for this class this argument is ignored as this gate is self-inverse. Returns: ZGate: inverse gate (self-inverse). )rrr1s rinversez ZGate.inverses wwrexponentc:ttj|zSN)rnumpyr)rr:r1s rpowerz ZGate.powersH,---rc,t|tSr<) isinstancerrothers r__eq__z ZGate.__eq__s%'''rr<)r NNFF)__name__ __module__ __qualname____doc__r r_standard_gaterstrrr _singleton_lookup_keyr.intrboolr5r9floatr>rC __classcell__rs@rrrsY++Z"'NP4PPPhsmPPPPPP1022    !#04 }U38_-   B      ..e.....(((((((rrr/c eZdZdZejZ ddddddeedee ee fffdZ e d Z d Zdd efd ZdZxZS)r4u Controlled-Z gate. This is a Clifford and symmetric gate. Can be applied to a :class:`~qiskit.circuit.QuantumCircuit` with the :meth:`~qiskit.circuit.QuantumCircuit.cz` method. **Circuit symbol:** .. code-block:: text q_0: ─■─ │ q_1: ─■─ **Matrix representation:** .. math:: CZ\ q_0, q_1 = I \otimes |0\rangle\langle 0| + Z \otimes |1\rangle\langle 1| = \begin{pmatrix} 1 & 0 & 0 & 0 \\ 0 & 1 & 0 & 0 \\ 0 & 0 & 1 & 0 \\ 0 & 0 & 0 & -1 \end{pmatrix} In the computational basis, this gate flips the phase of the target qubit if the control qubit is in the :math:`|1\rangle` state. Nrrrr3rr0c xtddg|d|t||| dS)zCreate new CZ gate.czr rrr/r0 base_gaterrNrrrrrr0rrr3rs rrzCZGate.__init__sV   !+...  rr rQc@ddlm}ddlm}ddlm}t dd}|||j}||dggf||d|dggf||dggfg}|D]\}}} |||| ||_ d S) z3 gate cz a,b { h b; cx a,b; h b; } rrr HGate)CXGaterVr"r#N) r%r hr^xr_r r$r'r() rr r^r_r"r)r*r+r,r-s rr.zCZGate._defines A@@@@@ As # # ^ADI . . .%''AaD62&AaD!A$<(DuuwwQRSTQUPVXZF[\#( , , E5% JJueU + + + +rFr1c,t|jS)aReturn inverted CZ gate (itself). Args: annotated: when set to ``True``, this is typically used to return an :class:`.AnnotatedOperation` with an inverse modifier set instead of a concrete :class:`.Gate`. However, for this class this argument is ignored as this gate is self-inverse. Returns: CZGate: inverse gate (self-inverse). r0)r4r0r8s rr9zCZGate.inverses1111rcLt|to|j|jkSr<)r@r4r0rAs rrCz CZGate.__eq__s!%((PT_@P-PPrNNrD)rErFrGrHr r4rIrrJrrLrr rKr.rMr9rCrOrPs@rr4r4s@"(N $04     } U38_-      ,10CCC$ 2 2 2 2 2 2QQQQQQQrr4rV))r/ cached_statesc eZdZdZejZ ddddddeedee ee fffdZ e d Z d Zdd efd ZdZxZS)CCZGateu9CCZ gate. This is a symmetric gate. Can be applied to a :class:`~qiskit.circuit.QuantumCircuit` with the :meth:`~qiskit.circuit.QuantumCircuit.ccz` method. **Circuit symbol:** .. code-block:: text q_0: ─■─ │ q_1: ─■─ │ q_2: ─■─ **Matrix representation:** .. math:: CCZ\ q_0, q_1, q_2 = I \otimes I \otimes |0\rangle\langle 0| + CZ \otimes |1\rangle\langle 1| = \begin{pmatrix} 1 & 0 & 0 & 0 & 0 & 0 & 0 & 0 \\ 0 & 1 & 0 & 0 & 0 & 0 & 0 & 0 \\ 0 & 0 & 1 & 0 & 0 & 0 & 0 & 0 \\ 0 & 0 & 0 & 1 & 0 & 0 & 0 & 0 \\ 0 & 0 & 0 & 0 & 1 & 0 & 0 & 0 \\ 0 & 0 & 0 & 0 & 0 & 1 & 0 & 0 \\ 0 & 0 & 0 & 0 & 0 & 0 & 1 & 0 \\ 0 & 0 & 0 & 0 & 0 & 0 & 0 & -1 \end{pmatrix} In the computational basis, this gate flips the phase of the target qubit if the control qubits are in the :math:`|11\rangle` state. NrrSrr0c xtddg|d|t||| dS)zCreate new CCZ gate.cczrfrVrWrXNrZr[s rrzCCZGate.__init__#sV   !+...  rrVrQcNddlm}ddlm}ddlm}t dd}|||j}||d ggf||d|d|d ggf||d ggfg}|D]\}}} |||| ||_ d S) z9 gate ccz a,b,c { h c; ccx a,b,c; h c; } rrr r])CCXGaterfr"r#rVN) r%r r`r^rarmr r$r'r() rr r^rmr"r)r*r+r,r-s rr.zCCZGate._define;s A@@@@@ As # # ^ADI . . .%''AaD62&QqT1Q414F(KeeggXYZ[X\W]_aMbc#( , , E5% JJueU + + + +rFr1c,t|jS)aReturn inverted CCZ gate (itself). Args: annotated: when set to ``True``, this is typically used to return an :class:`.AnnotatedOperation` with an inverse modifier set instead of a concrete :class:`.Gate`. However, for this class this argument is ignored as this gate is self-inverse. Returns: CCZGate: inverse gate (self-inverse). rc)rir0r8s rr9zCCZGate.inverseMs$/2222rcLt|to|j|jkSr<)r@rir0rAs rrCzCCZGate.__eq__[s!%))QdoAQ.QQrrerD)rErFrGrHr rirIrrJrrLrr rKr.rMr9rCrOrPs@rriris$$L")N $04     } U38_-      ,10CCC$ 3 3 3 3 3 3RRRRRRRrri)rHmathrtypingrrr=qiskit.circuit._utilsrrqiskit.circuit.singletonrr r qiskit.circuit.quantumregisterr qiskit._accelerate.circuitr pr_Z_ARRAYrr4rirrrys"""""""" MMMMMMMMaaaaaaaaaa::::::333333 FQG w(w(w(w(w(Mw(w(w(tHa888\Q\Q\Q\Q\Q $\Q\Q98\Q~HatLLLbRbRbRbRbR%bRbRMLbRbRbRr