Struct DetectorConfig 

pub struct DetectorConfig {
    pub tdc_frequency_hz: f64,
    pub enable_missing_tdc_correction: bool,
    pub chip_size_x: u16,
    pub chip_size_y: u16,
    pub chip_transforms: Vec<ChipTransform>,
}

Detector configuration for TPX3 processing.

Fields

tdc_frequency_hz: f64

TDC frequency in Hz (default: 60.0 for SNS).

enable_missing_tdc_correction: bool

Enable missing TDC correction.

chip_size_x: u16

Chip size X in pixels (default: 256).

chip_size_y: u16

Chip size Y in pixels (default: 256).

chip_transforms: Vec<ChipTransform>

Per-chip affine transforms.

Implementations

impl DetectorConfig

pub fn venus_defaults() -> Self

Create VENUS/SNS default configuration.

Uses specific affine transforms for the 4 chips:

• Chip 0: Translation (258, 0)
• Chip 1: Rotation 180 + Translation (513, 513)
• Chip 2: Rotation 180 + Translation (255, 513)
• Chip 3: Identity (0, 0)

pub fn from_file<P: AsRef<Path>>(path: P) -> Result<Self, Box<dyn Error>>

Load configuration from a JSON file (C++ compatible schema).

Validates all chip transforms to ensure they produce valid coordinates.

Errors

Returns an error if the file cannot be read or the JSON is invalid.

pub fn from_json(json: &str) -> Result<Self, Box<dyn Error>>

Load configuration from a JSON string (C++ compatible schema).

Validates all chip transforms to ensure they produce valid coordinates.

Errors

Returns an error if the JSON is invalid.

pub fn to_json_string(&self) -> Result<String, Box<dyn Error>>

Serialize configuration to a JSON string (C++ compatible schema).

Errors

Returns an error if serialization fails.

pub fn to_file<P: AsRef<Path>>(&self, path: P) -> Result<(), Box<dyn Error>>

Save configuration to a JSON file (C++ compatible schema).

Errors

Returns an error if serialization or file I/O fails.

pub fn validate_transforms(&self) -> Result<(), Box<dyn Error>>

Validate all chip transforms produce valid u16 coordinates.

This is called automatically when loading from JSON. For programmatically created configs, call this before processing.

Errors

Returns an error if any transform is invalid.

pub fn tdc_period_seconds(&self) -> f64

TDC period in seconds.

pub fn tdc_correction_25ns(&self) -> u32

TDC correction value in 25ns units.

pub fn map_chip_to_global(&self, chip_id: u8, x: u16, y: u16) -> (u16, u16)

Map local chip coordinates to global detector coordinates.

Uses the configured affine transform for the given chip ID. If chip ID is out of bounds, returns local coordinates as-is (identity).

pub fn detector_dimensions(&self) -> (usize, usize)

Calculate detector dimensions from chip layout and transforms.

Returns (width, height) in pixels sized to include all transformed chip coordinates, preserving gaps/offsets introduced by transforms.

Trait Implementations

impl Clone for DetectorConfig

fn clone(&self) -> DetectorConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DetectorConfig

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

Formats the value using the given formatter.

impl Default for DetectorConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for DetectorConfig

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for DetectorConfig

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.