qiskit-documentation/docs/api/qiskit/0.44/qiskit.primitives.SamplerRe...

62 lines
2.3 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: SamplerResult
description: API reference for qiskit.primitives.SamplerResult
in_page_toc_min_heading_level: 1
python_api_type: class
python_api_name: qiskit.primitives.SamplerResult
---
# SamplerResult
<Class id="qiskit.primitives.SamplerResult" isDedicatedPage={true} github="https://github.com/qiskit/qiskit/tree/stable/0.25/qiskit/primitives/base/sampler_result.py" signature="qiskit.primitives.SamplerResult(quasi_dists, metadata)" modifiers="class">
Bases: `BasePrimitiveResult`
Result of Sampler.
```python
result = sampler.run(circuits, params).result()
```
where the i-th elements of `result` correspond to the circuit given by `circuits[i]`, and the parameter values bounds by `params[i]`. For example, `results.quasi_dists[i]` gives the quasi-probabilities of bitstrings, and `result.metadata[i]` is a metadata dictionary for this circuit and parameters.
**Parameters**
* **quasi\_dists** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*QuasiDistribution*](qiskit.result.QuasiDistribution "qiskit.result.QuasiDistribution")*]*) List of the quasi-probabilities.
* **metadata** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")*]*) List of the metadata.
## Attributes
### experiments
<Attribute id="qiskit.primitives.SamplerResult.experiments">
Experiment data dicts in any inheriting result dataclass.
</Attribute>
### num\_experiments
<Attribute id="qiskit.primitives.SamplerResult.num_experiments">
Number of experiments in any inheriting result dataclass.
</Attribute>
### quasi\_dists
<Attribute id="qiskit.primitives.SamplerResult.quasi_dists" attributeTypeHint="list[qiskit.result.distributions.quasi.QuasiDistribution]" />
### metadata
<Attribute id="qiskit.primitives.SamplerResult.metadata" attributeTypeHint="list[dict[str, Any]]" />
## Methods
### decompose
<Function id="qiskit.primitives.SamplerResult.decompose" signature="decompose()">
Generate single experiment result objects from self.
**Return type**
[*Iterator*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Iterator "(in Python v3.12)")\[*BasePrimitiveResult*]
</Function>
</Class>