Struct StateVector

pub struct StateVector { /* private fields */ }

Represent the state vector of a quantum system simulation.

Implementations

impl StateVector

pub fn new(qubit_width: usize) -> Self

Create a new state-vector with of length 2 to the qubit_width power and all the amplitude concentrated in the all-zeroes outcome.

pub fn as_complex_bases(&self) -> &[Complex]

Return the amplitudes corresponding to the bases of the system.

pub fn qubit_width(&self) -> usize

Return the 2-base logarithm of the number of amplitudes representing the number of qubits in the system.

pub fn from_complex_bases(bases: Vec<Complex>) -> Self

Create a new state-vector from a vector of complex numbers representing amplitudes. It does not check the length of the vector is a power of two, not the norm of the vector is 1.

pub fn len(&self) -> usize

Get the length of the state-vector.

pub fn is_empty(&self) -> bool

Check if the length of statevector is zero.

pub fn cnot(&mut self, control: usize, target: usize)

Apply a controlled not operation on qubit target.

pub fn u(&mut self, theta: f64, phi: f64, lambda: f64, target: usize)

Apply a general rotation on target qubit, specified as RZ(phi)RY(theta)RZ(lambda).

pub fn measure(&mut self, target: usize) -> bool

Perform a measurement on the Z-axis of the quantum state on target qubit.

pub fn probabilities(&self) -> Vec<f64>

Return the probabilities associated to the amplitudes in the state-vector.

pub fn reset(&mut self)

Reset the state-vector to the state |0⟩.

Trait Implementations

impl<'a> ApproxEq for &'a StateVector

type Margin = F64Margin

This type type defines a margin within which two values are to be considered approximately equal. It must implement Default so that approx_eq() can be called on unknown types.

fn approx_eq<T: Into<Self::Margin>>(self, other: Self, margin: T) -> bool

This method tests that the self and other values are equal within margin of each other.

fn approx_ne<M>(self, other: Self, margin: M) -> bool

where M: Into<Self::Margin>,

This method tests that the self and other values are not within margin of each other.

impl Clone for StateVector

fn clone(&self) -> StateVector

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for StateVector

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl FromIterator<Complex<f64>> for StateVector

fn from_iter<I: IntoIterator<Item = Complex>>(iter: I) -> Self

Creates a value from an iterator.

impl PartialEq for StateVector

fn eq(&self, other: &StateVector) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for StateVector