qiskit.pulse.SetFrequency¶

class SetFrequency(frequency, channel, name=None)[source]¶

Set the channel frequency. This instruction operates on PulseChannel s. A PulseChannel creates pulses of the form

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

Here, \(f\) is the frequency of the channel. The instruction SetFrequency allows the user to set the value of \(f\). All pulses that are played on a channel after SetFrequency has been called will have the corresponding frequency.

The duration of SetFrequency is 0.

Creates a new set channel frequency instruction.

Paramètres

frequency (Union[float, ParameterExpression]) – New frequency of the channel in Hz.
channel (PulseChannel) – The channel this instruction operates on.
name (Optional[str]) – Name of this set channel frequency instruction.

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

Creates a new set channel frequency instruction.

Paramètres

frequency (Union[float, ParameterExpression]) – New frequency of the channel in Hz.
channel (PulseChannel) – The channel this instruction operates on.
name (Optional[str]) – Name of this set channel frequency instruction.

Methods

`__init__`(frequency, channel[, name])	Creates a new set channel frequency 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.
`frequency`	New frequency.
`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é: PulseChannel

property channels¶

Returns the channels that this schedule uses.

Type renvoyé: Tuple[PulseChannel]

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é: int

flatten()¶

Return itself as already single instruction.

Type renvoyé: Instruction

property frequency¶

New frequency.

Type renvoyé: Union[float, ParameterExpression]

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