ShiftPhase¶

class ShiftPhase(phase, channel, name=None)[source]¶

Bases: qiskit.pulse.instructions.instruction.Instruction

The shift phase instruction updates the modulation phase of proceeding pulses played on the same Channel. It is a relative increase in phase determined by the phase operand.

In particular, a PulseChannel creates pulses of the form

\[Re[\exp(i 2\pi f jdt + \phi) d_j].\]

The ShiftPhase instruction causes \(\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.

Instantiate a shift phase instruction, increasing the output signal phase on channel by phase [radians].

Parameters

phase (Union[complex, ParameterExpression]) – The rotation angle in radians.
channel (PulseChannel) – The channel this instruction operates on.
name (Optional[str]) – Display name for this instruction.

Methods

`append`	Return a new `Schedule` with `schedule` inserted at the maximum time over all channels shared between `self` and `schedule`.
`ch_duration`	Return duration of the supplied channels in this Instruction.
`ch_start_time`	Return minimum start time for supplied channels.
`ch_stop_time`	Return maximum start time for supplied channels.
`draw`	Plot the instruction.
`insert`	Return a new `Schedule` with `schedule` inserted within `self` at `start_time`.
`is_parameterized`	Return True iff the instruction is parameterized.
`shift`	Return a new schedule shifted forward by time.

Attributes

channel¶

Return the Channel that this instruction is scheduled on.

Return type: PulseChannel

channels¶

Returns the channels that this schedule uses.

Return type: Tuple[PulseChannel]

duration¶

Duration of this instruction.

Return type: int

id¶

Unique identifier for this instruction.

Return type: int

instructions¶

Iterable for getting instructions from Schedule tree.

Return type: Tuple[Tuple[int, Instruction]]

name¶

Name of this instruction.

Return type: str

operands¶

Return instruction operands.

Return type: Tuple

parameters¶

Parameters which determine the instruction behavior.

Return type: Set

phase¶

Return the rotation angle enacted by this instruction in radians.

Return type: Union[complex, ParameterExpression]

start_time¶

Relative begin time of this instruction.

Return type: int

stop_time¶

Relative end time of this instruction.

Return type: int