Struct DetectorErrorModel 

pub struct DetectorErrorModel {
    pub num_detectors: usize,
    pub num_observables: usize,
    pub errors: Vec<DEMError>,
    pub coordinate_shifts: Vec<Vec<f64>>,
    pub detector_coords: HashMap<usize, Vec<f64>>,
}

Detector Error Model representation

Fields

num_detectors: usize

Number of detectors in the circuit

num_observables: usize

Number of logical observables

errors: Vec<DEMError>

List of error mechanisms

coordinate_shifts: Vec<Vec<f64>>

Coordinate system shifts (for visualization)

detector_coords: HashMap<usize, Vec<f64>>

Detector coordinates

Implementations

impl DetectorErrorModel

pub fn new(num_detectors: usize, num_observables: usize) -> Self

Create a new empty DEM

pub fn from_circuit(circuit: &StimCircuit) -> Result<Self>

Generate a DEM from a Stim circuit

This performs error analysis by:

1. Identifying all error mechanisms in the circuit
2. Propagating each error through to detectors/observables
3. Recording which detectors/observables are affected

pub fn to_dem_string(&self) -> String

Convert DEM to Stim DEM format string

pub fn from_dem_string(s: &str) -> Result<Self>

Parse a DEM from string

pub fn sample(&self) -> (Vec<bool>, Vec<bool>)

Sample errors according to the DEM

Returns (detector_outcomes, observable_flips) for a single sample

pub fn sample_batch(&self, num_shots: usize) -> Vec<(Vec<bool>, Vec<bool>)>

Sample multiple shots

pub fn total_error_probability(&self) -> f64

Get the total error probability

pub fn num_error_mechanisms(&self) -> usize

Get number of error mechanisms

pub fn force_error(&mut self, qubit: usize, error_type: ErrorType) -> usize

Force a specific error on a qubit with probability 1.0.

This inserts a deterministic error mechanism into the DEM for debugging and testing. The error targets no detectors or observables by default (they must be wired by the caller via the returned index, or by re-analysing the circuit); however, it records the qubit, error type, and probability so that downstream samplers see it as a certain event.

Arguments

• qubit — Index of the qubit to apply the error to.
• error_type — The Pauli or measurement error to force.

Returns

The index of the newly added error mechanism in self.errors.

pub fn force_error_with_targets( &mut self, qubit: usize, error_type: ErrorType, detector_targets: Vec<usize>, observable_targets: Vec<usize>, ) -> usize

Force a specific error and associate it with given detector and observable targets.

Unlike force_error, this variant lets the caller specify exactly which detectors and observables flip when the error occurs, enabling accurate decoding tests.

Trait Implementations

impl Clone for DetectorErrorModel

fn clone(&self) -> DetectorErrorModel

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DetectorErrorModel

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.