Skip to main contentIBM Quantum Documentation
This page is from an old version of Qiskit SDK and does not exist in the latest version. We recommend you migrate to the latest version. See the release notes for more information.

qiskit.pulse.GaussianSquare

class GaussianSquare(duration, amp, sigma, width, name=None)

GitHub

A square pulse with a Gaussian shaped risefall on either side:

risefall=(durationwidth)/20<=x<risefallf(x)=ampexp((1/2)(xrisefall/2)2/sigma2))risefall<=x<risefall+widthf(x)=amprisefall+width<=x<durationf(x)=ampexp((1/2)(x(risefall+width)/2)2/sigma2))risefall = (duration - width) / 2\\0 <= x < risefall\\f(x) = amp * exp( -(1/2) * (x - risefall/2)^2 / sigma^2) )\\risefall <= x < risefall + width\\f(x) = amp\\risefall + width <= x < duration\\f(x) = amp * exp( -(1/2) * (x - (risefall + width)/2)^2 / sigma^2) )

Initialize the gaussian square pulse.

Parameters

  • duration (int) – Pulse length in terms of the the sampling period dt.
  • amp (Union[complex, ParameterExpression]) – The amplitude of the Gaussian and of the square pulse.
  • sigma (Union[float, ParameterExpression]) – A measure of how wide or narrow the Gaussian risefall is; see the class docstring for more details.
  • width (Union[float, ParameterExpression]) – The duration of the embedded square pulse.
  • name (Optional[str]) – Display name for this pulse envelope.

__init__

__init__(duration, amp, sigma, width, name=None)

Initialize the gaussian square pulse.

Parameters

  • duration (int) – Pulse length in terms of the the sampling period dt.
  • amp (Union[complex, ParameterExpression]) – The amplitude of the Gaussian and of the square pulse.
  • sigma (Union[float, ParameterExpression]) – A measure of how wide or narrow the Gaussian risefall is; see the class docstring for more details.
  • width (Union[float, ParameterExpression]) – The duration of the embedded square pulse.
  • name (Optional[str]) – Display name for this pulse envelope.

Methods

__init__(duration, amp, sigma, width[, name])Initialize the gaussian square pulse.
assign_parameters(value_dict)Return a new ParametricPulse with parameters assigned.
draw([dt, style, filename, interp_method, …])Plot the pulse.
get_sample_pulse()Deprecated.
get_waveform()Return a Waveform with samples filled according to the formula that the pulse represents and the parameter values it contains.
validate_parameters()Validate parameters.

Attributes

ampThe Gaussian amplitude.
idUnique identifier for this pulse.
parametersReturn a dictionary containing the pulse’s parameters.
sigmaThe Gaussian standard deviation of the pulse width.
widthThe width of the square portion of the pulse.

amp

The Gaussian amplitude.

Return type

Union[complex, ParameterExpression]

assign_parameters

assign_parameters(value_dict)

Return a new ParametricPulse with parameters assigned.

Parameters

value_dict (Dict[ParameterExpression, Union[ParameterExpression, float, int]]) – A mapping from Parameters to either numeric values or another Parameter expression.

Return type

ParametricPulse

Returns

New pulse with updated parameters.

draw

draw(dt=1, style=None, filename=None, interp_method=None, scale=1, interactive=False)

Plot the pulse.

Parameters

  • dt (float) – Time interval of samples.
  • style (Optional[PulseStyle]) – 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
  • interactive (bool) – When set true show the circuit in a new window (this depends on the matplotlib backend being used supporting this)

Returns

A matplotlib figure object of the pulse envelope

Return type

matplotlib.figure

get_sample_pulse

get_sample_pulse()

Deprecated.

Return type

Waveform

get_waveform

get_waveform()

Return a Waveform with samples filled according to the formula that the pulse represents and the parameter values it contains.

Return type

Waveform

id

Unique identifier for this pulse.

Return type

int

parameters

Return a dictionary containing the pulse’s parameters.

Return type

Dict[str, Any]

sigma

The Gaussian standard deviation of the pulse width.

Return type

Union[float, ParameterExpression]

validate_parameters

validate_parameters()

Validate parameters.

Raises

PulseError – If the parameters passed are not valid.

Return type

None

width

The width of the square portion of the pulse.

Return type

Union[float, ParameterExpression]

Was this page helpful?
Report a bug or request content on GitHub.