gdZddlmZddlZddlmZddlZddlm Z ddl m Z ddl m Z mZddlmZGd d e ZdS) zTwo-qubit YY-rotation gate.) annotationsN)Optional)Gate)QuantumRegister)ParameterValueTypeParameterExpression) StandardGatec|eZdZdZejZ dddddfd Zd Z ddfd Z d d!dZ d"dZ d d#dZ dZ xZS)$RYYGateuA parametric 2-qubit :math:`Y \otimes Y` interaction (rotation about YY). 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.ryy` method. **Circuit Symbol:** .. code-block:: text ┌─────────┐ q_0: ┤1 ├ │ Ryy(ϴ) │ q_1: ┤0 ├ └─────────┘ **Matrix Representation:** .. math:: \newcommand{\rotationangle}{\frac{\theta}{2}} R_{YY}(\theta) = \exp\left(-i \rotationangle Y{\otimes}Y\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_{YY}(\theta = 0) = I .. math:: R_{YY}(\theta = \pi) = -i Y \otimes Y .. math:: R_{YY}\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 RYY gate.ryy)rr rN)super__init__)selfrrr r __class__s _/granary/edev/quantum/lib/python3.11/site-packages/qiskit/circuit/library/standard_gates/ryy.pyrzRYYGate.__init__Qs3 E7%(QUVVVVVc ddlm}ddlm}ddlm}ddlm}tdd}|j d}|||j }|tj dz |dggf|tj dz |dggf||d|dggf|||dggf||d|dggf|tj dz |dggf|tj dz |dggfg}|D]\} } } | | | | ||_d S) z4Calculate a subcircuit that implements this unitary.r)QuantumCircuit)CXGate)RXGate)RZGaterq)nameN)qiskit.circuit.quantumcircuitrxrrxrrzr rparamsr"nppi_append definition) rrrrr r!rqcrulesinstrqargscargss r_definezRYYGate._defineWs A@@@@@ As # # A ^ADI . . . VBEAI  1 + VBEAI  1 + VXX!ad|R ( VE]]QqTFB ' VXX!ad|R ( VRUFQJ  !A$ , VRUFQJ  !A$ , $) , , E5% JJueU + + + +rrnum_ctrl_qubitsint str | None ctrl_statestr | int | None annotated bool | Nonec|td|jD}t||||}|S)aReturn a (multi-)controlled-YY 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"RYYGate.control..s-TT1Jq*=>>TTTTTTr)r2rr5r7)anyr'rcontrol)rr2rr5r7gaters rrAzRYYGate.controlusX,  TT TTTTTIww+!     rFboolc8t|jd S)aReturn inverse RYY 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:`.RYYGate` with an inverted parameter value. Returns: RYYGate: inverse gate. r)r r')rr7s rinversezRYYGate.inverses A'''rc |durtdt|jd}tj|dz }dtj|dz z}t j|dd|gd|| dgd| |dg|dd|gg|S)z&Return a numpy.array for the RYY gate.Fz9unable to avoid copy while creating an array as requestedrry?)dtype) ValueErrorfloatr'mathcossinr(array)rrGcopyrrKisins r __array__zRYYGate.__array__s 5==XYY Ydk!n%%huqy!!DHUQY'''x1a C$ 2QsA4FqRSUXHY Z    rexponentrIc8|j\}t||zSr;)r'r )rrQr7rs rpowerz RYYGate.powers;x%'(((rcZt|tr||SdS)NF)r<r _compare_parameters)rothers r__eq__zRYYGate.__eq__s- eW % % 3++E22 2urr;)rrrr)rNNN)r2r3rr4r5r6r7r8)F)r7rC)NN)rQrIr7rC)__name__ __module__ __qualname____doc__r r _standard_gaterr1rArErPrSrW __classcell__)rs@rr r s22h")NAEWRV]aWWWWWWWW @ ! '+!% B ( ( ( ( (     )))))rr )r[ __future__rrJtypingrnumpyr(qiskit.circuit.gaterqiskit.circuit.quantumregisterr"qiskit.circuit.parameterexpressionrrqiskit._accelerate.circuitr r rrrfs"!"""""" $$$$$$::::::VVVVVVVV333333]]]]]d]]]]]r