CompositeWaveform

class pulser.waveforms.CompositeWaveform(*waveforms)

Bases: Waveform

A waveform combining multiple smaller waveforms.

Parameters:

waveforms (Parametrized | Waveform) – Two or more waveforms to combine.

Attributes

duration	The duration of the pulse (in ns).
first_value	The first value in the waveform.
integral	Integral of the waveform (in [waveform units].µs).
last_value	The last value in the waveform.
samples	The value at each time step that describes the waveform.
waveforms	The waveforms encapsulated in the composite waveform.

Methods

change_duration	Returns a new waveform with modified duration.
draw	Draws the waveform.
modulated_samples	The waveform samples as output of a given channel.
modulation_buffers	The minimal buffers needed around a modulated waveform.
truncated	Returns a new waveform, truncated to a new duration.
with_new_duration	Returns a new waveform with modified duration.

Signatures

change_duration(new_duration)

Returns a new waveform with modified duration.

Warning

Deprecated since v1.6. Please use Waveform.with_new_duration() instead.

Parameters:

new_duration (int) – The duration of the new waveform.

Return type:

Waveform

draw(output_channel=None, ylabel=None)

Draws the waveform.

Parameters:

• output_channel (Channel | None, default: None) – The output channel. If given, will draw the modulated waveform on top of the input one.

• ylabel (str | None, default: None) – An optional label for the y-axis of the plot.

Return type:

None

modulated_samples(channel, eom=False)

The waveform samples as output of a given channel.

This duration is adjusted according to the minimal buffer times.

Parameters:

• channel (Channel) – The channel modulating the waveform.

• eom (bool, default: False) – Whether to modulate for the EOM.

Return type:

AbstractArray

Returns:

The array of samples after modulation.

modulation_buffers(channel, eom=False)

The minimal buffers needed around a modulated waveform.

Parameters:

• channel (Channel) – The channel modulating the waveform.

• eom (bool, default: False) – Whether to calculate the modulation buffers with the EOM bandwidth.

Return type:

tuple[int, int]

Returns:

The minimum buffer times at the start and end of the samples, in ns.

truncated(new_duration)

Returns a new waveform, truncated to a new duration.

If the new duration is above this waveform’s duration, a copy is returned instead.

Parameters:

new_duration (int) – The duration of the truncated waveform.

Return type:

Waveform

Returns:

The truncated waveform (if applicable).

with_new_duration(new_duration)

Returns a new waveform with modified duration.

Parameters:

new_duration (int) – The duration of the new waveform.

Return type:

Waveform

property duration: int

The duration of the pulse (in ns).

property first_value: float

The first value in the waveform.

property integral: float

Integral of the waveform (in [waveform units].µs).

property last_value: float

The last value in the waveform.

property samples: AbstractArray

The value at each time step that describes the waveform.

Returns:

A numpy array with a value for each time step.

property waveforms: list[Waveform]

The waveforms encapsulated in the composite waveform.