z i6SrSSKJr SSKJr SSKrSSKJr SSKJ r SSK J r SSK J r "S S \ 5r"S S \5r"S S\5rg)z Phase Gate.) annotations)expN)ControlledGate)Gate)ParameterValueType) StandardGatec^\rSrSrSr\R rS S U4SjjjrSr S SU4Sjjjr SSSjjr SSjr SSSjjr S rS rU=r$) PhaseGateuSingle-qubit rotation about the Z axis. This is a diagonal gate. It can be implemented virtually in hardware via framechanges (i.e. at zero error and duration). Can be applied to a :class:`~qiskit.circuit.QuantumCircuit` with the :meth:`~qiskit.circuit.QuantumCircuit.p` method. Circuit symbol: .. code-block:: text ┌──────┐ q_0: ┤ P(θ) ├ └──────┘ Matrix representation: .. math:: P(\theta) = \begin{pmatrix} 1 & 0 \\ 0 & e^{i\theta} \end{pmatrix} Examples: .. math:: P(\theta = \pi) = Z .. math:: P(\theta = \pi/2) = S .. math:: P(\theta = \pi/4) = T .. seealso:: :class:`~qiskit.circuit.library.standard_gates.RZGate`: This gate is equivalent to RZ up to a phase factor. .. math:: P(\theta) = e^{i{\theta}/2} RZ(\theta) Reference for virtual Z gate implementation: `1612.00858 `_ c(>[TU]SSU/US9 g)zQ Args: theta: The rotation angle. label: An optional label for the gate. plabelN)super__init__)selfthetar __class__s a/home/james-whalen/.local/lib/python3.13/site-packages/qiskit/circuit/library/standard_gates/p.pyrPhaseGate.__init__Ps a%6cSSKJn UR[RR UR 5SURS9UlgzDefault definitionr)QuantumCircuitT) legacy_qubitsnameN) qiskit.circuitr_from_circuit_datarPhase_get_definitionparamsr definitionrrs r_definePhaseGate._defineXsC 2 );;    . .t{{ ;4VZV_V_< rc2>U(d:US:Xa4[URSX#S9nURURlU$U(d=Uc:US:a4[ URSXS9nURURlU$[ TU]UUUUS9nU$)aReturn a (multi-)controlled-Phase 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. If ``None``, this is handled as ``False``. Returns: ControlledGate: controlled version of this gate. rr)r ctrl_staternum_ctrl_qubitsrr( annotated) CPhaseGater"r base_gate MCPhaseGatercontrolrr*rr(r+gaters rr/PhaseGate.controles(_1dkk!nEQD#'::DNN  z1o6It{{1~LD#'::DNN  7? /%# #D  rc4[URS*5$)aReturn inverted Phase gate (:math:`Phase(\lambda)^{\dagger} = Phase(-\lambda)`) 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 the inverse of this gate is always another :class:`.PGate` with an inverse parameter value. Returns: PGate: inverse gate. r)r r"rr+s rinversePhaseGate.inverses$++a.))rcUSLa [S5e[URS5n[R"SS/S[ SU-5//US9$)z(Return a numpy.array for the Phase gate.F9unable to avoid copy while creating an array as requestedrr?dtype) ValueErrorfloatr"numpyarrayr)rr;copylams r __array__PhaseGate.__array__sN 5=XY YDKKN#{{QFQBH $67uEErc8URun[X-5$N)r"r rexponentr+rs rpowerPhaseGate.powers;;)**rcP[U[5(aURU5$gNF) isinstancer _compare_parametersrothers r__eq__PhaseGate.__eq__s# eY ' '++E2 2rr#rE)rrr str | NonerNNNr*intrrSr(str | int | Noner+z bool | NoneFr+boolNNrGr=r+rZ)__name__ __module__ __qualname____firstlineno____doc__rr _standard_gaterr%r/r5rBrHrP__static_attributes__ __classcell__rs@rr r s~3j"''N77   ! '+!% !!!% !  !!F *F+rr c^\rSrSrSr\R rS SS.SU4SjjjjrSr SSU4Sjjjr SSSjjr S S jr SSS jjr S rS rU=r$)r,uControlled-Phase gate. This is a diagonal and symmetric gate that induces a phase on the state of the target qubit, depending on the control state. Can be applied to a :class:`~qiskit.circuit.QuantumCircuit` with the :meth:`~qiskit.circuit.QuantumCircuit.cp` method. Circuit symbol: .. code-block:: text q_0: ─■── │θ q_1: ─■── Matrix representation: .. math:: CPhase = I \otimes |0\rangle\langle 0| + P \otimes |1\rangle\langle 1| = \begin{pmatrix} 1 & 0 & 0 & 0 \\ 0 & 1 & 0 & 0 \\ 0 & 0 & 1 & 0 \\ 0 & 0 & 0 & e^{i\theta} \end{pmatrix} .. seealso:: :class:`~qiskit.circuit.library.standard_gates.CRZGate`: Due to the global phase difference in the matrix definitions of Phase and RZ, CPhase and CRZ are different gates with a relative phase difference. N _base_labelc <>[TU]SSU/SUU[XS9S9 g)zCreate new CPhase gate.cprrr*rr(r-Nrrr )rrrr(rirs rrCPhaseGate.__init__s3   G!9  rcSSKJn UR[RR UR 5SURS9Ulgr) rrrrCPhaser!r"rr#r$s rr%CPhaseGate._definesC 2);;    / / U(d;Uc8[URSUS-US9nURURlU$[TU]UUUUS9nU$)Controlled version of this 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. If ``None``, this is handled as ``False``. Returns: ControlledGate: controlled version of this gate. rrr*rr))r.r"rr-rr/r0s rr/CPhaseGate.controlsi(Z/t{{1~QR?RZ_`D#'::DNN  7? /%# #D  rcF[URS*URS9$)zRReturn inverted CPhase gate (:math:`CPhase(\lambda)^{\dagger} = CPhase(-\lambda)`)r)r()r,r"r(r4s rr5CPhaseGate.inverses4;;q>/dooFFrc USLa [S5e[S[URS5-5nUR(a#[ R "/SQ/SQ/SQSSSU//US9$[ R "/SQ/SQSSUS//S Q/US9$) z)Return a numpy.array for the CPhase gate.Fr8r9r)rrrr)rrrr)rrrrr:)rrrr)r<rr=r"r(r>r?)rr;r@eiths rrBCPhaseGate.__array__s 5=XY Y2dkk!n--. ??;;|\Aq!T?KSX {{L,AtQV^cddrc8URun[X-5$rE)r"r,rFs rrHCPhaseGate.power"s;;(*++rc[U[5(a1URU5=(a URUR:H$grK)rLr,rMr(rNs rrPCPhaseGate.__eq__&s7 eZ ( (++E2Zt%JZJZ7Z ZrrRr[)rrrrSr(rWrTrUrXrYr\)r]r^r_r`rarrqrbrr%r/r5rBrHrPrcrdres@rr,r,s%N"((N !'+    !  %   &  " ! '+!% %   @G e,rr,c^\rSrSrSrS SS.S U4SjjjjrSrS SU4SjjjrSSSjjrS r S r U=r $)r.i,uMulti-controlled-Phase gate. This is a diagonal and symmetric gate that induces a phase on the state of the target qubit, depending on the state of the control qubits. Can be applied to a :class:`~qiskit.circuit.QuantumCircuit` with the :meth:`~qiskit.circuit.QuantumCircuit.mcp` method. Circuit symbol: .. code-block:: text q_0: ───■──── │ . │ q_(n-1): ───■──── ┌──┴───┐ q_n: ┤ P(λ) ├ └──────┘ .. seealso:: :class:`~qiskit.circuit.library.standard_gates.CPhaseGate`: The singly-controlled-version of this gate. Nrhc B>[TU]SUS-U/UUU[XS9S9 g)zCreate new MCPhase gate.mcphaserrrmNrn)rrAr*rr(rirs rrMCPhaseGate.__init__Hs8   a  E+!7  rcfSSKJnJn U"URS5nU"X0RS9nUR S:XaUR URSS5 UR S:Xa!URURSSS5 OURSn[[UR 55nUR nUn[UR 5H*n URUSU -- XhSS9 UR5nM, UR USUR -- U5 X@l g) Nr)rQuantumRegisterq)rrrlF)use_basis_gates)rrr num_qubitsrr*r r"rklistrangemcrzpopr#) rrrqrqcrA q_controlsq_target new_targetks rr%MCPhaseGate._define\sB T__c 2 BYY /   1 $ DDQ #   1 $ EE$++a.!Q '++a.CeD$8$89:J++H!J4//0q!t jeT'^^- 1 DD4///0* =rc>U(dDUcA[URSXR-US9nURURlU$[ TU]UUUUS9nU$)rtrrur))r.r"r*rr-rr/r0s rr/MCPhaseGate.controlusr(Z/ A /2F2F FD $(::DNN  7? /%# #D  rc\[URS*URURS9$)zUReturn inverted MCPhase gate (:math:`MCPhase(\lambda)^{\dagger} = MCPhase(-\lambda)`)r)r*r()r.r"r*r(r4s rr5MCPhaseGate.inverses* [[^OT-A-Adoo  rc[U[5=(aQ URUR:H=(a1 URUR:H=(a UR U5$rE)rLr.r*r(rMrNs rrPMCPhaseGate.__eq__sV uk * 0$$(=(== 05#3#33 0((/  rrRr[)rArr*rVrrSr(rWrTrUrXrY) r]r^r_r`rarr%r/r5rPrcrdres@rr.r.,s>!'+       %   (6 ! '+!% """% "  ""H   rr.)ra __future__rcmathrr>qiskit.circuit.controlledgaterqiskit.circuit.gater"qiskit.circuit.parameterexpressionrqiskit._accelerate.circuitrr r,r.rrrsK" 8$A3LL^BBJy .y r