gdZddlmZddlZddlmZddlZddlmZddl m Z ddl m Z m Z ddlmZGd d eZdS) zTwo-qubit XX-rotation gate.) annotationsN)Optional)Gate)QuantumRegister)ParameterValueTypeParameterExpression) StandardGatec|eZdZdZejZ dddddfd Zd Z ddfd Z d d!dZ d"dZ d d#dZ dZ xZS)$RXXGateuA parametric 2-qubit :math:`X \otimes X` interaction (rotation about XX). This gate is symmetric, and is maximally entangling at :math:`\theta = \pi/2`. Can be applied to a :class:`~qiskit.circuit.QuantumCircuit` with the :meth:`~qiskit.circuit.QuantumCircuit.rxx` method. **Circuit Symbol:** .. code-block:: text ┌─────────┐ q_0: ┤1 ├ │ Rxx(ϴ) │ q_1: ┤0 ├ └─────────┘ **Matrix Representation:** .. math:: \newcommand{\rotationangle}{\frac{\theta}{2}} R_{XX}(\theta) = \exp\left(-i \rotationangle X{\otimes}X\right) = \begin{pmatrix} \cos\left(\rotationangle\right) & 0 & 0 & -i\sin\left(\rotationangle\right) \\ 0 & \cos\left(\rotationangle\right) & -i\sin\left(\rotationangle\right) & 0 \\ 0 & -i\sin\left(\rotationangle\right) & \cos\left(\rotationangle\right) & 0 \\ -i\sin\left(\rotationangle\right) & 0 & 0 & \cos\left(\rotationangle\right) \end{pmatrix} **Examples:** .. math:: R_{XX}(\theta = 0) = I .. math:: R_{XX}(\theta = \pi) = -i X \otimes X .. math:: R_{XX}\left(\theta = \frac{\pi}{2}\right) = \frac{1}{\sqrt{2}} \begin{pmatrix} 1 & 0 & 0 & -i \\ 0 & 1 & -i & 0 \\ 0 & -i & 1 & 0 \\ -i & 0 & 0 & 1 \end{pmatrix} Ndt)durationunitthetarlabel Optional[str]cXtdd|g|||dS)zCreate new RXX gate.rxx)rr rN)super__init__)selfrrr r __class__s _/granary/edev/quantum/lib/python3.11/site-packages/qiskit/circuit/library/standard_gates/rxx.pyrzRXXGate.__init__Qs3 E7%(QUVVVVVc ddlm}ddlm}ddlm}ddlm}|jd}tdd}|||j }||dggf||dggf||d|dggf|||dggf||d|dggf||dggf||dggfg}|D]\} } } | | | | ||_ d S) z4Calculate a subcircuit that implements this unitary.r)QuantumCircuit)CXGate)HGate)RZGaterq)nameN) qiskit.circuit.quantumcircuitrxrhrrzr paramsrr"_append definition) rrrrr rr!qcrulesinstrqargscargss r_definezRXXGate._defineWsj A@@@@@ A As # # ^ADI . . . UWWqtfb ! UWWqtfb ! VXX!ad|R ( VE]]QqTFB ' VXX!ad|R ( UWWqtfb ! UWWqtfb ! $) , , E5% JJueU + + + +rrnum_ctrl_qubitsint str | None ctrl_statestr | int | None annotated bool | Nonec|td|jD}t||||}|S)aReturn a (multi-)controlled-RXX 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, in which case it cannot yet be synthesized. Returns: ControlledGate: controlled version of this gate. Nc3@K|]}t|tVdSN) isinstancer).0ps r z"RXXGate.control..s-TT1Jq*=>>TTTTTTr)r0rr3r5)anyr'rcontrol)rr0rr3r5gaters rr?zRXXGate.controlusX,  TT TTTTTIww+!     rFboolc8t|jd S)aReturn inverse RXX 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:`.RXXGate` with an inverted parameter value. Returns: RXXGate: inverse gate. r)r r')rr5s rinversezRXXGate.inverses A'''rc |durtdt|jddz }tj|}dtj|z}t j|dd| gd|| dgd| |dg| dd|gg|S)z&Return a Numpy.array for the RXX gate.Fz9unable to avoid copy while creating an array as requestedrry?)dtype) ValueErrorfloatr'mathcossinnumpyarray)rrEcopytheta2rIisins r __array__zRXXGate.__array__s 5==XYY Yt{1~&&*hvDHV$$${1a$ !S4%!3a$Q5G4%QRTUWZI[ \    rexponentrGc8|j\}t||zSr9)r'r )rrQr5rs rpowerz RXXGate.powers;x%'(((rcZt|tr||SdS)NF)r:r _compare_parameters)rothers r__eq__zRXXGate.__eq__s- eW % % 3++E22 2urr9)rrrr)rNNN)r0r1rr2r3r4r5r6)F)r5rA)NN)rQrGr5rA)__name__ __module__ __qualname____doc__r r _standard_gaterr/r?rCrPrSrW __classcell__)rs@rr r s22h")NAEWRV]aWWWWWWWW @ ! '+!% B ( ( ( ( (     )))))rr )r[ __future__rrHtypingrrKqiskit.circuit.gaterqiskit.circuit.quantumregisterr"qiskit.circuit.parameterexpressionrrqiskit._accelerate.circuitr r rrres"!""""""  $$$$$$::::::VVVVVVVV333333]]]]]d]]]]]r