stim 0.2.0

Safe Rust bindings for Stim, a high-performance stabilizer circuit simulator and analyzer
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
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100

use crate::{DemInstruction, DemRepeatBlock, DetectorErrorModel};

/// An operation that can be appended to a
/// [`DetectorErrorModel`](crate::DetectorErrorModel).
///
/// When building a detector error model programmatically, you append
/// items one at a time via
/// [`DetectorErrorModel::append_operation`](crate::DetectorErrorModel::append_operation).
/// This enum unifies the three types that method accepts:
///
/// - [`Instruction`](Self::Instruction) -- a single
///   [`DemInstruction`] (e.g. `error(0.125) D0 D1`).
/// - [`RepeatBlock`](Self::RepeatBlock) -- a [`DemRepeatBlock`]
///   (`repeat N { ... }`).
/// - [`DetectorErrorModel`](Self::DetectorErrorModel) -- an entire
///   [`DetectorErrorModel`](crate::DetectorErrorModel) whose items are
///   concatenated into the target model.
///
/// Each inner type converts into `DemAppendOperation` via `From`, for
/// both owned and borrowed values.
///
/// # Examples
///
/// ```
/// let inst: stim::DemInstruction = "error(0.125) D1".parse().expect("valid");
/// let op = stim::DemAppendOperation::from(inst);
/// assert!(matches!(op, stim::DemAppendOperation::Instruction(_)));
///
/// let body: stim::DetectorErrorModel = "error(0.1) D0".parse().expect("valid");
/// let block = stim::DemRepeatBlock::new(5, &body).expect("valid");
/// let op = stim::DemAppendOperation::from(block);
/// assert!(matches!(op, stim::DemAppendOperation::RepeatBlock(_)));
///
/// let model: stim::DetectorErrorModel = "error(0.1) D0\nerror(0.2) D1"
///     .parse().expect("valid");
/// let op = stim::DemAppendOperation::from(model);
/// assert!(matches!(op, stim::DemAppendOperation::DetectorErrorModel(_)));
/// ```
#[derive(Clone, PartialEq, Eq, Debug)]
pub enum DemAppendOperation {
    /// Append a single DEM instruction (e.g. `error`, `detector`,
    /// `shift_detectors`).
    Instruction(DemInstruction),
    /// Append a `repeat N { ... }` block.
    RepeatBlock(DemRepeatBlock),
    /// Append all items from another detector error model, concatenating
    /// them into the target model in order.
    DetectorErrorModel(DetectorErrorModel),
}

impl From<DemInstruction> for DemAppendOperation {
    fn from(value: DemInstruction) -> Self {
        Self::Instruction(value)
    }
}

impl From<&DemInstruction> for DemAppendOperation {
    fn from(value: &DemInstruction) -> Self {
        Self::Instruction(value.clone())
    }
}

impl From<DemRepeatBlock> for DemAppendOperation {
    fn from(value: DemRepeatBlock) -> Self {
        Self::RepeatBlock(value)
    }
}

impl From<&DemRepeatBlock> for DemAppendOperation {
    fn from(value: &DemRepeatBlock) -> Self {
        Self::RepeatBlock(value.clone())
    }
}

impl From<DetectorErrorModel> for DemAppendOperation {
    fn from(value: DetectorErrorModel) -> Self {
        Self::DetectorErrorModel(value)
    }
}

impl From<&DetectorErrorModel> for DemAppendOperation {
    fn from(value: &DetectorErrorModel) -> Self {
        Self::DetectorErrorModel(value.clone())
    }
}

#[cfg(test)]
mod tests {
    use super::DemAppendOperation;

    #[test]
    fn borrowed_repeat_blocks_convert_into_append_operations() {
        let body: crate::DetectorErrorModel = "error(0.125) D0".parse().unwrap();
        let block = crate::DemRepeatBlock::new(2, &body).unwrap();
        assert!(matches!(
            DemAppendOperation::from(&block),
            DemAppendOperation::RepeatBlock(_)
        ));
    }
}