Struct QulacsStateVector 

pub struct QulacsStateVector { /* private fields */ }

Qulacs-inspired quantum state vector

This structure provides a high-performance state vector implementation following Qulacs’ design principles, adapted to use SciRS2’s abstractions.

Implementations

impl QulacsStateVector

pub fn new(num_qubits: usize) -> Result<Self>

Create a new state vector initialized to |0…0⟩

Arguments

• num_qubits - Number of qubits

Returns

A new quantum state vector

pub fn from_amplitudes(amplitudes: Array1<Complex64>) -> Result<Self>

Create a state vector from raw amplitudes

Arguments

• amplitudes - The state amplitudes

Returns

A new quantum state vector

pub fn num_qubits(&self) -> usize

Get the number of qubits

pub fn dim(&self) -> StateIndex

Get the dimension of the state vector

pub fn amplitudes(&self) -> &Array1<Complex64>

Get a reference to the state amplitudes

pub fn amplitudes_mut(&mut self) -> &mut Array1<Complex64>

Get a mutable reference to the state amplitudes

pub fn norm_squared(&self) -> f64

Calculate the squared norm of the state vector

Uses efficient array operations (SciRS2 ndarray is already optimized)

pub fn normalize(&mut self) -> Result<()>

Normalize the state vector

Uses SciRS2 ndarray operations (already optimized)

pub fn inner_product(&self, other: &Self) -> Result<Complex64>

Calculate inner product with another state vector

⟨self|other⟩ using SciRS2 ndarray operations

pub fn reset(&mut self)

Reset state to |0…0⟩

pub fn probability_one(&self, target: QubitIndex) -> Result<f64>

Calculate probability of measuring |1⟩ on a specific qubit

This does not collapse the state

Arguments

• target - Target qubit index

Returns

Probability of measuring 1 (0.0 to 1.0)

pub fn probability_zero(&self, target: QubitIndex) -> Result<f64>

Calculate probability of measuring |0⟩ on a specific qubit

This does not collapse the state

Arguments

• target - Target qubit index

Returns

Probability of measuring 0 (0.0 to 1.0)

pub fn measure(&mut self, target: QubitIndex) -> Result<bool>

Measure a single qubit in the computational basis

This performs a projective measurement and collapses the state

Arguments

• target - Target qubit index

Returns

Measurement outcome (false = 0, true = 1)

pub fn sample(&self, shots: usize) -> Result<Vec<Vec<bool>>>

Sample measurement outcomes without collapsing the state

Arguments

• shots - Number of measurement samples

Returns

Vector of measurement outcomes (bit strings)

pub fn get_counts(&self, shots: usize) -> Result<HashMap<Vec<bool>, usize>>

Get measurement counts (histogram) without collapsing the state

Arguments

• shots - Number of measurement samples

Returns

HashMap mapping bit strings to counts

pub fn sample_qubits( &self, qubits: &[QubitIndex], shots: usize, ) -> Result<Vec<Vec<bool>>>

Sample measurements of specific qubits

Arguments

• qubits - Qubit indices to measure
• shots - Number of measurement samples

Returns

Vector of partial measurement outcomes

Trait Implementations

impl Clone for QulacsStateVector

fn clone(&self) -> QulacsStateVector

Returns a duplicate of the value.

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

Performs copy-assignment from source.