gdZddlmZmZmZddlmZddlmZddl m Z ddl m Z ddl mZGdd e ZGd d e Zd S) aThe phase instructions update the modulation phase of pulses played on a channel. This includes ``SetPhase`` instructions which lock the modulation to a particular phase at that moment, and ``ShiftPhase`` instructions which increase the existing phase by a relative amount. )OptionalUnionTuple)ParameterExpression) PulseChannel) Instruction) PulseError)deprecate_pulse_funcc eZdZdZe d deeefdede e ffd Z dZ e deeeffd Ze defd Ze deefd Ze defd ZxZS) ShiftPhaseaThe shift phase instruction updates the modulation phase of proceeding pulses played on the same :py:class:`~qiskit.pulse.channels.Channel`. It is a relative increase in phase determined by the ``phase`` operand. In particular, a PulseChannel creates pulses of the form .. math:: Re[\exp(i 2\pi f jdt + \phi) d_j]. The ``ShiftPhase`` instruction causes :math:`\phi` to be increased by the instruction's ``phase`` operand. This will affect all pulses following on the same channel. The qubit phase is tracked in software, enabling instantaneous, nearly error-free Z-rotations by using a ShiftPhase to update the frame tracking the qubit state. NphasechannelnamecRt||f|dS)a6Instantiate a shift phase instruction, increasing the output signal phase on ``channel`` by ``phase`` [radians]. Args: phase: The rotation angle in radians. channel: The channel this instruction operates on. name: Display name for this instruction. operandsrNsuper__init__selfr rr __class__s U/granary/edev/quantum/lib/python3.11/site-packages/qiskit/pulse/instructions/phase.pyrzShiftPhase.__init__,- 5'"2>>>>>cjt|jtstd|jddSzCalled after initialization to validate instruction data. Raises: PulseError: If the input ``channel`` is not type :class:`PulseChannel`. zExpected a pulse channel, got z instead.N isinstancerrr rs r _validatezShiftPhase._validate=A $, 55 WUdlUUUVV V W Wrreturnc|jdSzAReturn the rotation angle enacted by this instruction in radians.rrr s rr zShiftPhase.phaseF}Qrc|jdSzmReturn the :py:class:`~qiskit.pulse.channels.Channel` that this instruction is scheduled on. r&r s rrzShiftPhase.channelK }Qrc|jfSz-Returns the channels that this schedule uses.rr s rchannelszShiftPhase.channelsR rcdSzDuration of this instruction.rr s rdurationzShiftPhase.durationW qrN__name__ __module__ __qualname____doc__r rcomplexrrrstrrr!propertyr rrr/intr4 __classcell__rs@rr r sG  # ??W112??sm ?????? WWW uW&99:   X     X % -X#Xrr c eZdZdZe d deeefdede e ffd Z dZ e deeeffd Ze defd Ze deefd Ze defd ZxZS)SetPhaseaDThe set phase instruction sets the phase of the proceeding pulses on that channel to ``phase`` radians. In particular, a PulseChannel creates pulses of the form .. math:: Re[\exp(i 2\pi f jdt + \phi) d_j] The ``SetPhase`` instruction sets :math:`\phi` to the instruction's ``phase`` operand. Nr rrcRt||f|dS)a1Instantiate a set phase instruction, setting the output signal phase on ``channel`` to ``phase`` [radians]. Args: phase: The rotation angle in radians. channel: The channel this instruction operates on. name: Display name for this instruction. rNrrs rrzSetPhase.__init__jrrcjt|jtstd|jddSrrr s rr!zSetPhase._validate{r"rr#c|jdSr%r&r s rr zSetPhase.phaser'rc|jdSr)r&r s rrzSetPhase.channelr+rc|jfSr-r.r s rr/zSetPhase.channelsr0rcdSr2r3r s rr4zSetPhase.durationr5rr6r7rAs@rrCrC]sG   # ??W112??sm ?????? WWW uW&99:   X     X % -X#XrrCN)r;typingrrrqiskit.circuitrqiskit.pulse.channelsr%qiskit.pulse.instructions.instructionrqiskit.pulse.exceptionsr qiskit.utils.deprecate_pulser r rCr3rrrPs *)))))))))............======......======????????D;;;;;{;;;;;r