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

207 lines
9.6 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: MultivariateUniformDistribution (v0.29)
description: API reference for qiskit.aqua.components.uncertainty_models.MultivariateUniformDistribution in qiskit v0.29
in_page_toc_min_heading_level: 1
python_api_type: class
python_api_name: qiskit.aqua.components.uncertainty_models.MultivariateUniformDistribution
---
# MultivariateUniformDistribution
<Class id="qiskit.aqua.components.uncertainty_models.MultivariateUniformDistribution" isDedicatedPage={true} github="https://github.com/qiskit-community/qiskit-aqua/tree/stable/0.9/qiskit/aqua/components/uncertainty_models/multivariate_uniform_distribution.py" signature="MultivariateUniformDistribution(num_qubits, low=None, high=None)" modifiers="class">
Bases: `qiskit.aqua.components.uncertainty_models.multivariate_distribution.MultivariateDistribution`
The Multivariate Uniform Distribution.
Although this just results in a Hadamard gate on all involved qubits, the lower and upper bounds and the assignment of the qubits to the different dimensions is important if used in a particular application.
**Parameters**
* **num\_qubits** (`Union`\[`List`\[`int`], `ndarray`]) List with the number of qubits per dimension
* **low** (`Union`\[`List`\[`float`], `ndarray`, `None`]) List with the lower bounds per dimension, set to 0 for each dimension if None
* **high** (`Union`\[`List`\[`float`], `ndarray`, `None`]) List with the upper bounds per dimension, set to 1 for each dimension if None
## Methods
<span id="qiskit-aqua-components-uncertainty-models-multivariateuniformdistribution-build" />
### build
<Function id="qiskit.aqua.components.uncertainty_models.MultivariateUniformDistribution.build" signature="MultivariateUniformDistribution.build(qc, q, q_ancillas=None, params=None)" />
<span id="qiskit-aqua-components-uncertainty-models-multivariateuniformdistribution-build-controlled" />
### build\_controlled
<Function id="qiskit.aqua.components.uncertainty_models.MultivariateUniformDistribution.build_controlled" signature="MultivariateUniformDistribution.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-multivariateuniformdistribution-build-controlled-inverse" />
### build\_controlled\_inverse
<Function id="qiskit.aqua.components.uncertainty_models.MultivariateUniformDistribution.build_controlled_inverse" signature="MultivariateUniformDistribution.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-multivariateuniformdistribution-build-controlled-inverse-power" />
### build\_controlled\_inverse\_power
<Function id="qiskit.aqua.components.uncertainty_models.MultivariateUniformDistribution.build_controlled_inverse_power" signature="MultivariateUniformDistribution.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-multivariateuniformdistribution-build-controlled-power" />
### build\_controlled\_power
<Function id="qiskit.aqua.components.uncertainty_models.MultivariateUniformDistribution.build_controlled_power" signature="MultivariateUniformDistribution.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-multivariateuniformdistribution-build-inverse" />
### build\_inverse
<Function id="qiskit.aqua.components.uncertainty_models.MultivariateUniformDistribution.build_inverse" signature="MultivariateUniformDistribution.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-multivariateuniformdistribution-build-inverse-power" />
### build\_inverse\_power
<Function id="qiskit.aqua.components.uncertainty_models.MultivariateUniformDistribution.build_inverse_power" signature="MultivariateUniformDistribution.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-multivariateuniformdistribution-build-power" />
### build\_power
<Function id="qiskit.aqua.components.uncertainty_models.MultivariateUniformDistribution.build_power" signature="MultivariateUniformDistribution.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-multivariateuniformdistribution-get-num-qubits" />
### get\_num\_qubits
<Function id="qiskit.aqua.components.uncertainty_models.MultivariateUniformDistribution.get_num_qubits" signature="MultivariateUniformDistribution.get_num_qubits()">
returns number of qubits
</Function>
<span id="qiskit-aqua-components-uncertainty-models-multivariateuniformdistribution-get-num-qubits-controlled" />
### get\_num\_qubits\_controlled
<Function id="qiskit.aqua.components.uncertainty_models.MultivariateUniformDistribution.get_num_qubits_controlled" signature="MultivariateUniformDistribution.get_num_qubits_controlled()">
returns number of qubits controlled
</Function>
<span id="qiskit-aqua-components-uncertainty-models-multivariateuniformdistribution-pdf-to-probabilities" />
### pdf\_to\_probabilities
<Function id="qiskit.aqua.components.uncertainty_models.MultivariateUniformDistribution.pdf_to_probabilities" signature="MultivariateUniformDistribution.pdf_to_probabilities(pdf, low, high, num_values)" modifiers="static">
pdf to probabilities
</Function>
<span id="qiskit-aqua-components-uncertainty-models-multivariateuniformdistribution-required-ancillas" />
### required\_ancillas
<Function id="qiskit.aqua.components.uncertainty_models.MultivariateUniformDistribution.required_ancillas" signature="MultivariateUniformDistribution.required_ancillas()">
returns required ancillas
</Function>
<span id="qiskit-aqua-components-uncertainty-models-multivariateuniformdistribution-required-ancillas-controlled" />
### required\_ancillas\_controlled
<Function id="qiskit.aqua.components.uncertainty_models.MultivariateUniformDistribution.required_ancillas_controlled" signature="MultivariateUniformDistribution.required_ancillas_controlled()">
returns required ancillas controlled
</Function>
## Attributes
### dimension
<Attribute id="qiskit.aqua.components.uncertainty_models.MultivariateUniformDistribution.dimension">
returns dimensions
</Attribute>
### high
<Attribute id="qiskit.aqua.components.uncertainty_models.MultivariateUniformDistribution.high">
returns high
</Attribute>
### low
<Attribute id="qiskit.aqua.components.uncertainty_models.MultivariateUniformDistribution.low">
returns low
</Attribute>
### num\_qubits
<Attribute id="qiskit.aqua.components.uncertainty_models.MultivariateUniformDistribution.num_qubits">
returns num qubits
</Attribute>
### num\_target\_qubits
<Attribute id="qiskit.aqua.components.uncertainty_models.MultivariateUniformDistribution.num_target_qubits">
Returns the number of target qubits
</Attribute>
### num\_values
<Attribute id="qiskit.aqua.components.uncertainty_models.MultivariateUniformDistribution.num_values">
returns number of values
</Attribute>
### probabilities
<Attribute id="qiskit.aqua.components.uncertainty_models.MultivariateUniformDistribution.probabilities">
returns probabilities
</Attribute>
### probabilities\_vector
<Attribute id="qiskit.aqua.components.uncertainty_models.MultivariateUniformDistribution.probabilities_vector">
returns probabilities vector
</Attribute>
### values
<Attribute id="qiskit.aqua.components.uncertainty_models.MultivariateUniformDistribution.values">
returns values
</Attribute>
</Class>