§
    ¹³Ùg+  ã                  óº   — d Z ddlmZ ddlZddlmZ ddlmZmZ ddlZddl	m
Z
 ddlmZ ddlmZ dd	lmZmZ dd
lmZ  G d„ de¦  «        Z G d„ de
¦  «        ZdS )zRotation around the X axis.é    )ÚannotationsN)Úpi)ÚOptionalÚUnion)ÚControlledGate)ÚGate)ÚQuantumRegister)ÚParameterValueTypeÚParameterExpression)ÚStandardGatec                  ó|   ‡ — e Zd ZdZej        Z	 ddddœdˆ fd	„Zd
„ Z	 	 	 	 ddˆ fd„Z	d d!d„Z
d"d„Zd d#d„Zd„ Zˆ xZS )$ÚRXGateuÔ  Single-qubit rotation about the X axis.

    Can be applied to a :class:`~qiskit.circuit.QuantumCircuit`
    with the :meth:`~qiskit.circuit.QuantumCircuit.rx` method.

    **Circuit symbol:**

    .. code-block:: text

             â”Œâ”€â”€â”€â”€â”€â”€â”€â”�
        q_0: â”¤ Rx(Ï´) â”œ
             â””â”€â”€â”€â”€â”€â”€â”€â”˜

    **Matrix Representation:**

    .. math::

        \newcommand{\rotationangle}{\frac{\theta}{2}}

        RX(\theta) = \exp\left(-i \rotationangle X\right) =
            \begin{pmatrix}
                \cos\left(\rotationangle\right)   & -i\sin\left(\rotationangle\right) \\
                -i\sin\left(\rotationangle\right) & \cos\left(\rotationangle\right)
            \end{pmatrix}
    NÚdt)ÚdurationÚunitÚthetar
   ÚlabelúOptional[str]c               óX   •— t          ¦   «                              dd|g|||¬¦  «         dS )zCreate new RX gate.Úrxé   )r   r   r   N)ÚsuperÚ__init__)Úselfr   r   r   r   Ú	__class__s        €ú^/granary/edev/quantum/lib/python3.11/site-packages/qiskit/circuit/library/standard_gates/rx.pyr   zRXGate.__init__:   s3   ø€ õ 	‰Œ×Ò˜˜q 5 '°ÀÐPTÐÑUÔUÐUÐUÐUó    c                óô   — ddl m} ddlm} t	          dd¦  «        } ||| j        ¬¦  «        } || j        d         d¦  «        |d         gg fg}|D ]\  }}}|                     |||¦  «         Œ|| _        dS )z3
        gate rx(theta) a {r(theta, 0) a;}
        r   ©ÚQuantumCircuitr   )ÚRGateÚq©ÚnameN)	Úqiskit.circuit.quantumcircuitr    Úrr!   r	   r$   ÚparamsÚ_appendÚ
definition)	r   r    r!   r"   ÚqcÚrulesÚinstrÚqargsÚcargss	            r   Ú_definezRXGate._define@   s¯   € ð
 	AÐ@Ð@Ð@Ð@Ð@ØÐÐÐÐÐå˜A˜sÑ#Ô#ˆØˆ^˜A D¤IÐ.Ñ.Ô.ˆØ�%˜œ Aœ¨Ñ*Ô*¨Q¨q¬T¨F°BÐ7Ð8ˆØ#(ð 	,ð 	,ÑˆE�5˜%Ø�JŠJ�u˜e UÑ+Ô+Ð+Ð+àˆŒˆˆr   r   Únum_ctrl_qubitsÚintú
