g>dZddlmZddlmZddlZddlmZddlm Z ddl m Z ddl m Z dd lmZdd lmZGd d e ZGd deZGddeZdS)zU1 Gate.) annotations)expN)ControlledGate)Gate)ParameterValueType)QuantumRegister)_ctrl_state_to_int) StandardGatecreZdZdZejZ dddddfd Zd Z ddfd Z dddZ ddZ dZ xZ S)U1GateuSingle-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). .. warning:: This gate is deprecated. Instead, the following replacements should be used .. math:: U1(\theta) = P(\theta)= U(0,0,\theta) .. code-block:: python circuit = QuantumCircuit(1) circuit.p(lambda, 0) # or circuit.u(0, 0, lambda, 0) **Circuit symbol:** .. code-block:: text ┌───────┐ q_0: ┤ U1(θ) ├ └───────┘ **Matrix Representation:** .. math:: U1(\theta) = \begin{pmatrix} 1 & 0 \\ 0 & e^{i\theta} \end{pmatrix} **Examples:** .. math:: U1(\theta = \pi) = Z .. math:: U1(\theta = \pi/2) = S .. math:: U1(\theta = \pi/4) = T .. seealso:: :class:`~qiskit.circuit.library.standard_gates.RZGate`: This gate is equivalent to RZ up to a phase factor. .. math:: U1(\theta) = e^{i{\theta}/2} RZ(\theta) :class:`~qiskit.circuit.library.standard_gates.U3Gate`: U3 is a generalization of U2 that covers all single-qubit rotations, using two X90 pulses. Reference for virtual Z gate implementation: `1612.00858 `_ Ndt)durationunitthetarlabel str | NonecXtdd|g|||dS)zCreate new U1 gate.u1)rrrN)super__init__)selfrrrr __class__s ^/granary/edev/quantum/lib/python3.11/site-packages/qiskit/circuit/library/standard_gates/u1.pyrzU1Gate.__init__bs3 q5'PTUUUUUcddlm}ddlm}t dd}|||j}|dd|jd|dggfg}|D]\}}}||||||_dS)NrQuantumCircuitr)U3Gateqname) qiskit.circuit.quantumcircuitru3rrr"params_append definition) rrrr qcrulesinstrqargscargss r_definezU1Gate._definehs@@@@@@ As # # ^ADI . . .&At{1~..1;<#( , , E5% JJueU + + + +rrFnum_ctrl_qubitsint ctrl_statestr | int | None annotatedboolc2|s5|dkr/t|jd||}|j|j_n^|s7|5|dkr/t |jd||}|j|j_n%t ||||}|S)a Return a (multi-)controlled-U1 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. rr)rr0Nrr.rr0r2)CU1Gater%r base_gateMCU1Gatercontrolrr.rr0r2gaters rr:zU1Gate.controlus( _114;q>:NNND#':DN  z1o6I6IDKNO5IIID#':DN 77?? /%# #D  rc8t|jd S)aReturn inverted U1 gate (:math:`U1(\lambda)^{\dagger} = U1(-\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 a :class:`.U1Gate` with inverse parameter values. Returns: U1Gate: inverse gate. r)r r%rr2s rinversezU1Gate.inversest{1~o&&&rc|durtdt|jd}tjddgdtjd|zgg|S)z%Return a numpy.array for the U1 gate.F9unable to avoid copy while creating an array as requestedrr?dtype) ValueErrorfloatr%numpyarrayr)rrDcopylams r __array__zU1Gate.__array__s^ 5==XYY YDKN##{QFQ "s((;(;$<=UKKKKrcVt|to||SN) isinstancer _compare_parametersrothers r__eq__z U1Gate.__eq__s%%((LT-E-Ee-L-LLrrM)rrrrrNNFr.r/rrr0r1r2r3Fr2r3NN)__name__ __module__ __qualname____doc__r r _standard_gaterr-r:r?rKrR __classcell__rs@rr r sDDL"(N>BVOSZ^VVVVVVVV    ! '+ !!!!!!!F ' ' ' ' 'LLLLMMMMMMMrr cveZdZdZejZ ddddddfd Zd Z ddfd Z dddZ ddZ dZ xZ S)r7urControlled-U1 gate. This is a diagonal and symmetric gate that induces a phase on the state of the target qubit, depending on the control state. .. warning:: This gate is deprecated. Instead, the :class:`.CPhaseGate` should be used .. math:: CU1(\lambda) = CP(\lambda) .. code-block:: python circuit = QuantumCircuit(2) circuit.cp(lambda, 0, 1) **Circuit symbol:** .. code-block:: text q_0: ─■── │θ q_1: ─■── **Matrix representation:** .. math:: CU1(\theta) = I \otimes |0\rangle\langle 0| + U1 \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 U1 and RZ, CU1 and CRZ are different gates with a relative phase difference. Nr rr _base_labelrrrrr0r1c |tdd|gd||t|||| dS)zCreate new CU1 gate.cu1rr5r.rr0r8rrNrrr )rrrr0rrrars rrzCU1Gate.__init__sZ   G!U+666  rcddlm}ddlm}t dd}|||j}t |jddz |dggf||d|dggft |jd dz |dggf||d|dggft |jddz |dggfg}|D]\}}}||||||_ dS) z gate cu1(lambda) a,b { u1(lambda/2) a; cx a,b; u1(-lambda/2) b; cx a,b; u1(lambda/2) b; } rrr)CXGaterdr r!N) r#rxrhrr"r r%r&r') rrrhr r(r)r*r+r,s rr-zCU1Gate._defines6 A@@@@@ As # # ^ADI . . . DKNQ& ' '!A$ 4 VXX!ad|R ( T[^Oa' ( (1Q4&" 5 VXX!ad|R ( DKNQ& ' '!A$ 4  $) , , E5% JJueU + + + +rrFr.r/r2r3c|s4|2t|jd|dz|}|j|j_n%t ||||}|S)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. Returns: ControlledGate: controlled version of this gate. Nrr)r.rr6)r9r%rr8rr:r;s rr:zCU1Gate.controlsp( Z/DKNOas rr?zCU1Gate.inverse>s! A4?CCCCrc |durtdtdt|jdz}|jr$t jgdgdgdddd|gg|St jgdgddd|dggd g|S) z&Return a numpy.array for the CU1 gate.FrArBr)rrrr)rrrr)rrrrrC)rrrr)rErrFr%r0rGrH)rrDrIeiths rrKzCU1Gate.__array__Ms 5==XYY Y2dk!n---.. ? ;|||\\\Aq!T?KSX ;|||aD!_lllKSX rcvt|to$|j|jko||SrM)rNr7r0rOrPs rrRzCU1Gate.__eq__[s< ug & & 05#33 0((// rrW)rrrrr0r1rSrTrUrV)rXrYrZr[r r7r\rr-r:r?rKrRr]r^s@rr7r7s22h")N !'+           .B ! '+ @ D D D D D           rr7c`eZdZdZ ddddddfd ZdZ ddfd ZdddZdZxZ S)r9uMulti-controlled-U1 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. .. warning:: This gate is deprecated. Instead, the following replacements should be used .. math:: MCU1(\lambda) = MCP(\lambda) .. code-block:: python circuit = QuantumCircuit(5) circuit.mcp(lambda, list(range(4)), 4) **Circuit symbol:** .. code-block:: text q_0: ────■──── │ . │ q_(n-1): ────■──── ┌───┴───┐ q_n: ┤ U1(λ) ├ └───────┘ .. seealso:: :class:`~qiskit.circuit.library.standard_gates.CU1Gate`: The singly-controlled-version of this gate. Nr r`rJrr.r/rrr0r1c td|dz|g|||t|||| dS)zCreate new MCU1 gate.mcu1rr5reNrf) rrJr.rr0rrrars rrzMCU1Gate.__init__s_   a  E+!S 444  rcddlm}t|jd}|||j}|jdkrt |jdj}|jdkr t|jdj}nBddl m }|jdd|jdz zz }t|}|||j|}|D]\}} } | || | ||_dS)Nrrr r!r)_gray_code_chainrd) r#rr num_qubitsr"r.r r%r'r7r$rtr&) rrr r(r'rt scaled_lam bottom_gater*r+r,s rr-zMCU1Gate._defines@@@@@@ DOS 1 1 ^ADI . . .  1 $ $ A//:J  1 $ $ Q00;JJ , , , , , ,Q11E1I+JKJ!*--K))!T-A;OOJ#- , , E5% JJueU + + + +rrFr2r3c|sUt||}|j|z|z}t|jd||jz||}|j|j_n%t||||}|S)rkr)r.rr0r6) r r0r9r%r.rr8rr:)rr.rr0r2new_ctrl_stater<rs rr:zMCU1Gate.controls( +JHHJ"o@JNN A /$2F F) D $(:DN 77?? /%# #D  rcDt|jd |jS)aReturn inverted MCU1 gate (:math:`MCU1(\lambda)^{\dagger} = MCU1(-\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 a :class:`.MCU1Gate` with inverse parameter values. Returns: MCU1Gate: inverse gate. r)r9r%r.r>s rr?zMCU1Gate.inversesQ)=>>>rct|to4|j|jko$|j|jko||SrM)rNr9r.r0rOrPs rrRzMCU1Gate.__eq__sQ uh ' ' 0$(== 05#33 0((//  rrW)rJrr.r/rrr0r1rSrTrUrV) rXrYrZr[rr-r:r?rRr]r^s@rr9r9cs&&X!'+           0. ! '+ %%%%%%%N ? ? ? ? ?       rr9)r[ __future__rcmathrrGqiskit.circuit.controlledgaterqiskit.circuit.gater"qiskit.circuit.parameterexpressionrqiskit.circuit.quantumregisterrqiskit.circuit._utilsr qiskit._accelerate.circuitr r r7r9rrrsQ"""""" 888888$$$$$$AAAAAA::::::444444333333UMUMUMUMUMTUMUMUMpo o o o o no o o dR R R R R ~R R R R R r