79 lines
5.0 KiB
Plaintext
79 lines
5.0 KiB
Plaintext
---
|
||
title: GaussianSquareDrag
|
||
description: API reference for qiskit.pulse.library.GaussianSquareDrag
|
||
in_page_toc_min_heading_level: 1
|
||
python_api_type: function
|
||
python_api_name: qiskit.pulse.library.GaussianSquareDrag
|
||
---
|
||
|
||
# qiskit.pulse.library.GaussianSquareDrag
|
||
|
||
<Function id="qiskit.pulse.library.GaussianSquareDrag" isDedicatedPage={true} github="https://github.com/qiskit/qiskit/tree/stable/0.23/qiskit/pulse/library/symbolic_pulses.py" signature="GaussianSquareDrag(duration, amp, sigma, beta, width=None, angle=0.0, risefall_sigma_ratio=None, name=None, limit_amplitude=None)">
|
||
A square pulse with a Drag shaped rise and fall
|
||
|
||
This pulse shape is similar to [`GaussianSquare`](qiskit.pulse.library.GaussianSquare "qiskit.pulse.library.GaussianSquare") but uses [`Drag`](qiskit.pulse.library.Drag "qiskit.pulse.library.Drag") for its rise and fall instead of [`Gaussian`](qiskit.pulse.library.Gaussian "qiskit.pulse.library.Gaussian"). The addition of the DRAG component of the rise and fall is sometimes helpful in suppressing the spectral content of the pulse at frequencies near to, but slightly offset from, the fundamental frequency of the drive. When there is a spectator qubit close in frequency to the fundamental frequency, suppressing the drive at the spectator’s frequency can help avoid unwanted excitation of the spectator.
|
||
|
||
Exactly one of the `risefall_sigma_ratio` and `width` parameters has to be specified.
|
||
|
||
If `risefall_sigma_ratio` is not `None` and `width` is `None`:
|
||
|
||
$$
|
||
\begin{split}\text{risefall} &= \text{risefall_sigma_ratio} \times \text{sigma}\\
|
||
\text{width} &= \text{duration} - 2 \times \text{risefall}\end{split}
|
||
$$
|
||
|
||
If `width` is not None and `risefall_sigma_ratio` is None:
|
||
|
||
$$
|
||
\text{risefall} = \frac{\text{duration} - \text{width}}{2}
|
||
$$
|
||
|
||
Gaussian $g(x, c, σ)$ and lifted gaussian $g'(x, c, σ)$ curves can be written as:
|
||
|
||
$$
|
||
\begin{split}g(x, c, σ) &= \exp\Bigl(-\frac12 \frac{(x - c)^2}{σ^2}\Bigr)\\
|
||
g'(x, c, σ) &= \frac{g(x, c, σ)-g(-1, c, σ)}{1-g(-1, c, σ)}\end{split}
|
||
$$
|
||
|
||
From these, the lifted DRAG curve $d'(x, c, σ, β)$ can be written as
|
||
|
||
$$
|
||
d'(x, c, σ, β) = g'(x, c, σ) \times \Bigl(1 + 1j \times β \times \Bigl(-\frac{x - c}{σ^2}\Bigr)\Bigr)
|
||
$$
|
||
|
||
The lifted gaussian square drag pulse $f'(x)$ is defined as:
|
||
|
||
$$
|
||
\begin{split}f'(x) &= \begin{cases} \text{A} \times d'(x, \text{risefall}, \text{sigma}, \text{beta}) & x < \text{risefall}\\
|
||
\text{A} & \text{risefall} \le x < \text{risefall} + \text{width}\\
|
||
\text{A} \times \times d'( x - (\text{risefall} + \text{width}), \text{risefall}, \text{sigma}, \text{beta} ) & \text{risefall} + \text{width} \le x \end{cases}\\\end{split}
|
||
$$
|
||
|
||
where $\text{A} = \text{amp} \times \exp\left(i\times\text{angle}\right)$.
|
||
|
||
**Parameters**
|
||
|
||
* **duration** (`Union`\[`int`, [`ParameterExpression`](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")]) – Pulse length in terms of the sampling period dt.
|
||
* **amp** (`Union`\[`float`, [`ParameterExpression`](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")]) – The amplitude of the DRAG rise and fall and of the square pulse.
|
||
* **sigma** (`Union`\[`float`, [`ParameterExpression`](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")]) – A measure of how wide or narrow the DRAG risefall is; see the class docstring for more details.
|
||
* **beta** (`Union`\[`float`, [`ParameterExpression`](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")]) – The DRAG correction amplitude.
|
||
* **width** (`Union`\[`float`, [`ParameterExpression`](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression"), `None`]) – The duration of the embedded square pulse.
|
||
* **angle** (`Union`\[`float`, [`ParameterExpression`](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression"), `None`]) – The angle in radians of the complex phase factor uniformly scaling the pulse. Default value 0.
|
||
* **risefall\_sigma\_ratio** (`Union`\[`float`, [`ParameterExpression`](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression"), `None`]) – The ratio of each risefall duration to sigma.
|
||
* **name** (`Optional`\[`str`]) – Display name for this pulse envelope.
|
||
* **limit\_amplitude** (`Optional`\[`bool`]) – If `True`, then limit the amplitude of the waveform to 1. The default is `True` and the amplitude is constrained to 1.
|
||
|
||
**Return type**
|
||
|
||
[`SymbolicPulse`](qiskit.pulse.library.SymbolicPulse "qiskit.pulse.library.symbolic_pulses.SymbolicPulse")
|
||
|
||
**Returns**
|
||
|
||
ScalableSymbolicPulse instance.
|
||
|
||
**Raises**
|
||
|
||
[**PulseError**](pulse#qiskit.pulse.PulseError "qiskit.pulse.PulseError") – When width and risefall\_sigma\_ratio are both empty or both non-empty.
|
||
</Function>
|
||
|