MultivariateDistribution
class MultivariateDistribution(num_qubits, probabilities=None, low=None, high=None)
This module contains the definition of a base class for multivariate distributions. (Interface for discrete bounded uncertainty models assuming an equidistant grid)
Parameters
- num_qubits (
Union[List[int],ndarray]) – Assigns qubits to dimensions - probabilities (
Optional[Dict]) – Map - maps index tuples to probabilities - low (
Union[List[float],ndarray,None]) – Lowest value per dimension - high (
Union[List[float],ndarray,None]) – Highest value per dimension
Attributes
dimension
returns dimensions
high
returns high
low
returns low
num_qubits
returns num qubits
num_target_qubits
Returns the number of target qubits
num_values
returns number of values
probabilities
returns probabilities
probabilities_vector
returns probabilities vector
values
returns values
Methods
build
MultivariateDistribution.build(qc, q, q_ancillas=None, params=None)
build_controlled
MultivariateDistribution.build_controlled(qc, q, q_control, q_ancillas=None, use_basis_gates=True)
Adds corresponding controlled sub-circuit to given circuit
Parameters
- qc (QuantumCircuit) – quantum circuit
- q (list) – list of qubits (has to be same length as self._num_qubits)
- q_control (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
build_controlled_inverse
MultivariateDistribution.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) – quantum circuit
- q (list) – list of qubits (has to be same length as self._num_qubits)
- q_control (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
build_controlled_inverse_power
MultivariateDistribution.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
build_controlled_power
MultivariateDistribution.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
build_inverse
MultivariateDistribution.build_inverse(qc, q, q_ancillas=None)
Adds inverse of corresponding sub-circuit to given circuit
Parameters
- qc (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)
build_inverse_power
MultivariateDistribution.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
build_power
MultivariateDistribution.build_power(qc, q, power, q_ancillas=None)
Adds power of corresponding circuit. May be overridden if a more efficient implementation is possible
get_num_qubits
MultivariateDistribution.get_num_qubits()
returns number of qubits
get_num_qubits_controlled
MultivariateDistribution.get_num_qubits_controlled()
returns number of qubits controlled
pdf_to_probabilities
static MultivariateDistribution.pdf_to_probabilities(pdf, low, high, num_values)
pdf to probabilities
required_ancillas
MultivariateDistribution.required_ancillas()
returns required ancillas
required_ancillas_controlled
MultivariateDistribution.required_ancillas_controlled()
returns required ancillas controlled