gE:dZddlmZddlmZddlZddlmZddlm Z ddl m Z ddl m Z dd lmZGd d e ZGd d eZGddeZdS)z Phase Gate.) annotations)expN)ControlledGate)Gate)QuantumRegister)ParameterValueType) StandardGatec|eZdZdZejZ dddddfd Zd Z ddfd Z dd dZ d!dZ dd"dZ dZ xZS)# PhaseGateu{Single-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 `_ Ndt)durationunitthetarlabel str | NonecXtdd|g|||dS)zCreate new Phase gate.p)rr rN)super__init__)selfrrr r __class__s ]/granary/edev/quantum/lib/python3.11/site-packages/qiskit/circuit/library/standard_gates/p.pyrzPhaseGate.__init__Qs2 a%tTTTTTcddlm}ddlm}t dd}|||j}||dd|jddg||_dS)NrQuantumCircuitr)UGateqname) qiskit.circuit.quantumcircuitrurrr!appendparams definition)rrrrqcs r_definezPhaseGate._defineWs@@@@@@ As # # ^ADI . . . %%1dk!n--s333rrnum_ctrl_qubitsint ctrl_statestr | int | None annotated bool | Nonec2|s5|dkr/t|jd||}|j|j_n^|s7|5|dkr/t |jd||}|j|j_n%t ||||}|S)a:Return 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)rr+Nrr)rr+r-) CPhaseGater%r base_gate MCPhaseGatercontrolrr)rr+r-gaters rr5zPhaseGate.controlas( _11dk!nEjQQQD#':DN  z1o6I6It{1~eLLLD#':DN 77?? /%# #D  rFboolc8t|jd S)a Return 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 rinversezPhaseGate.inverses$+a.)))rc|durtdt|jd}tjddgdt d|zgg|S)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__zPhaseGate.__array__sZ 5==XYY YDKN##{QFQBH $67uEEEErexponentrBc8|j\}t||zSN)r%r rrHr-rs rpowerzPhaseGate.powers;E)***rcZt|tr||SdSNF) isinstancer _compare_parametersrothers r__eq__zPhaseGate.__eq__s- eY ' ' 3++E22 2urrJ)rrrrrNNNr)r*rrr+r,r-r.Fr-r8NNrHrBr-r8)__name__ __module__ __qualname____doc__r r _standard_gaterr(r5r;rGrLrS __classcell__rs@rr r s33j"+N>BUOSZ^UUUUUUUU  ! '+!% !!!!!!!F * * * * *FFFF+++++rr ceZdZdZejZ ddddddfd Zd Z ddfd Z dd dZ ddZ dd!dZ dZ xZS)"r2uControlled-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. Nr r r _base_labelrrrrr+r,c |tdd|gd||t|||| dS)zCreate new CPhase gate.cprr0r)rr+r3r rNrrr )rrrr+r rrcrs rrzCPhaseGate.__init__sZ   G![999  rcddlm}tdd}|||j}||jddz d|dd||jd dz d|dd||jddz d||_dS)z gate cphase(lambda) a,b { phase(lambda/2) a; cx a,b; phase(-lambda/2) b; cx a,b; phase(lambda/2) b; } rrrfrr rN)r"rrr!rr%cxr&)rrrr's rr(zCPhaseGate._defines A@@@@@ As # # ^ADI . . . T[^a ### a  dk!n_q !$$$ a  T[^a ###rrr)r*r-r.c|s4|2t|jd|dz|}|j|j_n%t ||||}|S)2Controlled 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. Nrrr)rr1)r4r%rr3rr5r6s rr5zCPhaseGate.controlsq( Z/t{1~QR?RZ_```D#':DN 77?? /%# #D  rFr8cFt|jd |jS)zRReturn inverted CPhase gate (:math:`CPhase(\lambda)^{\dagger} = CPhase(-\lambda)`)r)r+)r2r%r+r:s rr;zCPhaseGate.inverses4;q>/doFFFFrc |durtdtdt|jdz}|jr$t jgdgdgdddd|gg|St jgdgddd|dggd g|S) z)Return a numpy.array for the CPhase gate.Fr=r>r)rrrr)rrrr)rrrrr?)rrrr)rArrBr%r+rCrD)rr@rEeiths rrGzCPhaseGate.__array__!s 5==XYY Y2dk!n---.. ? ;|||\\\Aq!T?KSX {LLL,,,AtQV^cddddrrHrBc8|j\}t||zSrJ)r%r2rKs rrLzCPhaseGate.power,s;(U*+++rczt|tr%||o|j|jkSdSrN)rOr2rPr+rQs rrSzCPhaseGate.__eq__0s= eZ ( ( [++E22Zt%JZ7Z ZurrX)rrrrr+r,rTrUrVrWrY)rZr[r\r]r r2r^rr(r5r;rGrLrSr_r`s@rr2r2s%%N",N !'+           .6 ! '+!% @GGGGG e e e e,,,,,rr2c`eZdZdZ ddddddfd ZdZ ddfd ZdddZdZxZ S)r4uMulti-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. Nr rbrFrr)r*rrr+r,c td|dz|g|||t|||| dS)zCreate new MCPhase gate.mcphaserr0rgNrh) rrFr)rr+r rrcrs rrzMCPhaseGate.__init__Rs_   a  E+!;777  rcdddlm}t|jd}|||j}|jdkr!||jdd|jdkr$||jdddn |jd}t|ttfvrtt|j}|j}|}t|jD]5}||d|zz ||d|}6||d|jzz |n`dd lm} |jdd|jdz zz } t%| } | ||j| D]\} } }|| | |||_dS) Nrrrr rrfF)use_basis_gates)_gray_code_chain)r"rr num_qubitsr!r)rr%retyperBr*listrangemcrzpopu3rxr2_appendr&)rrqrr'rF q_controlsq_target new_targetkrx scaled_lam bottom_gate operationqubitsclbitss rr(zMCPhaseGate._definejs@@@@@@ T_c 2 2 ^BTY / / /  1 $ $ DDQ # # #  1 $ $ EE$+a.!Q ' ' ' '+a.CCyyUCL((!%(<"="=>> /% t34422AGGC1a4L*jRWGXXX!+!1!1JJSAt334jAAAA000000![^qT5IA5M/NO (44 1A1A,k22::-IvvJJy&&9999rrr-r.c|s9|7t|jd||jz|}|j|j_n%t ||||}|S)rlNrrmr1)r4r%r)rr3rr5r6s rr5zMCPhaseGate.controls}( Z/ A /$2F FD $(:DN 77?? /%# #D  rFr8cDt|jd |jS)zUReturn inverted MCPhase gate (:math:`MCPhase(\lambda)^{\dagger} = MCPhase(-\lambda)`)r)r4r%r)r:s rr;zMCPhaseGate.inversesDKN?D,@AAArct|to4|j|jko$|j|jko||SrJ)rOr4r)r+rPrQs rrSzMCPhaseGate.__eq__sQ uk * * 0$(== 05#33 0((//  rrX)rFrr)r*rrr+r,rTrUrVrW) rZr[r\r]rr(r5r;rSr_r`s@rr4r46s>!'+           0F ! '+!% """""""HBBBBB       rr4)r] __future__rcmathrrCqiskit.circuit.controlledgaterqiskit.circuit.gaterqiskit.circuit.quantumregisterr"qiskit.circuit.parameterexpressionrqiskit._accelerate.circuitr r r2r4rrrs8"""""" 888888$$$$$$::::::AAAAAA333333GGGGGGGGTPPPPPPPPfC C C C C .C C C C C r