str | NoneÚ
ctrl_stateústr | int | NoneÚ	annotatedúbool | Nonec                ó   •— |s5|dk    r/t          | j        d         ||¬¦  «        }| j        |j        _        nE|€t	          d„ | j        D ¦   «         ¦  «        }t          ¦   «                              ||||¬¦  «        }|S )aä  Return a (multi-)controlled-RX 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   r   )r   r3   Nc              3  ó@   K  — | ]}t          |t          ¦  «        V — Œd S ©N)Ú
isinstancer   )Ú.0Úps     r   ú	<genexpr>z!RXGate.control.<locals>.<genexpr>n   s-   è è € ÐXÐXÀq¥
¨1Õ.AÑ BÔ BÐXÐXÐXÐXÐXÐXr   )r0   r   r3   r5   )ÚCRXGater'   r   Ú	base_gateÚanyr   Úcontrol)r   r0   r   r3   r5   Úgater   s         €r   rA   zRXGate.controlP   s•   ø€ ð. ð 	˜_°Ò1Ð1Ý˜4œ; qœ>°À:ÐNÑNÔNˆDØ#'¤:ˆDŒNÔ Ð ð Ð ÝÐXÐXÈDÌKÐXÑXÔXÑXÔX�	å‘7”7—?’?Ø /ØØ%Ø#ð	 #ñ ô ˆDð ˆr   FÚboolc                ó8   — t          | j        d          ¦  «        S )a  Return inverted RX gate.

        :math:`RX(\lambda)^{\dagger} = RX(-\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:`.RXGate` with an inverted parameter value.

        Returns:
            RXGate: inverse gate.
        r   )r   r'   ©r   r5   s     r   ÚinversezRXGate.inversex   s   € õ �t”{ 1”~�oÑ&Ô&Ð&r   c                óô   — |du rt          d¦  «        ‚t          j        | j        d         dz  ¦  «        }t          j        | j        d         dz  ¦  «        }t          j        |d|z  gd|z  |gg|¬¦  «        S )z%Return a numpy.array for the RX gate.Fú9unable to avoid copy while creating an array as requestedr   é   y       €      ð¿©Údtype)Ú
ValueErrorÚmathÚcosr'   ÚsinÚnumpyÚarray)r   rK   ÚcopyrN   rO   s        r   Ú	__array__zRXGate.__array__ˆ   sz   € à�5ˆ=ˆ=ÝÐXÑYÔYÐYÝŒh�t”{ 1”~¨Ñ)Ñ*Ô*ˆÝŒh�t”{ 1”~¨Ñ)Ñ*Ô*ˆÝŒ{˜S #¨¡)Ð,¨s°S©y¸#Ð.>Ð?ÀuÐMÑMÔMÐMr   ÚexponentÚfloatc                ó8   — | j         \  }t          ||z  ¦  «        S r9   )r'   r   )r   rT   r5   r   s       r   ÚpowerzRXGate.power�   s   € Ø”;‰ˆÝ�h Ñ&Ñ'Ô'Ð'r   c                óZ   — t          |t          ¦  «        r|                      |¦  «        S dS ©NF)r:   r   Ú_compare_parameters©r   Úothers     r   Ú__eq__zRXGate.__eq__”   s-   € Ý�e�VÑ$Ô$ð 	3Ø×+Ò+¨EÑ2Ô2Ð2Øˆur   r9   )r   r
   r   r   )r   NNN)r0   r1   r   r2   r3   r4   r5   r6   ©F©r5   rC   ©NN)rT   rU   r5   rC   )Ú__name__Ú
__module__Ú__qualname__Ú__doc__r   r   Ú_standard_gater   r/   rA   rF   rS   rW   r]   Ú__classcell__©r   s   @r   r   r      s  ø€ € € € € ðð ð4 "Ô(€Nð AEðVØRVÐ]aðVð Vð Vð Vð Vð Vð Vð Vðð ð ð$  !Ø Ø'+Ø!%ð&ð &ð &ð &ð &ð &ð &ðP'ð 'ð 'ð 'ð 'ð Nð Nð Nð Nð(ð (ð (ð (ð (ðð ð ð ð ð ð r   r   c                  ó`   ‡ — e Zd ZdZej        Z	 	 dddddœdˆ fd„Zd„ Zddd„Z	dd„Z
d„ Zˆ xZS )r>   u�  Controlled-RX gate.

    Can be applied to a :class:`~qiskit.circuit.QuantumCircuit`
    with the :meth:`~qiskit.circuit.QuantumCircuit.crx` method.

    **Circuit symbol:**

    .. code-block:: text

        q_0: â”€â”€â”€â”€â– â”€â”€â”€â”€
             â”Œâ”€â”€â”€â”´â”€â”€â”€â”�
        q_1: â”¤ Rx(Ï´) â”œ
             â””â”€â”€â”€â”€â”€â”€â”€â”˜

    **Matrix representation:**

    .. math::

        \newcommand{\rotationangle}{\frac{\theta}{2}}

        CRX(\theta)\ q_0, q_1 =
            I \otimes |0\rangle\langle 0| + RX(\theta) \otimes |1\rangle\langle 1| =
            \begin{pmatrix}
                1 & 0 & 0 & 0 \\
                0 & \cos\left(\rotationangle\right) & 0 & -i\sin\left(\rotationangle\right) \\
                0 & 0 & 1 & 0 \\
                0 & -i\sin\left(\rotationangle\right) & 0 & \cos\left(\rotationangle\right)
            \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: â”¤ Rx(Ï´) â”œ
                 â””â”€â”€â”€â”¬â”€â”€â”€â”˜
            q_1: â”€â”€â”€â”€â– â”€â”€â”€â”€

        .. math::

            \newcommand{\rotationangle}{\frac{\theta}{2}}

            CRX(\theta)\ q_1, q_0 =
            |0\rangle\langle0| \otimes I + |1\rangle\langle1| \otimes RX(\theta) =
                \begin{pmatrix}
                    1 & 0 & 0 & 0 \\
                    0 & 1 & 0 & 0 \\
                    0 & 0 & \cos\left(\rotationangle\right)   & -i\sin\left(\rotationangle\right) \\
                    0 & 0 & -i\sin\left(\rotationangle\right) & \cos\left(\rotationangle\right)
                \end{pmatrix}
    Nr   )r   r   Ú_base_labelr   r
   r   r   r3   úOptional[Union[str, int]]c               óx   •— t          ¦   «                              dd|gd||t          ||¬¦  «        ¬¦  «         dS )zCreate new CRX gate.ÚcrxrI   r   )r   )r0   r   r3   r?   N)r   r   r   )r   r   r   r3   r   r   ri   r   s          €r   r   zCRXGate.__init__×   sT   ø€ õ 	‰Œ×ÒØØØˆGØØØ!Ý˜U¨+Ð6Ñ6Ô6ð 	ñ 	
