Struct SparseStateVector 

pub struct SparseStateVector {
    pub n_qubits: usize,
    /* private fields */
}

A sparse pure state: only nonzero basis amplitudes are stored.

Fields

n_qubits: usize

Number of qubits.

Implementations

impl SparseStateVector

pub fn new_zero_state(n_qubits: usize) -> QuantumResult<Self>

Construct the sparse |0…0⟩ state (a single populated key).

Errors

Returns QuantumError::InvalidQubitCount for n_qubits == 0 or n_qubits > 30.

pub fn from_dense(sv: &StateVector) -> Self

Build a sparse representation from a dense state vector (drops zeros).

pub fn to_dense(&self) -> QuantumResult<StateVector>

Expand back to a dense StateVector.

Errors

Propagates the dense constructor’s qubit-count validation.

pub fn occupancy(&self) -> usize

Number of stored (nonzero) amplitudes.

pub fn norm_sq(&self) -> f32

Squared norm Σ|a|².

pub fn amp(&self, idx: usize) -> Complex<f32>

Amplitude at a basis index (zero if not stored).

pub fn apply_1q( &mut self, qubit: usize, gate: &[[Complex<f32>; 2]; 2], ) -> QuantumResult<()>

Apply a single-qubit gate to qubit.

Iterates the current support, pairs each key with its qubit-flipped partner, and writes the mixed amplitudes into a fresh map (so concurrent reads of the old amplitudes are consistent).

Errors

Returns QuantumError::QubitIndexOutOfRange if qubit >= n_qubits.

pub fn apply_cnot(&mut self, ctrl: usize, tgt: usize) -> QuantumResult<()>

Apply a CNOT with the given control and target.

A CNOT only permutes basis indices (flips tgt when ctrl=1), so this is a pure key remap that exactly preserves occupancy.

Errors

Returns QuantumError::QubitIndexOutOfRange for an out-of-range index or QuantumError::InvalidParameter if ctrl == tgt.

pub fn apply_ccx( &mut self, c0: usize, c1: usize, tgt: usize, ) -> QuantumResult<()>

Apply a Toffoli (CCX): flips tgt when both controls are 1. Pure key remap.

Errors

Returns an error for out-of-range or non-distinct qubit indices.

pub fn normalize(&mut self)

Normalize to unit norm (no-op if ~zero).

Trait Implementations

impl Clone for SparseStateVector

fn clone(&self) -> SparseStateVector

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SparseStateVector

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

Formats the value using the given formatter.