How lanl/branson works
Branson is a parallel Monte Carlo radiation-transport application. Users provide XML problem and performance parameters; the executable parses them, constructs and initializes a mesh, selects a transport mode, and advances particle histories/events while tracking tallies and simulation state. The README documents both replicated and domain-decomposed operation, plus particle-passing and event-based transport. Source excerpts are partial, so links to less-sampled capabilities rely on explicit README statements or SOURCE INDEX references; uncertain implementation details are omitted.
Main entry points: main.cc Simulation entry · event_based_transport.h Event transport · mesh.h Mesh setup · history_based_transport.h History transport
Components 23
Configuration and mesh
- Simulation entry
src/main.cc - Input parser
src/input.h - Mesh setup
src/mesh.h - Mesh topology
src/proto_mesh.h - Mesh decomposition
src/decompose_mesh.h
Transport simulation
- History transport
src/history_based_transport.h - Event transport
src/event_based_transport.h
Parallel execution
- Particle-pass driver
src/particle_pass_driver.h - Particle-pass transport
src/particle_pass_transport.h - Replicated driver
src/replicated_driver.h - Replicated transport
src/replicated_transport.h - MPI datatypes
src/mpi_types.h
Physics and state
- Photon state
src/photon.h - Photon arrays
src/photon_array.h - Particle sources
src/source.h - Sampling and scattering
src/sampling_functions.h - Counter RNG
src/RNG.h - IMC state
src/imc_state.h - Cell tallies
src/cell_tally.h - Silo output
src/write_silo.h
Other components
- Problem author
- XML input
- Silo/HDF5
Connections 24
- Problem author → XML input: defines problem
- XML input → Input parser: configures
src/input.h - Simulation entry → Input parser: reads
src/main.cc - Simulation entry → Mesh setup: constructs
src/main.cc - Mesh setup → Mesh topology: uses topology
src/mesh.h - Mesh setup → Mesh decomposition: decomposes
src/mesh.h - Simulation entry → Particle-pass driver: dispatches
src/main.cc - Particle-pass driver → Particle-pass transport: runs transport
- Simulation entry → Replicated driver: selects replicated
src/main.cc - Replicated driver → Replicated transport: runs transport
- Simulation entry → Event transport: selects event mode
- Simulation entry → History transport: selects history mode
- History transport → Photon state: updates particles
src/history_based_transport.h - Event transport → Photon state: transports particles
src/event_based_transport.h - Event transport → Photon arrays: supports arrays
src/event_based_transport.h - History transport → Cell tallies: accumulates tallies
src/history_based_transport.h - Event transport → Cell tallies: updates tallies
src/event_based_transport.h - Sampling and scattering → Counter RNG: draws random values
src/sampling_functions.h - History transport → Sampling and scattering: uses sampling
src/history_based_transport.h - Event transport → Sampling and scattering: uses sampling
src/event_based_transport.h - Simulation entry → IMC state: passes state
src/main.cc - Mesh setup → MPI datatypes: uses MPI types
src/mesh.h - Problem author → Simulation entry: runs executable
- Silo output → Silo/HDF5: writes results