qiskit-documentation/docs/api/qiskit/0.39/qiskit.algorithms.minimum_e...

153 lines
4.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: SamplingVQEResult
description: API reference for qiskit.algorithms.minimum_eigensolvers.SamplingVQEResult
in_page_toc_min_heading_level: 1
python_api_type: class
python_api_name: qiskit.algorithms.minimum_eigensolvers.SamplingVQEResult
---
# SamplingVQEResult
<Class id="qiskit.algorithms.minimum_eigensolvers.SamplingVQEResult" isDedicatedPage={true} github="https://github.com/qiskit/qiskit/tree/stable/0.22/qiskit/algorithms/minimum_eigensolvers/sampling_vqe.py" signature="SamplingVQEResult" modifiers="class">
Bases: `qiskit.algorithms.variational_algorithm.VariationalResult`, [`qiskit.algorithms.minimum_eigensolvers.sampling_mes.SamplingMinimumEigensolverResult`](qiskit.algorithms.minimum_eigensolvers.SamplingMinimumEigensolverResult "qiskit.algorithms.minimum_eigensolvers.sampling_mes.SamplingMinimumEigensolverResult")
VQE Result.
## Methods
### combine
<Function id="qiskit.algorithms.minimum_eigensolvers.SamplingVQEResult.combine" signature="SamplingVQEResult.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>
## Attributes
### aux\_operators\_evaluated
<Attribute id="qiskit.algorithms.minimum_eigensolvers.SamplingVQEResult.aux_operators_evaluated">
Return aux operator expectation values and metadata.
These are formatted as (mean, metadata).
</Attribute>
### best\_measurement
<Attribute id="qiskit.algorithms.minimum_eigensolvers.SamplingVQEResult.best_measurement">
Return the best measurement over the entire optimization.
Possesses keys: `state`, `bitstring`, `value`, `probability`.
</Attribute>
### cost\_function\_evals
<Attribute id="qiskit.algorithms.minimum_eigensolvers.SamplingVQEResult.cost_function_evals">
Returns number of cost optimizer evaluations
**Return type**
int | None
</Attribute>
### eigenstate
<Attribute id="qiskit.algorithms.minimum_eigensolvers.SamplingVQEResult.eigenstate">
Return the quasi-distribution sampled from the final state.
The ansatz is sampled when parameterized with the optimal parameters that where obtained computing the minimum eigenvalue. The keys represent a measured classical value and the value is a float for the quasi-probability of that result.
**Return type**
[QuasiDistribution](qiskit.result.QuasiDistribution "qiskit.result.QuasiDistribution") | None
</Attribute>
### eigenvalue
<Attribute id="qiskit.algorithms.minimum_eigensolvers.SamplingVQEResult.eigenvalue">
Return the approximation to the eigenvalue.
**Return type**
complex | None
</Attribute>
### optimal\_circuit
<Attribute id="qiskit.algorithms.minimum_eigensolvers.SamplingVQEResult.optimal_circuit">
The optimal circuits. Along with the optimal parameters, these can be used to retrieve the minimum eigenstate.
**Return type**
[`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")
</Attribute>
### optimal\_parameters
<Attribute id="qiskit.algorithms.minimum_eigensolvers.SamplingVQEResult.optimal_parameters">
Returns the optimal parameters in a dictionary
**Return type**
`Optional`\[`Dict`]
</Attribute>
### optimal\_point
<Attribute id="qiskit.algorithms.minimum_eigensolvers.SamplingVQEResult.optimal_point">
Returns optimal point
**Return type**
`Optional`\[`ndarray`]
</Attribute>
### optimal\_value
<Attribute id="qiskit.algorithms.minimum_eigensolvers.SamplingVQEResult.optimal_value">
Returns optimal value
**Return type**
`Optional`\[`float`]
</Attribute>
### optimizer\_evals
<Attribute id="qiskit.algorithms.minimum_eigensolvers.SamplingVQEResult.optimizer_evals">
Returns number of optimizer evaluations
**Return type**
`Optional`\[`int`]
</Attribute>
### optimizer\_result
<Attribute id="qiskit.algorithms.minimum_eigensolvers.SamplingVQEResult.optimizer_result">
Returns the optimizer result
**Return type**
`Optional`\[[`OptimizerResult`](qiskit.algorithms.optimizers.OptimizerResult "qiskit.algorithms.optimizers.optimizer.OptimizerResult")]
</Attribute>
### optimizer\_time
<Attribute id="qiskit.algorithms.minimum_eigensolvers.SamplingVQEResult.optimizer_time">
Returns time taken for optimization
**Return type**
`Optional`\[`float`]
</Attribute>
</Class>