qiskit-documentation/docs/api/qiskit/0.24/qiskit.aqua.algorithms.Ampl...

283 lines
15 KiB
Plaintext
Raw Permalink Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

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: AmplitudeEstimationResult
description: API reference for qiskit.aqua.algorithms.AmplitudeEstimationResult
in_page_toc_min_heading_level: 1
python_api_type: class
python_api_name: qiskit.aqua.algorithms.AmplitudeEstimationResult
---
<span id="qiskit-aqua-algorithms-amplitudeestimationresult" />
# qiskit.aqua.algorithms.AmplitudeEstimationResult
<Class id="qiskit.aqua.algorithms.AmplitudeEstimationResult" isDedicatedPage={true} github="https://github.com/qiskit-community/qiskit-aqua/tree/stable/0.8/qiskit/aqua/algorithms/amplitude_estimators/ae.py" signature="AmplitudeEstimationResult(a_dict=None)" modifiers="class">
AmplitudeEstimation Result.
### \_\_init\_\_
<Function id="qiskit.aqua.algorithms.AmplitudeEstimationResult.__init__" signature="__init__(a_dict=None)">
Initialize self. See help(type(self)) for accurate signature.
</Function>
## Methods
| | |
| -------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [`__init__`](#qiskit.aqua.algorithms.AmplitudeEstimationResult.__init__ "qiskit.aqua.algorithms.AmplitudeEstimationResult.__init__")(\[a\_dict]) | Initialize self. |
| [`clear`](#qiskit.aqua.algorithms.AmplitudeEstimationResult.clear "qiskit.aqua.algorithms.AmplitudeEstimationResult.clear")() | **rtype**`None` |
| [`combine`](#qiskit.aqua.algorithms.AmplitudeEstimationResult.combine "qiskit.aqua.algorithms.AmplitudeEstimationResult.combine")(result) | Any property from the argument that exists in the receiver is updated. |
| `copy`() | |
| [`from_dict`](#qiskit.aqua.algorithms.AmplitudeEstimationResult.from_dict "qiskit.aqua.algorithms.AmplitudeEstimationResult.from_dict")(a\_dict) | create new object from a dictionary |
| `fromkeys`(iterable\[, value]) | |
| [`get`](#qiskit.aqua.algorithms.AmplitudeEstimationResult.get "qiskit.aqua.algorithms.AmplitudeEstimationResult.get")(k\[,d]) | |
| [`items`](#qiskit.aqua.algorithms.AmplitudeEstimationResult.items "qiskit.aqua.algorithms.AmplitudeEstimationResult.items")() | |
| [`keys`](#qiskit.aqua.algorithms.AmplitudeEstimationResult.keys "qiskit.aqua.algorithms.AmplitudeEstimationResult.keys")() | |
| [`pop`](#qiskit.aqua.algorithms.AmplitudeEstimationResult.pop "qiskit.aqua.algorithms.AmplitudeEstimationResult.pop")(key\[, default]) | If key is not found, d is returned if given, otherwise KeyError is raised. |
| [`popitem`](#qiskit.aqua.algorithms.AmplitudeEstimationResult.popitem "qiskit.aqua.algorithms.AmplitudeEstimationResult.popitem")() | as a 2-tuple; but raise KeyError if D is empty. |
| [`setdefault`](#qiskit.aqua.algorithms.AmplitudeEstimationResult.setdefault "qiskit.aqua.algorithms.AmplitudeEstimationResult.setdefault")(k\[,d]) | |
| [`update`](#qiskit.aqua.algorithms.AmplitudeEstimationResult.update "qiskit.aqua.algorithms.AmplitudeEstimationResult.update")(\*args, \*\*kwargs) | If E present and has a .keys() method, does: for k in E: D\[k] = E\[k] If E present and lacks .keys() method, does: for (k, v) in E: D\[k] = v In either case, this is followed by: for k, v in F.items(): D\[k] = v |
| [`values`](#qiskit.aqua.algorithms.AmplitudeEstimationResult.values "qiskit.aqua.algorithms.AmplitudeEstimationResult.values")() | |
## Attributes
| | |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------- |
| [`a_estimation`](#qiskit.aqua.algorithms.AmplitudeEstimationResult.a_estimation "qiskit.aqua.algorithms.AmplitudeEstimationResult.a_estimation") | return a\_estimation |
| [`a_samples`](#qiskit.aqua.algorithms.AmplitudeEstimationResult.a_samples "qiskit.aqua.algorithms.AmplitudeEstimationResult.a_samples") | return a\_samples |
| [`circuit_result`](#qiskit.aqua.algorithms.AmplitudeEstimationResult.circuit_result "qiskit.aqua.algorithms.AmplitudeEstimationResult.circuit_result") | return circuit result |
| [`confidence_interval`](#qiskit.aqua.algorithms.AmplitudeEstimationResult.confidence_interval "qiskit.aqua.algorithms.AmplitudeEstimationResult.confidence_interval") | return confidence\_interval |
| [`estimation`](#qiskit.aqua.algorithms.AmplitudeEstimationResult.estimation "qiskit.aqua.algorithms.AmplitudeEstimationResult.estimation") | return estimation |
| [`mapped_a_samples`](#qiskit.aqua.algorithms.AmplitudeEstimationResult.mapped_a_samples "qiskit.aqua.algorithms.AmplitudeEstimationResult.mapped_a_samples") | return mapped\_a\_samples |
| [`mapped_values`](#qiskit.aqua.algorithms.AmplitudeEstimationResult.mapped_values "qiskit.aqua.algorithms.AmplitudeEstimationResult.mapped_values") | return mapped\_values |
| [`max_probability`](#qiskit.aqua.algorithms.AmplitudeEstimationResult.max_probability "qiskit.aqua.algorithms.AmplitudeEstimationResult.max_probability") | return max\_probability |
| [`ml_value`](#qiskit.aqua.algorithms.AmplitudeEstimationResult.ml_value "qiskit.aqua.algorithms.AmplitudeEstimationResult.ml_value") | returns ml\_value |
| [`mle`](#qiskit.aqua.algorithms.AmplitudeEstimationResult.mle "qiskit.aqua.algorithms.AmplitudeEstimationResult.mle") | return mle |
| [`num_oracle_queries`](#qiskit.aqua.algorithms.AmplitudeEstimationResult.num_oracle_queries "qiskit.aqua.algorithms.AmplitudeEstimationResult.num_oracle_queries") | return num\_oracle\_queries |
| [`probabilities`](#qiskit.aqua.algorithms.AmplitudeEstimationResult.probabilities "qiskit.aqua.algorithms.AmplitudeEstimationResult.probabilities") | return probabilities |
| [`shots`](#qiskit.aqua.algorithms.AmplitudeEstimationResult.shots "qiskit.aqua.algorithms.AmplitudeEstimationResult.shots") | return shots |
| [`y_measurements`](#qiskit.aqua.algorithms.AmplitudeEstimationResult.y_measurements "qiskit.aqua.algorithms.AmplitudeEstimationResult.y_measurements") | return y\_measurements |
### a\_estimation
<Attribute id="qiskit.aqua.algorithms.AmplitudeEstimationResult.a_estimation">
return a\_estimation
**Return type**
`float`
</Attribute>
### a\_samples
<Attribute id="qiskit.aqua.algorithms.AmplitudeEstimationResult.a_samples">
return a\_samples
**Return type**
`List`\[`Tuple`\[`float`, `float`]]
</Attribute>
### circuit\_result
<Attribute id="qiskit.aqua.algorithms.AmplitudeEstimationResult.circuit_result">
return circuit result
**Return type**
`Union`\[`ndarray`, `Dict`\[`str`, `int`], `None`]
</Attribute>
### clear
<Function id="qiskit.aqua.algorithms.AmplitudeEstimationResult.clear" signature="clear()">
**Return type**
`None`
</Function>
### combine
<Function id="qiskit.aqua.algorithms.AmplitudeEstimationResult.combine" signature="combine(result)">
Any property from the argument that exists in the receiver is updated. :type result: `AlgorithmResult` :param result: Argument result with properties to be set.
**Raises**
**TypeError** Argument is None
**Return type**
`None`
</Function>
### confidence\_interval
<Attribute id="qiskit.aqua.algorithms.AmplitudeEstimationResult.confidence_interval">
return confidence\_interval
**Return type**
`List`\[`float`]
</Attribute>
### estimation
<Attribute id="qiskit.aqua.algorithms.AmplitudeEstimationResult.estimation">
return estimation
**Return type**
`float`
</Attribute>
### from\_dict
<Function id="qiskit.aqua.algorithms.AmplitudeEstimationResult.from_dict" signature="from_dict(a_dict)" modifiers="static">
create new object from a dictionary
**Return type**
`AmplitudeEstimationResult`
</Function>
### get
<Function id="qiskit.aqua.algorithms.AmplitudeEstimationResult.get" signature="get(k[, d]) → D[k] if k in D, else d. d defaults to None." />
### items
<Function id="qiskit.aqua.algorithms.AmplitudeEstimationResult.items" signature="items() → a set-like object providing a view on Ds items" />
### keys
<Function id="qiskit.aqua.algorithms.AmplitudeEstimationResult.keys" signature="keys() → a set-like object providing a view on Ds keys" />
### mapped\_a\_samples
<Attribute id="qiskit.aqua.algorithms.AmplitudeEstimationResult.mapped_a_samples">
return mapped\_a\_samples
**Return type**
`List`\[`float`]
</Attribute>
### mapped\_values
<Attribute id="qiskit.aqua.algorithms.AmplitudeEstimationResult.mapped_values">
return mapped\_values
**Return type**
`List`\[`float`]
</Attribute>
### max\_probability
<Attribute id="qiskit.aqua.algorithms.AmplitudeEstimationResult.max_probability">
return max\_probability
**Return type**
`float`
</Attribute>
### ml\_value
<Attribute id="qiskit.aqua.algorithms.AmplitudeEstimationResult.ml_value">
returns ml\_value
**Return type**
`float`
</Attribute>
### mle
<Attribute id="qiskit.aqua.algorithms.AmplitudeEstimationResult.mle">
return mle
**Return type**
`float`
</Attribute>
### num\_oracle\_queries
<Attribute id="qiskit.aqua.algorithms.AmplitudeEstimationResult.num_oracle_queries">
return num\_oracle\_queries
**Return type**
`int`
</Attribute>
### pop
<Function id="qiskit.aqua.algorithms.AmplitudeEstimationResult.pop" signature="pop(key, default=None)">
If key is not found, d is returned if given, otherwise KeyError is raised.
**Return type**
`object`
</Function>
### popitem
<Function id="qiskit.aqua.algorithms.AmplitudeEstimationResult.popitem" signature="popitem()">
as a 2-tuple; but raise KeyError if D is empty.
**Return type**
`Tuple`\[`object`, `object`]
</Function>
### probabilities
<Attribute id="qiskit.aqua.algorithms.AmplitudeEstimationResult.probabilities">
return probabilities
**Return type**
`List`\[`float`]
</Attribute>
### setdefault
<Function id="qiskit.aqua.algorithms.AmplitudeEstimationResult.setdefault" signature="setdefault(k[, d]) → D.get(k,d), also set D[k]=d if k not in D" />
### shots
<Attribute id="qiskit.aqua.algorithms.AmplitudeEstimationResult.shots">
return shots
**Return type**
`int`
</Attribute>
### update
<Function id="qiskit.aqua.algorithms.AmplitudeEstimationResult.update" signature="update(*args, **kwargs)">
If E present and has a .keys() method, does: for k in E: D\[k] = E\[k] If E present and lacks .keys() method, does: for (k, v) in E: D\[k] = v In either case, this is followed by: for k, v in F.items(): D\[k] = v
**Return type**
`None`
</Function>
### values
<Function id="qiskit.aqua.algorithms.AmplitudeEstimationResult.values" signature="values() → an object providing a view on Ds values" />
### y\_measurements
<Attribute id="qiskit.aqua.algorithms.AmplitudeEstimationResult.y_measurements">
return y\_measurements
**Return type**
`List`\[`Tuple`\[`int`, `float`]]
</Attribute>
</Class>