qiskit-documentation/docs/api/qiskit/0.44/qiskit.algorithms.Iterative...

127 lines
4.2 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: IterativeAmplitudeEstimationResult
description: API reference for qiskit.algorithms.IterativeAmplitudeEstimationResult
in_page_toc_min_heading_level: 1
python_api_type: class
python_api_name: qiskit.algorithms.IterativeAmplitudeEstimationResult
---
# IterativeAmplitudeEstimationResult
<Class id="qiskit.algorithms.IterativeAmplitudeEstimationResult" isDedicatedPage={true} github="https://github.com/qiskit/qiskit/tree/stable/0.25/qiskit/algorithms/amplitude_estimators/iae.py" signature="qiskit.algorithms.IterativeAmplitudeEstimationResult" modifiers="class">
Bases: [`AmplitudeEstimatorResult`](qiskit.algorithms.AmplitudeEstimatorResult "qiskit.algorithms.amplitude_estimators.amplitude_estimator.AmplitudeEstimatorResult")
The `IterativeAmplitudeEstimation` result object.
## Attributes
### alpha
<Attribute id="qiskit.algorithms.IterativeAmplitudeEstimationResult.alpha">
Return the confidence level $\alpha$.
</Attribute>
### circuit\_results
<Attribute id="qiskit.algorithms.IterativeAmplitudeEstimationResult.circuit_results">
Return the circuit results. Can be a statevector or counts dictionary.
</Attribute>
### confidence\_interval
<Attribute id="qiskit.algorithms.IterativeAmplitudeEstimationResult.confidence_interval">
Return the confidence interval for the amplitude (95% interval by default).
</Attribute>
### confidence\_interval\_processed
<Attribute id="qiskit.algorithms.IterativeAmplitudeEstimationResult.confidence_interval_processed">
Return the post-processed confidence interval.
</Attribute>
### epsilon\_estimated
<Attribute id="qiskit.algorithms.IterativeAmplitudeEstimationResult.epsilon_estimated">
Return the estimated half-width of the confidence interval.
</Attribute>
### epsilon\_estimated\_processed
<Attribute id="qiskit.algorithms.IterativeAmplitudeEstimationResult.epsilon_estimated_processed">
Return the post-processed estimated half-width of the confidence interval.
</Attribute>
### epsilon\_target
<Attribute id="qiskit.algorithms.IterativeAmplitudeEstimationResult.epsilon_target">
Return the target half-width of the confidence interval.
</Attribute>
### estimate\_intervals
<Attribute id="qiskit.algorithms.IterativeAmplitudeEstimationResult.estimate_intervals">
Return the confidence intervals for the estimate in each iteration.
</Attribute>
### estimation
<Attribute id="qiskit.algorithms.IterativeAmplitudeEstimationResult.estimation">
Return the estimation for the amplitude in $[0, 1]$.
</Attribute>
### estimation\_processed
<Attribute id="qiskit.algorithms.IterativeAmplitudeEstimationResult.estimation_processed">
Return the estimation for the amplitude after the post-processing has been applied.
</Attribute>
### num\_oracle\_queries
<Attribute id="qiskit.algorithms.IterativeAmplitudeEstimationResult.num_oracle_queries">
Return the number of Grover oracle queries.
</Attribute>
### post\_processing
<Attribute id="qiskit.algorithms.IterativeAmplitudeEstimationResult.post_processing">
Return a handle to the post processing function.
</Attribute>
### powers
<Attribute id="qiskit.algorithms.IterativeAmplitudeEstimationResult.powers">
Return the powers of the Grover operator in each iteration.
</Attribute>
### ratios
<Attribute id="qiskit.algorithms.IterativeAmplitudeEstimationResult.ratios">
Return the ratios $K_{i+1}/K_{i}$ for each iteration $i$.
</Attribute>
### shots
<Attribute id="qiskit.algorithms.IterativeAmplitudeEstimationResult.shots">
Return the number of shots used. Is 1 for statevector-based simulations.
</Attribute>
### theta\_intervals
<Attribute id="qiskit.algorithms.IterativeAmplitudeEstimationResult.theta_intervals">
Return the confidence intervals for the angles in each iteration.
</Attribute>
## Methods
### combine
<Function id="qiskit.algorithms.IterativeAmplitudeEstimationResult.combine" signature="combine(result)">
Any property from the argument that exists in the receiver is updated. :param result: Argument result with properties to be set.
**Raises**
[**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") Argument is None
</Function>
</Class>