oxicuda-quantum 0.1.8

Quantum simulation primitives for OxiCUDA — state-vector simulation, Pauli expectation values, VQE/QAOA, density matrices, Trotter-Suzuki, quantum kernels
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47

/// Errors produced by quantum simulation operations.
#[derive(Debug, thiserror::Error)]
pub enum QuantumError {
    #[error("empty input")]
    EmptyInput,

    #[error("dimension mismatch: expected {expected}, got {got}")]
    DimensionMismatch { expected: usize, got: usize },

    #[error("invalid qubit count: {n}")]
    InvalidQubitCount { n: usize },

    #[error("qubit index {index} out of range for {n_qubits} qubits")]
    QubitIndexOutOfRange { index: usize, n_qubits: usize },

    #[error("state not normalized: norm = {norm}")]
    NonNormalizedState { norm: f32 },

    #[error("Hamiltonian is not Hermitian")]
    NonHermitianHamiltonian,

    #[error("Kraus operators not complete: residual = {residual}")]
    KrausNotComplete { residual: f32 },

    #[error("invalid parameter '{name}'")]
    InvalidParameter { name: String },

    #[error("invalid Pauli operator '{op}'")]
    InvalidPauliOp { op: String },

    #[error("incompatible ansatz configuration")]
    IncompatibleAnsatz,

    #[error("optimization diverged after {iter} iterations")]
    OptimizationDiverged { iter: usize },

    #[error("model not fitted (call fit() first)")]
    NotFitted,

    #[error("measurement failed")]
    MeasurementFailed,

    #[error("internal error: {msg}")]
    Internal { msg: String },
}

pub type QuantumResult<T> = std::result::Result<T, QuantumError>;