ô 	
ð 	
ð 	
ð 	
r   c           	     ó  — ddl m} ddlm} ddlm} ddlm} t          dd¦  «        } ||| j	        ¬	¦  «        } |t          dz  ¦  «        |d         gg f |¦   «         |d         |d         gg f || j        d          dz  dd¦  «        |d         gg f |¦   «         |d         |d         gg f || j        d         dz  t           dz  d¦  «        |d         gg fg}|D ]\  }}	}
|                     ||	|
¦  «         Œ|| _        d
S )z´
        gate cu3(theta,phi,lambda) c, t
        { u1(pi/2) t;
          cx c,t;
          u3(-theta/2,0,0) t;
          cx c,t;
          u3(theta/2,-pi/2,0) t;
        }
        r   r   r   )ÚU1Gate)ÚU3Gate)ÚCXGaterI   r"   r#   N)r%   r    Úu1rn   Úu3ro   Úxrp   r	   r$   r   r'   r(   r)   )r   r    rn   ro   rp   r"   r*   r+   r,   r-   r.   s              r   r/   zCRXGate._defineì   se  € ð 	AÐ@Ð@Ð@Ð@Ð@ØÐÐÐÐÐØÐÐÐÐÐØÐÐÐÐÐõ ˜A˜sÑ#Ô#ˆØˆ^˜A D¤IÐ.Ñ.Ô.ˆàˆV•B˜‘F‰^Œ^˜a œd˜V RÐ(ØˆV‰XŒX˜˜!œ˜a œd�| RÐ(ØˆV�T”[ ”^�O aÑ'¨¨AÑ.Ô.°°1´°¸Ð;ØˆV‰XŒX˜˜!œ˜a œd�| RÐ(ØˆV�D”K ”N QÑ&­¨¨a©°Ñ3Ô3°a¸´d°V¸RÐ@ð
