g <dZddlmZddlZddlZddlZddlmZddlm Z m Z ddl Z ddl m Z ddlmZddlmZmZdd lmZdd lmZGd d eZGd deZGdde ZdS)zTwo-pulse single-qubit gate.) annotationsN)exp)OptionalUnion)ControlledGate)Gate)ParameterValueTypeParameterExpression)QuantumRegister) StandardGatecleZdZdZejZ dddddfd ZdddZ ddfd Z d dZ dZ xZ S)!UGateuGeneric single-qubit rotation gate with 3 Euler angles. Can be applied to a :class:`~qiskit.circuit.QuantumCircuit` with the :meth:`~qiskit.circuit.QuantumCircuit.u` method. **Circuit symbol:** .. code-block:: text ┌──────────┐ q_0: ┤ U(ϴ,φ,λ) ├ └──────────┘ **Matrix Representation:** .. math:: \newcommand{\rotationangle}{\frac{\theta}{2}} U(\theta, \phi, \lambda) = \begin{pmatrix} \cos\left(\rotationangle\right) & -e^{i\lambda}\sin\left(\rotationangle\right) \\ e^{i\phi}\sin\left(\rotationangle\right) & e^{i(\phi+\lambda)}\cos\left(\rotationangle\right) \end{pmatrix} .. note:: The matrix representation shown here is the same as in the `OpenQASM 3.0 specification `_, which differs from the `OpenQASM 2.0 specification `_ by a global phase of :math:`e^{i(\phi+\lambda)/2}`. **Examples:** .. math:: U\left(\theta, -\frac{\pi}{2}, \frac{\pi}{2}\right) = RX(\theta) .. math:: U(\theta, 0, 0) = RY(\theta) Ndt)durationunitthetar philamlabel Optional[str]c\tdd|||g|||dS)zCreate new U gate.u)rrrN)super__init__)selfrrrrrr __class__s ]/granary/edev/quantum/lib/python3.11/site-packages/qiskit/circuit/library/standard_gates/u.pyrzUGate.__init__Ms8 a%c!2%(Y]^^^^^F annotatedboolclt|jd |jd |jd S)aReturn inverted U gate. :math:`U(\theta,\phi,\lambda)^{\dagger} =U(-\theta,-\lambda,-\phi))` 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:`.UGate` with inverse parameter values. Returns: UGate: inverse gate. rr)rparamsrr s rinversez UGate.inverseZs.dk!n_t{1~o AGGGrrnum_ctrl_qubitsint str | None ctrl_statestr | int | None bool | Nonec2|sN|dkrHt|jd|jd|jdd||}|j|j_nE|t d|jD}t ||||}|S)aReturn a (multi-)controlled-U 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 set to ``True`` if the gate contains free parameters and more than one control qubit, in which case it cannot yet be synthesized. Otherwise it is set to ``False``. Returns: ControlledGate: controlled version of this gate. rrr#)rr*Nc3@K|]}t|tVdSN) isinstancer ).0ps r z UGate.control..s-XXq 1.A B BXXXXXXr)r'rr*r )CUGater$r base_gateanyrcontrol)rr'rr*r gaters rr7z UGate.controljs, _11 A A A% D$(:DN  XXDKXXXXX 77?? /%# #D  rc n|durtdd|jD\}}}tj|dz }tj|dz }t j|td|z |zgtd|z|ztd||zz|zgg|ptS)z$Return a numpy.array for the U gate.F9unable to avoid copy while creating an array as requestedc34K|]}t|VdSr/floatr1params rr3z"UGate.__array__..s(AAE5<<AAAAAArr#?dtype) ValueErrorr$mathcossinnumpyarrayrcomplex)rrBcopyrrrrErFs r __array__zUGate.__array__s 5==XYY YAAT[AAAsChuqy!!huqy!!{s28}}ns*+R#X$c"c *:&;&;c&AB "7     rcZt|tr||SdS)NF)r0r_compare_parametersrothers r__eq__z UGate.__eq__s- eU # # 3++E22 2urr/)rr rr rr rrFr r!)rNNN)r'r(rr)r*r+r r,NN) __name__ __module__ __qualname____doc__r r_standard_gaterr&r7rKrP __classcell__rs@rrrs**X"'N $ _  _ _ _ _ _ _ _ _HHHHH$ ! '+!% ,,,,,,,\     rrc,eZdZdZfdZfdZxZS) _CUGateParams)_gatecbt|j||_dSr/)rr_paramsr])rr8rs rrz_CUGateParams.__init__s( &&& rct||||jj|<t |t r\t t|dD]0\}}|dkrd|z}|dkr|||jj j |<1dS|dkrd|z}|dkr||jj j |<dSdS)Nr) r __setitem__r]r_r0slice enumeraterangeindicesr5r$)rkeyvalueibase_keyrs rrcz_CUGateParams.__setitem__s C'''"' 3 c5 ! ! 9 ) A)?@@ E E 8a<< 8|Ha<<Return inverted CU gate. :math:`CU(\theta,\phi,\lambda,\gamma)^{\dagger} = CU(-\theta,-\phi,-\lambda,-\gamma))` 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:`.CUGate` with inverse parameter values. Returns: CUGate: inverse gate. rr#rrb)r*)r4r$r*r%s rr&zCUGate.inverseOsL [^O [^O [^O [^O     rc @|durtdd|jD\}}}}tj|dz }tj|dz }t jd|z|z} t jd||zz |z} t jd||zz|z} t jd||z|zz|z} |jr&tj gdd| d| ggdd| d| gg| Stj | d| dggd | d| dggd g| S) z%Return a numpy.array for the CU gate.Fr:c34K|]}t|VdSr/r<r>s rr3z#CUGate.__array__..js(!H!H5%,,!H!H!H!H!H!Hrr#r@)rrrrr)rrrrrA)rrrr)rrrr) rCr$rDrErFcmathrr*rGrH) rrBrJrrrrorErFabcds rrKzCUGate.__array__fsa 5==XYY Y!H!HDK!H!H!HsChuqy!!huqy!! Ib5j ! !C ' YrUS[) * * *S 0 IbECK( ) )C / IbECK#-. / /# 5 ? ;1a|\\\Aq!Q<HPU ;Q1|||aAq\<<<HPU rc t|Sr/)r\)rs rr$z CUGate.paramszsT"""rcttt|j|||dd|j_dS)N)rrtyper$fsetr5)r parametersrs rr$z CUGate.params~sF nd4jj))055dJGGG *3B3rc||ni}t|}tj|j||_|Sr/)r __deepcopy___copydeepcopyr_)rmemooutrs rrzCUGate.__deepcopy__sD'ttRgg""4((nS[$77  rcvt|to$|j|jko||Sr/)r0r4r*rMrNs rrPz CUGate.__eq__s< uf % % 05#33 0((// rrS) rr rr rr ror rrr*rprQrRr/)rTrUrVrWr r4rXrr{r&rKpropertyr$setterrrPrYrZs@rr4r4s??B"(N $04          4>     .(##X# ]0000]0       rr4)rW __future__rrrJrrDrtypingrrrGqiskit.circuit.controlledgaterqiskit.circuit.gater"qiskit.circuit.parameterexpressionr r qiskit.circuit.quantumregisterr qiskit._accelerate.circuitr rlistr\r4rrrsl#"""""""  """""""" 888888$$$$$$VVVVVVVV::::::333333LLLLLDLLL^"9"9"9"9"9D"9"9"9JA A A A A ^A A A A A r