118 lines
4.4 KiB
Plaintext
118 lines
4.4 KiB
Plaintext
---
|
||
title: PhaseEstimationResult (v0.29)
|
||
description: API reference for qiskit.algorithms.PhaseEstimationResult in qiskit v0.29
|
||
in_page_toc_min_heading_level: 1
|
||
python_api_type: class
|
||
python_api_name: qiskit.algorithms.PhaseEstimationResult
|
||
---
|
||
|
||
# PhaseEstimationResult
|
||
|
||
<Class id="qiskit.algorithms.PhaseEstimationResult" isDedicatedPage={true} github="https://github.com/qiskit/qiskit/tree/stable/0.18/qiskit/algorithms/phase_estimators/phase_estimation_result.py" signature="PhaseEstimationResult(num_evaluation_qubits, circuit_result, phases)" modifiers="class">
|
||
Bases: `qiskit.algorithms.phase_estimators.phase_estimator.PhaseEstimatorResult`
|
||
|
||
Store and manipulate results from running PhaseEstimation.
|
||
|
||
This class is instantiated by the `PhaseEstimation` class, not via user code. The `PhaseEstimation` class generates a list of phases and corresponding weights. Upon completion it returns the results as an instance of this class. The main method for accessing the results is filter\_phases.
|
||
|
||
The canonical phase satisfying the `PhaseEstimator` interface, returned by the attribute phase, is the most likely phase.
|
||
|
||
**Parameters**
|
||
|
||
* **num\_evaluation\_qubits** (`int`) – number of qubits in phase-readout register.
|
||
* **circuit\_result** (`Result`) – result object returned by method running circuit.
|
||
* **phases** (`Union`\[`ndarray`, `Dict`\[`str`, `float`]]) – ndarray or dict of phases and frequencies determined by QPE.
|
||
|
||
## Methods
|
||
|
||
<span id="qiskit-algorithms-phaseestimationresult-combine" />
|
||
|
||
### combine
|
||
|
||
<Function id="qiskit.algorithms.PhaseEstimationResult.combine" signature="PhaseEstimationResult.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>
|
||
|
||
<span id="qiskit-algorithms-phaseestimationresult-filter-phases" />
|
||
|
||
### filter\_phases
|
||
|
||
<Function id="qiskit.algorithms.PhaseEstimationResult.filter_phases" signature="PhaseEstimationResult.filter_phases(cutoff=0.0, as_float=True)">
|
||
Return a filtered dict of phases (keys) and frequencies (values).
|
||
|
||
Only phases with frequencies (counts) larger than cutoff are included. It is assumed that the run method has been called so that the phases have been computed. When using a noiseless, shot-based simulator to read a single phase that can be represented exactly by num\_evaluation\_qubits, all the weight will be concentrated on a single phase. In all other cases, many, or all, bit strings will have non-zero weight. This method is useful for filtering out these uninteresting bit strings.
|
||
|
||
**Parameters**
|
||
|
||
* **cutoff** (`float`) – Minimum weight of number of counts required to keep a bit string. The default value is 0.0.
|
||
* **as\_float** (`bool`) – If True, returned keys are floats in $[0.0, 1.0)$. If False returned keys are bit strings.
|
||
|
||
**Return type**
|
||
|
||
`Dict`
|
||
|
||
**Returns**
|
||
|
||
A filtered dict of phases (keys) and frequencies (values).
|
||
</Function>
|
||
|
||
## Attributes
|
||
|
||
### circuit\_result
|
||
|
||
<Attribute id="qiskit.algorithms.PhaseEstimationResult.circuit_result">
|
||
Return the result object returned by running the QPE circuit (on hardware or simulator).
|
||
|
||
This is useful for inspecting and troubleshooting the QPE algorithm.
|
||
|
||
**Return type**
|
||
|
||
`Result`
|
||
</Attribute>
|
||
|
||
### most\_likely\_phase
|
||
|
||
<Attribute id="qiskit.algorithms.PhaseEstimationResult.most_likely_phase">
|
||
DEPRECATED - Return the most likely phase as a number in $[0.0, 1.0)$.
|
||
|
||
1.0 corresponds to a phase of $2\pi$. This selects the phase corresponding to the bit string with the highesest probability. This is the most likely phase.
|
||
|
||
**Return type**
|
||
|
||
`float`
|
||
</Attribute>
|
||
|
||
### phase
|
||
|
||
<Attribute id="qiskit.algorithms.PhaseEstimationResult.phase">
|
||
Return the most likely phase as a number in $[0.0, 1.0)$.
|
||
|
||
1.0 corresponds to a phase of $2\pi$. This selects the phase corresponding to the bit string with the highesest probability. This is the most likely phase.
|
||
|
||
**Return type**
|
||
|
||
`float`
|
||
</Attribute>
|
||
|
||
### phases
|
||
|
||
<Attribute id="qiskit.algorithms.PhaseEstimationResult.phases">
|
||
Return all phases and their frequencies computed by QPE.
|
||
|
||
This is an array or dict whose values correspond to weights on bit strings.
|
||
|
||
**Return type**
|
||
|
||
`Union`\[`ndarray`, `dict`]
|
||
</Attribute>
|
||
</Class>
|
||
|