ˆð $)ð 	,ð 	,ÑˆE�5˜%Ø�JŠJ�u˜e UÑ+Ô+Ð+Ð+àˆŒˆˆr   Fr5   rC   c                óF   — t          | j        d          | j        ¬¦  «        S )aû  Return inverse CRX gate (i.e. with the negative rotation angle).

        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:`.CRXGate` with an inverted parameter value.

        Returns:
            CRXGate: inverse gate.
        r   )r3   )r>   r'   r3   rE   s     r   rF   zCRXGate.inverse  s!   € õ ˜œ Aœ�°4´?ÐCÑCÔCÐCr   c           	     óf  — |du rt          d¦  «        ‚t          | j        d         ¦  «        dz  }t          j        |¦  «        }dt          j        |¦  «        z  }| j        r(t          j        g d¢d|d| gg d¢d| d|gg|¬¦  «        S t          j        |d| dgg d	¢| d|dgg d
¢g|¬¦  «        S )z&Return a numpy.array for the CRX gate.FrH   r   rI   y              ð?)r   r   r   r   )r   r   r   r   rJ   )r   r   r   r   )r   r   r   r   )	rL   rU   r'   rM   rN   rO   r3   rP   rQ   )r   rK   rR   Ú
half_thetarN   Úisins         r   rS   zCRXGate.__array__  sí   € à�5ˆ=ˆ=ÝÐXÑYÔYÐYÝ˜4œ; qœ>Ñ*Ô*¨QÑ.ˆ
ÝŒh�zÑ"Ô"ˆØ•D”H˜ZÑ(Ô(Ñ(ˆØŒ?ð 	Ý”;Ø��  3¨¨D¨5Ð1°<°<°<À!ÀdÀUÈAÈsÐASÐTÐ\aðñ ô ð õ ”;Ø�q˜4˜% Ð# \ \ \°T°E¸1¸cÀ1Ð3EÀ|À|À|ÐTÐ\aðñ ô ð r   c                óz   — t          |t          ¦  «        r%|                      |¦  «        o| j        |j        k    S dS rY   )r:   r>   rZ   r3   r[   s     r   r]   zCRXGate.__eq__,  s=   € Ý�e�WÑ%Ô%ð 	[Ø×+Ò+¨EÑ2Ô2ÐZ°t´È%ÔJZÒ7ZÐZØˆur   r`   )r   r
   r   r   r3   rj   r^   r_   )ra   rb   rc   rd   r   r>   re   r   r/   rF   rS   r]   rf   rg   s   @r   r>   r>   š   sÅ   ø€ € € € € ð8ð 8ðt "Ô)€Nð
  $Ø04ð	
ð ØØð
ð 
ð 
ð 
ð 
ð 
ð 
ð 
ð* ð  ð  ðDDð Dð Dð Dð Dðð ð ð ð ð ð ð ð ð ð r   r>   )rd   Ú
__future__r   rM   r   Útypingr   r   rP   Úqiskit.circuit.controlledgater   Úqiskit.circuit.gater   Úqiskit.circuit.quantumregisterr	   Ú"qiskit.circuit.parameterexpressionr
   r   Úqiskit._accelerate.circuitr   r   r>   © r   r   ú<module>r�      s,  ðð "Ð !à "Ð "Ð "Ð "Ð "Ð "à €€€Ø Ð Ð Ð Ð Ð Ø "Ð "Ð "Ð "Ð "Ð "Ð "Ð "Ø €€€à 8Ð 8Ð 8Ð 8Ð 8Ð 8Ø $Ð $Ð $Ð $Ð $Ð $Ø :Ð :Ð :Ð :Ð :Ð :Ø VÐ VÐ VÐ VÐ VÐ VÐ VÐ VØ 3Ð 3Ð 3Ð 3Ð 3Ð 3ðzð zð zð zð zˆTñ zô zð zðzUð Uð Uð Uð Uˆnñ Uô Uð Uð Uð Ur   