36 lines
1.5 KiB
Plaintext
36 lines
1.5 KiB
Plaintext
---
|
||
title: marginal_counts
|
||
description: API reference for qiskit.result.marginal_counts
|
||
in_page_toc_min_heading_level: 1
|
||
python_api_type: function
|
||
python_api_name: qiskit.result.marginal_counts
|
||
---
|
||
|
||
# qiskit.result.marginal\_counts
|
||
|
||
<Function id="qiskit.result.marginal_counts" isDedicatedPage={true} github="https://github.com/qiskit/qiskit/tree/stable/0.19/qiskit/result/utils.py" signature="marginal_counts(result, indices=None, inplace=False, format_marginal=False)">
|
||
Marginalize counts from an experiment over some indices of interest.
|
||
|
||
**Parameters**
|
||
|
||
* **result** (*dict or* [*Result*](qiskit.result.Result "qiskit.result.Result")) – result to be marginalized (a Result object or a dict(str, int) of counts).
|
||
* **indices** (*list(int) or None*) – The bit positions of interest to marginalize over. If `None` (default), do not marginalize at all.
|
||
* **inplace** (*bool*) – Default: False. Operates on the original Result argument if True, leading to loss of original Job Result. It has no effect if `result` is a dict.
|
||
* **format\_marginal** (*bool*) – Default: False. If True, takes the output of marginalize and formats it with placeholders between cregs and for non-indices.
|
||
|
||
**Returns**
|
||
|
||
**A Result object or a dictionary with**
|
||
|
||
the observed counts, marginalized to only account for frequency of observations of bits of interest.
|
||
|
||
**Return type**
|
||
|
||
[Result](qiskit.result.Result "qiskit.result.Result") or dict(str, int)
|
||
|
||
**Raises**
|
||
|
||
**QiskitError** – in case of invalid indices to marginalize over.
|
||
</Function>
|
||
|