qiskit-documentation/docs/api/qiskit-addon-cutting/utils-observable-terms.mdx

48 lines
1.9 KiB
Plaintext

---
title: observable_terms (latest version)
description: API reference for qiskit_addon_cutting.utils.observable_terms in the latest version of qiskit-addon-cutting
in_page_toc_min_heading_level: 2
python_api_type: module
python_api_name: qiskit_addon_cutting.utils.observable_terms
---
<span id="module-qiskit_addon_cutting.utils.observable_terms" />
<span id="observable-terms-qiskit-addon-cutting-utils-observable-terms" />
# Observable terms
`qiskit_addon_cutting.utils.observable_terms`
Utilities for working with the unique terms of a collection of [`SparsePauliOp`](/api/qiskit/qiskit.quantum_info.SparsePauliOp "(in Qiskit v1.4)")s.
### gather\_unique\_observable\_terms
<Function id="qiskit_addon_cutting.utils.observable_terms.gather_unique_observable_terms" github="https://github.com/Qiskit/qiskit-addon-cutting/tree/stable/0.10/qiskit_addon_cutting/utils/observable_terms.py" signature="gather_unique_observable_terms(observables)">
Inspect the contents of each observable to find and return the unique Pauli terms.
**Return type**
PauliList
**Parameters**
**observables** (*Sequence\[Pauli | SparsePauliOp] | PauliList*)
</Function>
### reconstruct\_observable\_expvals\_from\_terms
<Function id="qiskit_addon_cutting.utils.observable_terms.reconstruct_observable_expvals_from_terms" github="https://github.com/Qiskit/qiskit-addon-cutting/tree/stable/0.10/qiskit_addon_cutting/utils/observable_terms.py" signature="reconstruct_observable_expvals_from_terms(observables, term_expvals)">
Reconstruct the expectation values given the expectation value of each unique term.
**Return type**
list\[complex]
**Parameters**
* **observables** (*Iterable\[Pauli | SparsePauliOp] | PauliList*)
* **term\_expvals** (*Mapping\[Pauli,* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.13)") *|*[*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.13)")*]*)
</Function>