How snd-lhc/sndsw works
sndsw is the SND@LHC detector software framework, built on FairShip/FairRoot and exposed through C++ detector modules and Python/PyROOT workflows. Its documented path includes configuring geometry and running simulation, digitizing simulated detector points into hits and clusters, converting raw data, and inspecting or analyzing event data. GENFIT supplies reusable measurement, field, track-representation, and fitting machinery; SND-specific detector and reconstruction components sit alongside it. The README establishes the main workflow links; source excerpts and the index support selected internal links, while unsampled integration details are omitted.
Main entry points: run_simSND.py SND simulation · core Track framework · eventDisplay.py Event display · MufluxDigiReco.py Muon reconstruction
Components 23
Simulation and geometry
- Geometry configuration
geometry - Event generators
shipgen - SND simulation
shipLHC/run_simSND.py
Detector and data
- Detector models
shipLHC - MC digitization
sndFairTasks/DigiTaskSND.h - Raw conversion
shipLHC/rawData/convertRawData.py - MC event building
sndFairTasks/MCEventBuilder.h
Tracking and fields
- Track framework
genfit/core - Track measurements
genfit/measurements - Runge-Kutta tracks
genfit/include/genfit/RKTrackRep.h - Track fitters
genfit/fitters - Magnetic field access
genfit/core/include/FieldManager.h - Muon reconstruction
python/MufluxDigiReco.py
Analysis and display
- Analysis selection
analysis/cuts - Neutrino filtering
analysis/neutrinoFilterGoldenSample_stage2.py - Event display
macro/eventDisplay.py - Drift-tube monitoring
charmdet/drifttubeMonitoring.py
Shared runtime
- Geometry registry
python/ShipGeoConfig.py - Physical units
python/shipunit.py - ROOT utilities
python/rootUtils.py
Other components
- Researcher
- ROOT event data
- Detector raw data
Connections 23
- Researcher → SND simulation: runs simulation
README.md - Geometry configuration → SND simulation: configures geometry
- Event generators → SND simulation: supplies events
README.md - SND simulation → Detector models: transports particles
- SND simulation → ROOT event data: writes events
README.md - ROOT event data → MC digitization: provides MC points
README.md - MC digitization → ROOT event data: writes hits
README.md - Detector raw data → Raw conversion: provides raw data
README.md - Raw conversion → ROOT event data: writes converted data
README.md - MC event building → ROOT event data: builds event data
- Muon reconstruction → Track framework: uses track framework
- Track framework → Track measurements: uses measurements
genfit/measurements/include/FullMeasurement.h - Runge-Kutta tracks → Track framework: extends track representation
genfit/include/genfit/RKTrackRep.h - Track framework → Magnetic field access: provides field access
genfit/core/include/FieldManager.h - Muon reconstruction → ROOT event data: reconstructs tracks
- Researcher → Analysis selection: selects events
- Researcher → Neutrino filtering: filters neutrinos
- Researcher → Event display: views events
README.md - ROOT event data → Event display: loads event data
README.md - ROOT event data → Drift-tube monitoring: supplies monitoring data
- Event display → Geometry registry: loads configuration
macro/eventDisplay.py - Event display → ROOT utilities: uses ROOT helpers
- Geometry registry → Physical units: uses units
python/ShipGeoConfig.py