z i$xSrSSKJr SSKJr SSKJrJrJr SSK J r SSK J r "SS \ 5r "S S \5rg ) z'Linearly-controlled X, Y or Z rotation.) annotations)Optional)QuantumRegisterQuantumCircuitGate) CircuitError)FunctionalPauliRotationsc^\rSrSrSrS S U4Sjjjr\SSj5r\RSSj5r\SSj5r \ RSSj5r SSjr SSS jjr U4S jr S r U=r$)LinearPauliRotationsuLinearly-controlled X, Y or Z rotation. For a register of state qubits :math:`|x\rangle`, a target qubit :math:`|0\rangle` and the basis ``'Y'`` this circuit acts as: .. code-block:: text q_0: ─────────────────────────■───────── ... ────────────────────── │ . │ q_(n-1): ─────────────────────────┼───────── ... ───────────■────────── ┌────────────┐ ┌───────┴───────┐ ┌─────────┴─────────┐ q_n: ─┤ RY(offset) ├──┤ RY(2^0 slope) ├ ... ┤ RY(2^(n-1) slope) ├ └────────────┘ └───────────────┘ └───────────────────┘ This can for example be used to approximate linear functions, with :math:`a =` ``slope``:math:`/2` and :math:`b =` ``offset``:math:`/2` and the basis ``'Y'``: .. math:: |x\rangle |0\rangle \mapsto \cos(ax + b)|x\rangle|0\rangle + \sin(ax + b)|x\rangle |1\rangle Since for small arguments :math:`\sin(x) \approx x` this operator can be used to approximate linear functions. cV>[TU]XUS9 SUlSUlX lX0lg)a! Args: num_state_qubits: The number of qubits representing the state :math:`|x\rangle`. slope: The slope of the controlled rotation. offset: The offset of the controlled rotation. basis: The type of Pauli rotation ('X', 'Y', 'Z'). name: The name of the circuit object. )num_state_qubitsbasisnameN)super__init___slope_offsetslopeoffset)selfrrrrr __class__s r/home/james-whalen/.local/lib/python3.13/site-packages/qiskit/circuit/library/arithmetic/linear_pauli_rotations.pyrLinearPauliRotations.__init__5s4 *:dS    cUR$)aThe multiplicative factor in the rotation angle of the controlled rotations. The rotation angles are ``slope * 2^0``, ``slope * 2^1``, ... , ``slope * 2^(n-1)`` where ``n`` is the number of state qubits. Returns: The rotation angle common in all controlled rotations. )rrs rrLinearPauliRotations.slopeOs{{rcjURbXR:waUR5 Xlgg)zcSet the multiplicative factor of the rotation angles. Args: The slope of the rotation angles. N)r _invalidate)rrs rrr[s- ;; %;;"6    K#7rcUR$)zThe angle of the single qubit offset rotation on the target qubit. Before applying the controlled rotations, a single rotation of angle ``offset`` is applied to the target qubit. Returns: The offset angle. )rrs rrLinearPauliRotations.offsetfs||rcjURbXR:waUR5 Xlgg)ziSet the angle for the offset rotation on the target qubit. Args: offset: The offset rotation angle. N)rr!)rrs rrr#rs- << 6\\#9    !L$:rcZ/UlU(a[USS9n[SSS9nX#/Ulgg)zSet the number of state qubits. Note that this changes the underlying quantum register, if the number of state qubits changes. Args: num_state_qubits: The new number of qubits. staterr targetN)qregsr)rrqr_state qr_targets r_reset_registers%LinearPauliRotations._reset_registers}s6 &'7gFH'9I".DJ rcSnURcSnU(a [S5eURURS-:a%SnU(a[SURS-S35eU$)z,Check if the current configuration is valid.TFz&The number of qubits has not been set.r z0Not enough qubits in the circuit, need at least .)rAttributeError num_qubitsr)rraise_on_failurevalids r_check_configuration)LinearPauliRotations._check_configurationsu  (E$%MNN ??T22Q6 6E"F,,q014  rc>UR(ag[TU] 5 [URUR UR UR5nURXR5 g)z(If not already built, build the circuit.N) _is_builtr_buildLinearPauliRotationsGaterrrrappendqubits)rgaters rr8LinearPauliRotations._buildsL >>  '(=(=tzz4;;X\XbXbc D++&r)rrrr)r)Nr rYLinRot) r Optional[int]rfloatrrArstrrrBreturnNone)rCrA)rrArCrD)rrArCrD)rr@rCrD)T)r2boolrCrE)__name__ __module__ __qualname____firstlineno____doc__rpropertyrsetterrr,r4r8__static_attributes__ __classcell__rs@rr r s:+/ '      4   \\     ]]""/"&''rr cX^\rSrSrSrSSU4SjjjrSrSrU=r$)r9uLinearly-controlled X, Y or Z rotation. For a register of state qubits :math:`|x\rangle`, a target qubit :math:`|0\rangle` and the basis ``'Y'`` this circuit acts as: .. parsed-literal:: q_0: ─────────────────────────■───────── ... ────────────────────── │ . │ q_(n-1): ─────────────────────────┼───────── ... ───────────■────────── ┌────────────┐ ┌───────┴───────┐ ┌─────────┴─────────┐ q_n: ─┤ RY(offset) ├──┤ RY(2^0 slope) ├ ... ┤ RY(2^(n-1) slope) ├ └────────────┘ └───────────────┘ └───────────────────┘ This can for example be used to approximate linear functions, with :math:`a =` ``slope``:math:`/2` and :math:`b =` ``offset``:math:`/2` and the basis ``'Y'``: .. math:: |x\rangle |0\rangle \mapsto \cos(ax + b)|x\rangle|0\rangle + \sin(ax + b)|x\rangle |1\rangle Since for small arguments :math:`\sin(x) \approx x` this operator can be used to approximate linear functions. cn>[TU]SUS-/US9 X lX0lUR 5Ulg)a Args: num_state_qubits: The number of qubits representing the state :math:`|x\rangle`. slope: The slope of the controlled rotation. offset: The offset of the controlled rotation. basis: The type of Pauli rotation ('X', 'Y', 'Z'). label: The label of the gate. LinPauliRotr )labelN)rrrrlowerr)rrrrrrTrs rr!LinearPauliRotationsGate.__init__s8 (81(>"7DOOa$78NN2& ::  JJt{{I . ZZ3  JJt{{I . JJt{{I .)FAzzS  DJJQ2CCs" DJJQ2CC DJJQ2CC *"r)rrdrr)r rr>N) rintrrArrArrBrTz str | NonerCrD) rFrGrHrIrJrrhrMrNrOs@rr9r9sd< ### #  #  # ##*""rr9N)rJ __future__rtypingrqiskit.circuitrrrqiskit.circuit.exceptionsrfunctional_pauli_rotationsr r r9rrrqs:."@@2@O'3O'dG"tG"r