gY<dZddlmZddlZddlmZddlmZmZddl Z ddl m Z ddl m Z ddlmZmZdd lmZdd lmZGd d e ZGd de ZdZdZdS)zTwo-pulse single-qubit gate.) annotationsN)exp)OptionalUnion)ControlledGate)Gate)ParameterValueTypeParameterExpression)QuantumRegister) StandardGatecreZdZdZejZ dddddfd ZdddZ dd fd Z dZ d!dZ dZ xZ S)"U3GateuGeneric single-qubit rotation gate with 3 Euler angles. .. warning:: This gate is deprecated. Instead, the following replacements should be used .. math:: U3(\theta, \phi, \lambda) = U(\theta, \phi, \lambda) .. code-block:: python circuit = QuantumCircuit(1) circuit.u(theta, phi, lambda) **Circuit symbol:** .. code-block:: text ┌───────────┐ q_0: ┤ U3(ϴ,φ,λ) ├ └───────────┘ **Matrix Representation:** .. math:: \newcommand{\rotationangle}{\frac{\theta}{2}} U3(\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 differs from the `OpenQASM 2.0 specification `_ by a global phase of :math:`e^{i(\phi+\lambda)/2}`. **Examples:** .. math:: U3(\theta, \phi, \lambda) = e^{-i \frac{\pi + \theta}{2}} P(\phi + \pi) \sqrt{X} P(\theta + \pi) \sqrt{X} P(\lambda) .. math:: U3\left(\theta, -\frac{\pi}{2}, \frac{\pi}{2}\right) = RX(\theta) .. math:: U3(\theta, 0, 0) = RY(\theta) Ndt)durationunitthetar philamlabel Optional[str]c\tdd|||g|||dS)zCreate new U3 gate.u3)rrrN)super__init__)selfrrrrrr __class__s ^/granary/edev/quantum/lib/python3.11/site-packages/qiskit/circuit/library/standard_gates/u3.pyrzU3Gate.__init__Ys8 q5#s"358Z^_____F annotatedboolclt|jd |jd |jd S)aReturn inverted U3 gate. :math:`U3(\theta,\phi,\lambda)^{\dagger} =U3(-\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:`.U3Gate` with inverse parameter values. Returns: U3Gate: inverse gate. rr)rparamsrr s rinversezU3Gate.inversefs.t{1~o AQHHHrrnum_ctrl_qubitsint str | None ctrl_statestr | int | None bool | Nonec|s*|dkr$t|j||d}|j|j_nE|t d|jD}t ||||}|S)aReturn a (multi-)controlled-U3 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. r)rr*Nc3@K|]}t|tVdSN) isinstancer ).0ps r z!U3Gate.control..s-XXq 1.A B BXXXXXXr)r'rr*r )CU3Gater$r base_gateanyrcontrol)rr'rr*r gaters rr7zU3Gate.controlvs, _11DKuLLLD#':DN  XXDKXXXXX 77?? /%# #D  rcddlm}tdd}|||j}||jd|jd|jdd||_dS)NrQuantumCircuitrqnamer#)qiskit.circuit.quantumcircuitr;r r>ur$ definition)rr;r<qcs r_definezU3Gate._definesn@@@@@@ As # # ^ADI . . . T[^T[^T[^Q???rc |durtd|j\}}}t|t|t|}}}tj|dz }tj|dz }t j|td|z |zgtd|z|ztd||zz|zgg|ptS)z%Return a Numpy.array for the U3 gate.F9unable to avoid copy while creating an array as requestedr#?dtype) ValueErrorr$floatmathcossinnumpyarrayrcomplexrrHcopyrrrrLrMs r __array__zU3Gate.__array__s 5==XYY Y+sC,,c E#JJCshuqy!!huqy!!{s28}}ns*+R#X$c"c *:&;&;c&AB "7     rcVt|to||Sr/)r0r_compare_parametersrothers r__eq__z U3Gate.__eq__s%%((LT-E-Ee-L-LLrr/)rr rr rr rrFr r!)rNNN)r'r(rr)r*r+r r,NN)__name__ __module__ __qualname____doc__r r_standard_gaterr&r7rCrSrX __classcell__rs@rrrs88t"(N $ `  ` ` ` ` ` ` ` `IIIII$ ! '+!% %%%%%%%N    MMMMMMMrrc`eZdZdZejZ ddddddfd ZdZdddZ ddZ dZ xZ S)r4u9 Controlled-U3 gate (3-parameter two-qubit gate). This is a controlled version of the U3 gate (generic single qubit rotation). It is restricted to 3 parameters, and so cannot cover generic two-qubit controlled gates). .. warning:: This gate is deprecated. Instead, the :class:`.CUGate` should be used .. math:: CU3(\theta, \phi, \lambda) = CU(\theta, \phi, \lambda, 0) .. code-block:: python circuit = QuantumCircuit(2) gamma = 0 circuit.cu(theta, phi, lambda, gamma, 0, 1) **Circuit symbol:** .. code-block:: text q_0: ──────■────── ┌─────┴─────┐ q_1: ┤ U3(ϴ,φ,λ) ├ └───────────┘ **Matrix representation:** .. math:: \newcommand{\rotationangle}{\frac{\theta}{2}} CU3(\theta, \phi, \lambda)\ q_0, q_1 = I \otimes |0\rangle\langle 0| + U3(\theta,\phi,\lambda) \otimes |1\rangle\langle 1| = \begin{pmatrix} 1 & 0 & 0 & 0 \\ 0 & \cos(\rotationangle) & 0 & -e^{i\lambda}\sin(\rotationangle) \\ 0 & 0 & 1 & 0 \\ 0 & e^{i\phi}\sin(\rotationangle) & 0 & e^{i(\phi+\lambda)}\cos(\rotationangle) \end{pmatrix} .. note:: In Qiskit's convention, higher qubit indices are more significant (little endian convention). In many textbooks, controlled gates are presented with the assumption of more significant qubits as control, which in our case would be q_1. Thus a textbook matrix for this gate will be: .. code-block:: text ┌───────────┐ q_0: ┤ U3(ϴ,φ,λ) ├ └─────┬─────┘ q_1: ──────■────── .. math:: \newcommand{\rotationangle}{\frac{\theta}{2}} CU3(\theta, \phi, \lambda)\ q_1, q_0 = |0\rangle\langle 0| \otimes I + |1\rangle\langle 1| \otimes U3(\theta,\phi,\lambda) = \begin{pmatrix} 1 & 0 & 0 & 0 \\ 0 & 1 & 0 & 0 \\ 0 & 0 & \cos(\rotationangle) & -e^{i\lambda}\sin(\rotationangle) \\ 0 & 0 & e^{i\phi}\sin(\rotationangle) & e^{i(\phi+\lambda)}\cos(\rotationangle) \end{pmatrix} Nr)rr _base_labelrr rrrrr*Optional[Union[str, int]]ctdd|||gd||t|||||| dS)zCreate new CU3 gate.cu3r#r)r)r'rr*r5rrN)rrr) rrrrrr*rrrdrs rrzCU3Gate.__init__ sc   C !UCK@@@  rc ddlm}ddlm}ddlm}t dd}|||j}||jd|jdzdz |dggf||jd|jdz dz |dggf||d|dggft|jd dz d|jd|jdz dz |dggf||d|dggft|jddz |jdd|dggfg}|D]\}}} | ||| ||_ d S) z gate cu3(theta,phi,lambda) c, t { u1((lambda+phi)/2) c; u1((lambda-phi)/2) t; cx c,t; u3(-theta/2,0,-(phi+lambda)/2) t; cx c,t; u3(theta/2,phi,0) t; } rr:r)U1GateCXGater#r<r=N) r?r;u1rixrkr r>r$r_appendrA) rr;rirkr<rBrulesinstrqargscargss rrCzCU3Gate._define#s A@@@@@ As # # ^ADI . . . VT[^dk!n49 : :QqTFB G VT[^dk!n49 : :QqTFB G VXX!ad|R ( T[^Oa'dk!nt{1~.M,NQR,R S SVWXYVZU[]_ ` VXX!ad|R ( DKNQ& A : :QqTFB G  $) , , E5% JJueU + + + +rFr r!czt|jd |jd |jd |jS)a3Return inverted CU3 gate. :math:`CU3(\theta,\phi,\lambda)^{\dagger} =CU3(-\theta,-\phi,-\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:`.CU3Gate` with inverse parameter values. Returns: CU3Gate: inverse gate. rr#r)r*)r4r$r*r%s rr&zCU3Gate.inverseGs> [^Odk!n_t{1~o$/    rc |durtd|j\}}}t|t|t|}}}tj|dz }tj|dz }|jrjtjgdd|dtd|z |zggddtd|z|zdtd||zz|zgg|ptStj|dtd|z |zdggd td|z|zdtd||zz|zdggd g|ptS) z&Return a numpy.array for the CU3 gate.FrEr#)rrrrrrF)rrrrrG)rrrr)rrrr) rIr$rJrKrLrMr*rNrOrrPrQs rrSzCU3Gate.__array__Zs 5==XYY Y+sC,,c E#JJCshuqy!!huqy!! ? ; LLQR#X 45 LLBH +QB#)4D0E0E0KL  &w ;!c"s(mm^c115 LLc]]S(!SsSy1A-B-BS-H!L LL  &w rcvt|to$|j|jko||Sr/)r0r4r*rUrVs rrXzCU3Gate.__eq__ws< ug & & 05#33 0((// rr[) rr rr rr rrr*rerYrZ) r\r]r^r_r r4r`rrCr&rSrXrarbs@rr4r4sLL\")N $04           2"""H     &:       rr4cdkrtddg}tD] |fdt|Dz }!fd|DS)z-Generate the gray code for ``num_bits`` bits.rz2Cannot generate the gray code for less than 1 bit.c g|] }|dzz S)r#)r1rmis r z'_generate_gray_code..s!6661q!t8666rc8g|]}t|ddS)0b)format)r1rmnum_bitss rrzz'_generate_gray_code..s+ 7 7 71F1o(ooo & & 7 7 7r)rIrangereversed)rresultrys` @r_generate_gray_coders{1}}MNNNSF 8__776666Xf%5%56666 7 7 7 7 7 7 77rc$ddlm}g}|d|||}}t|}d}|D]`} d| vr|| }t| d} dt | |D} d| vr| d} nd} | | | kr/|||| || ggfnTdt| D} | ddD]0}|||||| ggf1| ddzd kr3|| || |ggfn |||| |ggf| }b|S) a;Apply the gate to the last qubit in the register ``q``, controlled on all preceding qubits. This function uses the gray code to propagate down to the last qubit. Ported and adapted from Aqua (github.com/Qiskit/qiskit-aqua), commit 769ca8d, file qiskit/aqua/circuits/gates/multi_control_u1_gate.py. rrjN1c g|] \}}||k Srxrx)r1ryjs rrzz$_gray_code_chain..s >>>41aQ>>>rTc$g|] \}}|dk |S)rrx)r1ryrms rrzz$_gray_code_chain..s!HHHAqCxx1xxxrr#r) rmrkrlistindexzipappend enumeratecountr&)r<r'r8rkrule q_controlsq_target gray_code last_patternpatternlm_poscompposindicesidxs r_gray_code_chainrs D-o-./0BJ#O44IL g     "Lg$$S))?>3w #=#=>>> 4<<**T""CCC ?f}} VVXX 3F9K'LbQRRRRHH7););HHH"122;WWCKKJsOZ=O+PRT UVVVV ==   !Q & & KK*V*rsQ#""""""" """""""" 888888$$$$$$VVVVVVVV::::::333333ZMZMZMZMZMTZMZMZMzC C C C C nC C C L888+++++r