How ldmx-software/ldmx-sw works
Main Components Organization
a) Core Framework Layer:
• Framework/ directory contains the core infrastructure
• Process, Event, and Configuration management
• Connections to conditions system and random number services
b) Detector Systems:
• DetDescr/, Detectors/, and geometry-related components
• Relationships between detector description and simulation
• Detector ID systems and electronics mapping
c) Simulation Stack:
• SimCore/ as the central simulation component
• Integration with Geant4 (indicated by G4 prefixes)
• Biasing operators and physics models
• To magnetic field and detector construction
d) Reconstruction Chain:
• Recon/, Tracking/, and detector-specific reconstruction (Ecal/, Hcal/, TrigScint/)
• Data flow from raw data through reconstruction stages
• Clustering and particle identification
e) Analysis & Validation:
• DQM/ for monitoring
• Validation/ for quality checks
• Tools/ for analysis utilities
Specific Implementation Details
[Core Framework Layer]
• [Event Processing]-->[Conditions System]
• [Configuration]---->[Python Interface]
• [Plugin System]---->[Module Loading]
[Detector Description]
• [Geometry]-------->[GDML Parsing]
• [ID Systems]------>[Electronics Mapping]
[Simulation Stack]
• [Geant4 Interface]
• [Physics Lists]
• [Biasing Operators]
• [Sensitive Detectors]
• [Magnetic Field]
• [Primary Generators]
[Reconstruction]
• [Tracking]-------->[Track Finding]-->[Track Fitting]
• [Calorimetry]----->[Clustering]---->[Energy Reconstruction]
• [Trigger]--------->[Hardware Trigger]-->[Software Trigger]
Additional Elements
a) External dependencies:
• Geant4
• ROOT
• Python
• ONNX Runtime
• Acts (for tracking)
b) Data formats and storage:
• Event data model
• Persistent storage
• Conditions database
c) Processing flow:
• Configuration
• Initialization
• Event processing
• Finalization
Important Interfaces
Interfaces between components:
• Framework to modules interface
• Simulation to reconstruction interface
• Detector description to simulation interface
• Analysis to reconstruction interface
Deployment Aspects
Container-based deployment:
• Docker/Apptainer support
• Development environment
• Production environment
• Hierarchical layout
• Different line styles
• Proper labeling
• Export to high-resolution formats