qiskit-documentation/docs/api/qiskit/0.31/qiskit.aqua.components.unce...

152 lines
7.1 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: UncertaintyModel (v0.31)
description: API reference for qiskit.aqua.components.uncertainty_models.UncertaintyModel in qiskit v0.31
in_page_toc_min_heading_level: 1
python_api_type: class
python_api_name: qiskit.aqua.components.uncertainty_models.UncertaintyModel
---
# UncertaintyModel
<Class id="qiskit.aqua.components.uncertainty_models.UncertaintyModel" isDedicatedPage={true} github="https://github.com/qiskit-community/qiskit-aqua/tree/stable/0.9/qiskit/aqua/components/uncertainty_models/uncertainty_model.py" signature="UncertaintyModel(num_target_qubits)" modifiers="class">
Bases: `qiskit.aqua.utils.circuit_factory.CircuitFactory`, `abc.ABC`
The abstract Uncertainty Model
## Methods
<span id="qiskit-aqua-components-uncertainty-models-uncertaintymodel-build" />
### build
<Function id="qiskit.aqua.components.uncertainty_models.UncertaintyModel.build" signature="UncertaintyModel.build(qc, q, q_ancillas=None, params=None)" modifiers="abstract">
Adds corresponding sub-circuit to given circuit
**Parameters**
* **qc** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")) quantum circuit
* **q** (*list*) list of qubits (has to be same length as self.\_num\_qubits)
* **q\_ancillas** (*list*) list of ancilla qubits (or None if none needed)
* **params** (*list*) parameters for circuit
</Function>
<span id="qiskit-aqua-components-uncertainty-models-uncertaintymodel-build-controlled" />
### build\_controlled
<Function id="qiskit.aqua.components.uncertainty_models.UncertaintyModel.build_controlled" signature="UncertaintyModel.build_controlled(qc, q, q_control, q_ancillas=None, use_basis_gates=True)">
Adds corresponding controlled sub-circuit to given circuit
**Parameters**
* **qc** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")) quantum circuit
* **q** (*list*) list of qubits (has to be same length as self.\_num\_qubits)
* **q\_control** ([*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.Qubit")) control qubit
* **q\_ancillas** (*list*) list of ancilla qubits (or None if none needed)
* **use\_basis\_gates** (*bool*) use basis gates for expansion of controlled circuit
</Function>
<span id="qiskit-aqua-components-uncertainty-models-uncertaintymodel-build-controlled-inverse" />
### build\_controlled\_inverse
<Function id="qiskit.aqua.components.uncertainty_models.UncertaintyModel.build_controlled_inverse" signature="UncertaintyModel.build_controlled_inverse(qc, q, q_control, q_ancillas=None, use_basis_gates=True)">
Adds controlled inverse of corresponding sub-circuit to given circuit
**Parameters**
* **qc** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")) quantum circuit
* **q** (*list*) list of qubits (has to be same length as self.\_num\_qubits)
* **q\_control** ([*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.Qubit")) control qubit
* **q\_ancillas** (*list*) list of ancilla qubits (or None if none needed)
* **use\_basis\_gates** (*bool*) use basis gates for expansion of controlled circuit
</Function>
<span id="qiskit-aqua-components-uncertainty-models-uncertaintymodel-build-controlled-inverse-power" />
### build\_controlled\_inverse\_power
<Function id="qiskit.aqua.components.uncertainty_models.UncertaintyModel.build_controlled_inverse_power" signature="UncertaintyModel.build_controlled_inverse_power(qc, q, q_control, power, q_ancillas=None, use_basis_gates=True)">
Adds controlled, inverse, power of corresponding circuit. May be overridden if a more efficient implementation is possible
</Function>
<span id="qiskit-aqua-components-uncertainty-models-uncertaintymodel-build-controlled-power" />
### build\_controlled\_power
<Function id="qiskit.aqua.components.uncertainty_models.UncertaintyModel.build_controlled_power" signature="UncertaintyModel.build_controlled_power(qc, q, q_control, power, q_ancillas=None, use_basis_gates=True)">
Adds controlled power of corresponding circuit. May be overridden if a more efficient implementation is possible
</Function>
<span id="qiskit-aqua-components-uncertainty-models-uncertaintymodel-build-inverse" />
### build\_inverse
<Function id="qiskit.aqua.components.uncertainty_models.UncertaintyModel.build_inverse" signature="UncertaintyModel.build_inverse(qc, q, q_ancillas=None)">
Adds inverse of corresponding sub-circuit to given circuit
**Parameters**
* **qc** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")) quantum circuit
* **q** (*list*) list of qubits (has to be same length as self.\_num\_qubits)
* **q\_ancillas** (*list*) list of ancilla qubits (or None if none needed)
</Function>
<span id="qiskit-aqua-components-uncertainty-models-uncertaintymodel-build-inverse-power" />
### build\_inverse\_power
<Function id="qiskit.aqua.components.uncertainty_models.UncertaintyModel.build_inverse_power" signature="UncertaintyModel.build_inverse_power(qc, q, power, q_ancillas=None)">
Adds inverse power of corresponding circuit. May be overridden if a more efficient implementation is possible
</Function>
<span id="qiskit-aqua-components-uncertainty-models-uncertaintymodel-build-power" />
### build\_power
<Function id="qiskit.aqua.components.uncertainty_models.UncertaintyModel.build_power" signature="UncertaintyModel.build_power(qc, q, power, q_ancillas=None)">
Adds power of corresponding circuit. May be overridden if a more efficient implementation is possible
</Function>
<span id="qiskit-aqua-components-uncertainty-models-uncertaintymodel-get-num-qubits" />
### get\_num\_qubits
<Function id="qiskit.aqua.components.uncertainty_models.UncertaintyModel.get_num_qubits" signature="UncertaintyModel.get_num_qubits()">
returns number of qubits
</Function>
<span id="qiskit-aqua-components-uncertainty-models-uncertaintymodel-get-num-qubits-controlled" />
### get\_num\_qubits\_controlled
<Function id="qiskit.aqua.components.uncertainty_models.UncertaintyModel.get_num_qubits_controlled" signature="UncertaintyModel.get_num_qubits_controlled()">
returns number of qubits controlled
</Function>
<span id="qiskit-aqua-components-uncertainty-models-uncertaintymodel-required-ancillas" />
### required\_ancillas
<Function id="qiskit.aqua.components.uncertainty_models.UncertaintyModel.required_ancillas" signature="UncertaintyModel.required_ancillas()">
returns required ancillas
</Function>
<span id="qiskit-aqua-components-uncertainty-models-uncertaintymodel-required-ancillas-controlled" />
### required\_ancillas\_controlled
<Function id="qiskit.aqua.components.uncertainty_models.UncertaintyModel.required_ancillas_controlled" signature="UncertaintyModel.required_ancillas_controlled()">
returns required ancillas controlled
</Function>
## Attributes
### num\_target\_qubits
<Attribute id="qiskit.aqua.components.uncertainty_models.UncertaintyModel.num_target_qubits">
Returns the number of target qubits
</Attribute>
</Class>