qiskit.pulse.Delay¶

class Delay(duration, channel, name=None)[source]¶

A blocking instruction with no other effect. The delay is used for aligning and scheduling other instructions.

Exemple

To schedule an instruction at time = 10, on a channel assigned to the variable channel, the following could be used:

sched = Schedule(name="Delay instruction example")
sched += Delay(10, channel)
sched += Gaussian(duration, amp, sigma, channel)

The channel will output no signal from time=0 up until time=10.

Create a new delay instruction.

No other instruction may be scheduled within a Delay.

Paramètres

duration (Union[int, ParameterExpression]) – Length of time of the delay in terms of dt.
channel (Channel) – The channel that will have the delay.
name (Optional[str]) – Name of the delay for display purposes.

__init__(duration, channel, name=None)[source]¶

Create a new delay instruction.

No other instruction may be scheduled within a Delay.

Paramètres

duration (Union[int, ParameterExpression]) – Length of time of the delay in terms of dt.
channel (Channel) – The channel that will have the delay.
name (Optional[str]) – Name of the delay for display purposes.

Methods

`__init__`(duration, channel[, name])	Create a new delay instruction.
`append`(schedule[, name])	Return a new `Schedule` with `schedule` inserted at the maximum time over all channels shared between `self` and `schedule`.
`assign_parameters`(value_dict)	Modify and return self with parameters assigned according to the input.
`ch_duration`(*channels)	Return duration of the supplied channels in this Instruction.
`ch_start_time`(*channels)	Return minimum start time for supplied channels.
`ch_stop_time`(*channels)	Return maximum start time for supplied channels.
`draw`([dt, style, filename, interp_method, …])	Plot the instruction.
`flatten`()	Return itself as already single instruction.
`insert`(start_time, schedule[, name])	Return a new `Schedule` with `schedule` inserted within `self` at `start_time`.
`is_parameterized`()	Return `True` iff the instruction is parameterized.
`shift`(time[, name])	Return a new schedule shifted forward by time.

Attributes

`channel`	Return the `Channel` that this instruction is scheduled on.
`channels`	Returns the channels that this schedule uses.
`duration`	Duration of this instruction.
`id`	Unique identifier for this instruction.
`instructions`	Iterable for getting instructions from Schedule tree.
`name`	Name of this instruction.
`operands`	Return instruction operands.
`parameters`	Parameters which determine the instruction behavior.
`start_time`	Relative begin time of this instruction.
`stop_time`	Relative end time of this instruction.

append(schedule, name=None)¶

Return a new Schedule with schedule inserted at the maximum time over all channels shared between self and schedule.

Paramètres

schedule (Union['Schedule', 'Instruction']) – Schedule or instruction to be appended
name (Optional[str]) – Name of the new schedule. Defaults to name of self

Renvoie

A new schedule with schedule a this instruction at t=0.

Type renvoyé

Schedule

assign_parameters(value_dict)¶

Modify and return self with parameters assigned according to the input.

Paramètres: value_dict (Dict[ParameterExpression, Union[ParameterExpression, float, int]]) – A mapping from Parameters to either numeric values or another Parameter expression.
Type renvoyé: Instruction
Renvoie: Self with updated parameters.

ch_duration(*channels)¶

Return duration of the supplied channels in this Instruction.

Paramètres: *channels – Supplied channels
Type renvoyé: int

ch_start_time(*channels)¶

Return minimum start time for supplied channels.

Paramètres: *channels – Supplied channels
Type renvoyé: int

ch_stop_time(*channels)¶

Return maximum start time for supplied channels.

Paramètres: *channels – Supplied channels
Type renvoyé: int

property channel¶

Return the Channel that this instruction is scheduled on.

Type renvoyé: Channel

property channels¶

Returns the channels that this schedule uses.

Type renvoyé: Tuple[Channel]

draw(dt=1, style=None, filename=None, interp_method=None, scale=1, plot_all=False, plot_range=None, interactive=False, table=True, label=False, framechange=True, channels=None)¶

Plot the instruction.

Paramètres

dt (float) – Time interval of samples
style (Optional[SchedStyle]) – A style sheet to configure plot appearance
filename (Optional[str]) – Name required to save pulse image
interp_method (Optional[Callable]) – A function for interpolation
scale (float) – Relative visual scaling of waveform amplitudes
plot_all (bool) – Plot empty channels
plot_range (Optional[Tuple[float]]) – A tuple of time range to plot
interactive (bool) – When set true show the circuit in a new window (this depends on the matplotlib backend being used supporting this)
table (bool) – Draw event table for supported instructions
label (bool) – Label individual instructions
framechange (bool) – Add framechange indicators
channels (Optional[List[Channel]]) – A list of channel names to plot

Renvoie

A matplotlib figure object of the pulse schedule

Type renvoyé

matplotlib.figure

property duration¶

Duration of this instruction.

Type renvoyé: Union[int, ParameterExpression]

flatten()¶

Return itself as already single instruction.

Type renvoyé: Instruction

property id¶

Unique identifier for this instruction.

Type renvoyé: int

insert(start_time, schedule, name=None)¶

Return a new Schedule with schedule inserted within self at start_time.

Paramètres

start_time (int) – Time to insert the schedule schedule
schedule (Union['Schedule', 'Instruction']) – Schedule or instruction to insert
name (Optional[str]) – Name of the new schedule. Defaults to name of self

Renvoie

A new schedule with schedule inserted with this instruction at t=0.

Type renvoyé

Schedule

property instructions¶

Iterable for getting instructions from Schedule tree.

Type renvoyé: Tuple[Tuple[int, Instruction]]

is_parameterized()[source]¶

Return True iff the instruction is parameterized.

Type renvoyé: bool

property name¶

Name of this instruction.

Type renvoyé: str

property operands¶

Return instruction operands.

Type renvoyé: Tuple

property parameters¶

Parameters which determine the instruction behavior.

Type renvoyé: Set

shift(time, name=None)¶

Return a new schedule shifted forward by time.

Paramètres

time (int) – Time to shift by
name (Optional[str]) – Name of the new schedule. Defaults to name of self

Renvoie

The shifted schedule.

Type renvoyé

Schedule

property start_time¶

Relative begin time of this instruction.

Type renvoyé: int

property stop_time¶

Relative end time of this instruction.

Type renvoyé: int