Struct ChunkedStateVector 

pub struct ChunkedStateVector { /* private fields */ }

Represents a quantum state vector that uses chunked memory for large qubit counts

Implementations

impl ChunkedStateVector

pub fn new(num_qubits: usize) -> Self

Create a new chunked state vector for given number of qubits

pub fn num_qubits(&self) -> usize

Get the number of qubits

pub fn dimension(&self) -> usize

Get the dimension of the state vector

pub fn get_amplitude(&self, idx: usize) -> Complex64

Access a specific amplitude by global index

pub fn as_vec(&self) -> Vec<Complex64>

Get all amplitudes as a flattened vector (for testing and conversion) Warning: For large qubit counts, this will use a lot of memory

pub fn apply_single_qubit_gate(&mut self, matrix: &[Complex64], target: usize)

Apply a single-qubit gate to the state vector using chunked processing

Arguments

• matrix - The 2x2 matrix representation of the gate
• target - The target qubit index

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

Apply a controlled-NOT gate to the state vector

Arguments

• control - The control qubit index
• target - The target qubit index

pub fn apply_two_qubit_gate( &mut self, matrix: &[Complex64], qubit1: usize, qubit2: usize, )

Apply a two-qubit gate to the state vector

Arguments

• matrix - The 4x4 matrix representation of the gate
• qubit1 - The first qubit index
• qubit2 - The second qubit index

pub fn probability(&self, bit_string: &[u8]) -> f64

Calculate probability of measuring a specific bit string

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

Calculate probabilities for all basis states Warning: For large qubit counts, this will use a lot of memory

pub fn probability_range(&self, start_idx: usize, end_idx: usize) -> Vec<f64>

Calculate the probability of a specified range of states More memory efficient for large qubit counts