stabilizer-ch-form-rust 0.1.0

A Rust library implementing CH form representation of stabilizer states for quantum computing simulations.
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
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67

use thiserror::Error;

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

/// Custom error type for StabilizerCHForm operations.
#[derive(Error, Debug)]
pub enum Error {
    /// Error for invalid qubit index.
    #[error("Qubit index {0} is out of bounds for {1} qubits.")]
    QubitIndexOutOfBounds(usize, usize),

    /// Error for invalid number of qubits.
    #[error("Number of qubits must be greater than zero, got {0}.")]
    InvalidNumQubits(usize),

    /// Error for duplicate qubit indices in two-qubit gates.
    #[error("Two-qubit gate requires two different qubit indices, but got the same: {0}.")]
    DuplicateQubitIndices(usize),

    /// Error for impossible projection during measurement.
    #[error(
        "Impossible projection on qubit {qubit_index}: cannot project determined state |{}> onto|{}>.",
        if *desired { 0 } else { 1 },
        if *desired { 1 } else { 0 }
    )]
    ImpossibleProjection { qubit_index: usize, desired: bool },

    /// Error for mismatched qubit counts in operations involving two states (e.g., inner product).
    #[error(
        "The qubit counts of the two states must match for {}, got {} and {}.",
        operation,
        left,
        right
    )]
    QubitCountMismatch {
        operation: &'static str,
        left: usize,
        right: usize,
    },

    /// Error for invalid permutation length.
    #[error("The length of the permutation ({0}) must match the number of qubits ({1}).")]
    InvalidPermutationLength(usize, usize),

    /// Error for invalid permutation (not a valid rearrangement).
    #[error("The provided permutation {0:?} is not a valid permutation of qubit indices.")]
    InvalidPermutation(Vec<usize>),

    /// Error for invalid qubit state length.
    #[error("The length of the qubit state ({0}) does not match the number of qubits ({1}).")]
    InvalidQubitStateLength(usize, usize),

    /// Error for attempting to discard a qubit that cannot be discarded.
    #[error("Cannot discard qubit {0} because it is not in a proper state")]
    CannotDiscardQubit(usize),

    /// Error for QASM parsing issues.
    #[error("QASM parsing error: {0}")]
    QasmParsingError(String),

    /// Error for Pauli string parsing issues.
    #[error("Pauli string parsing error: {0}")]
    PauliStringParsingError(String),

    #[error("IO error: {0}")]
    Io(#[from] std::io::Error),
}