191 lines
8.6 KiB
Plaintext
191 lines
8.6 KiB
Plaintext
---
|
||
title: GaussianSquare
|
||
description: API reference for qiskit.pulse.GaussianSquare
|
||
in_page_toc_min_heading_level: 1
|
||
python_api_type: class
|
||
python_api_name: qiskit.pulse.GaussianSquare
|
||
---
|
||
|
||
<span id="qiskit-pulse-gaussiansquare" />
|
||
|
||
# qiskit.pulse.GaussianSquare
|
||
|
||
<Class id="qiskit.pulse.GaussianSquare" isDedicatedPage={true} github="https://github.com/qiskit/qiskit/tree/stable/0.16/qiskit/pulse/library/parametric_pulses.py" signature="GaussianSquare(duration, amp, sigma, width, name=None)" modifiers="class">
|
||
A square pulse with a Gaussian shaped risefall on either side:
|
||
|
||
$$
|
||
\begin{align}\begin{aligned}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) )\end{aligned}\end{align}
|
||
$$
|
||
|
||
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\_\_
|
||
|
||
<Function id="qiskit.pulse.GaussianSquare.__init__" signature="__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.
|
||
</Function>
|
||
|
||
## Methods
|
||
|
||
| | |
|
||
| ---------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
|
||
| [`__init__`](#qiskit.pulse.GaussianSquare.__init__ "qiskit.pulse.GaussianSquare.__init__")(duration, amp, sigma, width\[, name]) | Initialize the gaussian square pulse. |
|
||
| [`assign_parameters`](#qiskit.pulse.GaussianSquare.assign_parameters "qiskit.pulse.GaussianSquare.assign_parameters")(value\_dict) | Return a new ParametricPulse with parameters assigned. |
|
||
| [`draw`](#qiskit.pulse.GaussianSquare.draw "qiskit.pulse.GaussianSquare.draw")(\[dt, style, filename, interp\_method, …]) | Plot the pulse. |
|
||
| [`get_sample_pulse`](#qiskit.pulse.GaussianSquare.get_sample_pulse "qiskit.pulse.GaussianSquare.get_sample_pulse")() | Deprecated. |
|
||
| [`get_waveform`](#qiskit.pulse.GaussianSquare.get_waveform "qiskit.pulse.GaussianSquare.get_waveform")() | Return a Waveform with samples filled according to the formula that the pulse represents and the parameter values it contains. |
|
||
| [`validate_parameters`](#qiskit.pulse.GaussianSquare.validate_parameters "qiskit.pulse.GaussianSquare.validate_parameters")() | Validate parameters. |
|
||
|
||
## Attributes
|
||
|
||
| | |
|
||
| ------------------------------------------------------------------------------------------------ | ------------------------------------------------------ |
|
||
| [`amp`](#qiskit.pulse.GaussianSquare.amp "qiskit.pulse.GaussianSquare.amp") | The Gaussian amplitude. |
|
||
| [`id`](#qiskit.pulse.GaussianSquare.id "qiskit.pulse.GaussianSquare.id") | Unique identifier for this pulse. |
|
||
| [`parameters`](#qiskit.pulse.GaussianSquare.parameters "qiskit.pulse.GaussianSquare.parameters") | Return a dictionary containing the pulse’s parameters. |
|
||
| [`sigma`](#qiskit.pulse.GaussianSquare.sigma "qiskit.pulse.GaussianSquare.sigma") | The Gaussian standard deviation of the pulse width. |
|
||
| [`width`](#qiskit.pulse.GaussianSquare.width "qiskit.pulse.GaussianSquare.width") | The width of the square portion of the pulse. |
|
||
|
||
### amp
|
||
|
||
<Attribute id="qiskit.pulse.GaussianSquare.amp">
|
||
The Gaussian amplitude.
|
||
|
||
**Return type**
|
||
|
||
`Union`\[`complex`, `ParameterExpression`]
|
||
</Attribute>
|
||
|
||
### assign\_parameters
|
||
|
||
<Function id="qiskit.pulse.GaussianSquare.assign_parameters" signature="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.
|
||
</Function>
|
||
|
||
### draw
|
||
|
||
<Function id="qiskit.pulse.GaussianSquare.draw" signature="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*](qiskit.visualization.pulse.qcstyle#pulsestyle "qiskit.visualization.pulse.qcstyle.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
|
||
</Function>
|
||
|
||
### get\_sample\_pulse
|
||
|
||
<Function id="qiskit.pulse.GaussianSquare.get_sample_pulse" signature="get_sample_pulse()">
|
||
Deprecated.
|
||
|
||
**Return type**
|
||
|
||
`Waveform`
|
||
</Function>
|
||
|
||
### get\_waveform
|
||
|
||
<Function id="qiskit.pulse.GaussianSquare.get_waveform" signature="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`
|
||
</Function>
|
||
|
||
### id
|
||
|
||
<Attribute id="qiskit.pulse.GaussianSquare.id">
|
||
Unique identifier for this pulse.
|
||
|
||
**Return type**
|
||
|
||
`int`
|
||
</Attribute>
|
||
|
||
### parameters
|
||
|
||
<Attribute id="qiskit.pulse.GaussianSquare.parameters">
|
||
Return a dictionary containing the pulse’s parameters.
|
||
|
||
**Return type**
|
||
|
||
`Dict`\[`str`, `Any`]
|
||
</Attribute>
|
||
|
||
### sigma
|
||
|
||
<Attribute id="qiskit.pulse.GaussianSquare.sigma">
|
||
The Gaussian standard deviation of the pulse width.
|
||
|
||
**Return type**
|
||
|
||
`Union`\[`float`, `ParameterExpression`]
|
||
</Attribute>
|
||
|
||
### validate\_parameters
|
||
|
||
<Function id="qiskit.pulse.GaussianSquare.validate_parameters" signature="validate_parameters()">
|
||
Validate parameters.
|
||
|
||
**Raises**
|
||
|
||
[**PulseError**](qiskit.pulse.PulseError "qiskit.pulse.PulseError") – If the parameters passed are not valid.
|
||
|
||
**Return type**
|
||
|
||
`None`
|
||
</Function>
|
||
|
||
### width
|
||
|
||
<Attribute id="qiskit.pulse.GaussianSquare.width">
|
||
The width of the square portion of the pulse.
|
||
|
||
**Return type**
|
||
|
||
`Union`\[`float`, `ParameterExpression`]
|
||
</Attribute>
|
||
</Class>
|
||
|