How openmc-dev/openmc works
OpenMC is a Monte Carlo particle-transport code with a Python API for defining and running models and a C++ transport engine. The principal workflow is model setup, execution of particle transport against geometry and cross-section data, tallying, and result output. Python modules also provide multi-group cross-section and depletion workflows. The graph includes these documented and indexed subsystems; unsampled implementation details are omitted, and unverified runtime handoffs are dashed.
Main entry points: simulation.h Simulation state · tally_scoring.cpp Tally scoring · mgxs.py Multi-group XS · model.py Model API
Components 19
Modeling and execution
- Model API
openmc/model/model.py - Run executor
openmc/executor.py - Native entry
src/main.cpp - Run settings
include/openmc/settings.h
Transport engine
- Simulation state
include/openmc/simulation.h - Geometry navigation
src/geometry.cpp - Materials
src/material.cpp - Cross sections
src/cross_sections.cpp - Particle tracking
src/particle.cpp - Transport physics
src/physics.cpp - Mesh operations
src/mesh.cpp
Scoring and results
- Tally scoring
src/tallies/tally_scoring.cpp - Tally results
src/tallies/tally.cpp - Statepoint output
src/state_point.cpp
Nuclear data analysis
- Multi-group XS
openmc/mgxs/mgxs.py - Nuclear data
openmc/data/reaction.py
Depletion
- Depletion integrators
openmc/deplete/abc.py - Transport operator
openmc/deplete/openmc_operator.py
Other components
- Model user
Connections 16
- Model user → Model API: defines model
- Model API → Run executor: runs model
openmc/model/model.py - Run executor → Native entry: launches engine
- Native entry → Run settings: uses settings
- Simulation state → Geometry navigation: uses geometry
- Simulation state → Materials: uses materials
- Simulation state → Particle tracking: tracks particles
- Particle tracking → Transport physics: transports through
- Materials → Cross sections: uses data
- Simulation state → Mesh operations: uses meshes
include/openmc/simulation.h - Tally scoring → Tally results: scores into
src/tallies/tally_scoring.cpp - Tally results → Statepoint output: writes results
- Multi-group XS → Tally scoring: uses tallies
openmc/mgxs/mgxs.py - Multi-group XS → Nuclear data: uses nuclear data
openmc/mgxs/mgxs.py - Depletion integrators → Transport operator: uses operator
openmc/deplete/abc.py - Transport operator → Tally scoring: generates tallies