Struct qip::qubit_chainer::SingleQubitChain

pub struct SingleQubitChain<'a, B: UnitaryBuilder> { /* fields omitted */ }

Chaining struct for a single qubit (which may have multiple indices)

Methods

impl<'a, B: UnitaryBuilder> SingleQubitChain<'a, B>

pub fn new(builder: &'a mut B, q: Qubit) -> Self

Make a new SingleQubitChain. Prefer to use chain.

pub fn release(self) -> Qubit

Release the contained qubit.

pub fn q(self) -> Qubit

Release the contained qubit.

pub fn split(
    self,
    indices: Vec<u64>
) -> Result<DoubleQubitChain<'a, B>, &'static str>

Split the qubit, select the given indices and transfer them to a new qubit, leave the remaining indices in another qubit. This uses the relative indices (0 refers to whatever the first index of the contained qubit is).

pub fn split_absolute(
    self,
    selected_indices: Vec<u64>
) -> Result<DoubleQubitChain<'a, B>, &'static str>

Split the qubit, select the given indices and transfer them to a new qubit, leave the remaining indices in another qubit. This uses the absolute indices (0 refers to the 0th absolute index, even if it isn't in the contained qubit, throwing an error).

pub fn split_all(self) -> Result<VecQubitChain<'a, B>, &'static str>

Split each contained index into its own qubit object, returns a chaining struct for the vec of resulting qubits.

pub fn apply_mat(
    self,
    name: &str,
    mat: Vec<Complex<f64>>
) -> Result<Self, &'static str>

Apply a matrix operation to the contained qubit.

pub fn apply_sparse_mat(
    self,
    name: &str,
    mat: Vec<Vec<(u64, Complex<f64>)>>,
    natural_order: bool
) -> Result<Self, &'static str>

Apply a sparse matrix operation to the contained qubit.

pub fn not(self) -> Self

Apply the NOT operation to the contained qubit.

pub fn x(self) -> Self

Apply the X operation to the contained qubit.

pub fn y(self) -> Self

Apply the Y operation to the contained qubit.

pub fn z(self) -> Self

Apply the Z operation to the contained qubit.

pub fn hadamard(self) -> Self

Apply a H to the contained qubit.

pub fn apply(self, f: impl FnOnce(&mut B, Qubit) -> Qubit) -> Self

Map the qubit by the given function.

pub fn apply_cut(
    self,
    f: impl FnOnce(&mut B, Qubit) -> (Qubit, Qubit)
) -> DoubleQubitChain<'a, B>

Map the qubit by the given function, resulting in two qubits.

pub fn apply_split(
    self,
    f: impl FnOnce(&mut B, Qubit) -> Vec<Qubit>
) -> VecQubitChain<'a, B>

Map the qubit by the given function, resulting in a vec of qubits.

Trait Implementations

impl<'a, B: Debug + UnitaryBuilder> Debug for SingleQubitChain<'a, B>

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

Formats the value using the given formatter.