qiskit-documentation/docs/api/qiskit/0.30/qiskit.ignis.characterizati...

229 lines
5.5 KiB
Plaintext
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
title: RabiFitter
description: API reference for qiskit.ignis.characterization.RabiFitter
in_page_toc_min_heading_level: 1
python_api_type: class
python_api_name: qiskit.ignis.characterization.RabiFitter
---
# RabiFitter
<Class id="qiskit.ignis.characterization.RabiFitter" isDedicatedPage={true} github="https://github.com/qiskit-community/qiskit-ignis/tree/stable/0.6/qiskit/ignis/characterization/calibrations/fitters.py" signature="RabiFitter(backend_result, xdata, qubits, fit_p0, fit_bounds=None)" modifiers="class">
Bases: `qiskit.ignis.characterization.fitters.IQFitter`
Rabi Experiment fitter
See BaseCalibrationFitter \_\_init\_\_
fit\_po is \[amp, freq, phase, offset]
## Methods
### add\_data
<Function id="qiskit.ignis.characterization.RabiFitter.add_data" signature="RabiFitter.add_data(results, recalc=True, refit=True)">
Add new execution results to previous execution results
**Parameters**
* **results** (`Union`\[`Result`, `List`\[`Result`]]) new execution results
* **recalc** (`bool`) whether tp recalculate the data
* **refit** (`bool`) whether to refit the data
</Function>
### fit\_data
<Function id="qiskit.ignis.characterization.RabiFitter.fit_data" signature="RabiFitter.fit_data(qid=- 1, p0=None, bounds=None, series=None)">
Fit the curve.
Compute self.\_params and self.\_params\_err
**Parameters**
* **qid** (`int`) qubit for fitting. If -1 fit for all the qubits
* **p0** (`Optional`\[`List`\[`float`]]) initial guess, equivalent to p0 in scipy.optimize
* **bounds** (`Optional`\[`Tuple`\[`List`\[`float`], `List`\[`float`]]]) bounds, equivalent to bounds in scipy.optimize
* **series** (`Optional`\[`str`]) series to fit (if None fit all)
</Function>
### guess\_params
<Function id="qiskit.ignis.characterization.RabiFitter.guess_params" signature="RabiFitter.guess_params(qind=0)">
Guess fit parameters for rabi oscillation data
**Parameters**
**qind** (*int*) qubit index to guess fit parameters for
**Returns**
**List of fit guess parameters**
\[amp, freq, phase, offset]
**Return type**
list
</Function>
### pi2\_amplitude
<Function id="qiskit.ignis.characterization.RabiFitter.pi2_amplitude" signature="RabiFitter.pi2_amplitude(qind=- 1)">
Return the pi/2 amplitude from the fit
**Parameters**
**qind** (*int*) qubit index
**Returns**
$\frac{\pi}{2}$ amp
**Return type**
float
</Function>
### pi\_amplitude
<Function id="qiskit.ignis.characterization.RabiFitter.pi_amplitude" signature="RabiFitter.pi_amplitude(qind=- 1)">
Return the pi amplitude from the fit
**Parameters**
**qind** (*int*) qubit index
**Returns**
$\pi$ amp
**Return type**
float
</Function>
### plot
<Function id="qiskit.ignis.characterization.RabiFitter.plot" signature="RabiFitter.plot(qind, series='0', ax=None, show_plot=False)">
Plot the data and fit
**Parameters**
* **qind** (*int*) qubit index
* **series** (*str*) data series to plot (for rabi data always 0)
* **ax** (*Axes*) matploblib axes (if none created)
* **show\_plot** (*bool*) do plot.show
**Returns**
Plot axes
**Return type**
Axes
</Function>
## Attributes
### backend\_result
<Attribute id="qiskit.ignis.characterization.RabiFitter.backend_result">
Return the execution results
**Return type**
`Union`\[`Result`, `List`\[`Result`]]
</Attribute>
### description
<Attribute id="qiskit.ignis.characterization.RabiFitter.description">
Return the fitters purpose, e.g. T1
**Return type**
`str`
</Attribute>
### fit\_fun
<Attribute id="qiskit.ignis.characterization.RabiFitter.fit_fun">
Return the function used in the fit, e.g. BaseFitter.\_exp\_fit\_fun
**Return type**
`Callable`
</Attribute>
### measured\_qubits
<Attribute id="qiskit.ignis.characterization.RabiFitter.measured_qubits">
Return the indices of the qubits to be characterized
**Return type**
`List`\[`int`]
</Attribute>
### params
<Attribute id="qiskit.ignis.characterization.RabiFitter.params">
Return the fit function parameters that were calculated by curve\_fit
**Return type**
`List`\[`float`]
</Attribute>
### params\_err
<Attribute id="qiskit.ignis.characterization.RabiFitter.params_err">
Return the error of the fit function parameters
**Return type**
`List`\[`float`]
</Attribute>
### series
<Attribute id="qiskit.ignis.characterization.RabiFitter.series">
Return the list of series for the data
**Return type**
`Optional`\[`List`\[`str`]]
</Attribute>
### xdata
<Attribute id="qiskit.ignis.characterization.RabiFitter.xdata">
Return the data points on the x-axis, the independenet parameter which is fit against
**Return type**
`Union`\[`List`\[`float`], `array`]
</Attribute>
### ydata
<Attribute id="qiskit.ignis.characterization.RabiFitter.ydata">
Return the data points on the y-axis
The data points are returning in the form of a list of dictionaries:
> * **ydata\[i]\[mean] is a list, where item**
>
> no. j is the probability of success of qubit i for a circuit that lasts xdata\[j].
>
> * **ydata\[i]\[std] is a list, where ydata\[std]\[j] is the**
>
> standard deviation of the success of qubit i.
**Return type**
`List`\[`Dict`]
</Attribute>
</Class>