Introduction to the OpenMC Reactor Physics Learning Project

This project is a self-study initiative maintained by Amnael50, with source code hosted on GitHub (link: https://github.com/Amnael50/openmc-reactor-physics) and released on June 8, 2026. Through progressive cases built with OpenMC (an open-source Monte Carlo neutron transport simulation program), the project explores the core physics of light water reactor (LWR) lattices, aiming to help learners master reactor physics understanding and Monte Carlo modeling skills.

Project Features:

• Progressive design: From infinite lattices to full-core models, deepening step by step
• Practice-oriented: Combining theory with hands-on operations
• Skill development: Covering reactor physics knowledge, Python programming, and scientific computing toolchains

As an open-source educational resource, this project provides an ideal entry path for nuclear engineering learners.

Project Background: OpenMC and Monte Carlo Methods

Introduction to OpenMC

OpenMC is an open-source Monte Carlo neutron transport simulation program developed by institutions such as the Massachusetts Institute of Technology. It can calculate key parameters like the effective multiplication factor (k-effective), neutron flux distribution, and reaction rates.

Applications of Monte Carlo Methods in Reactor Physics

• Simulate the complete lifecycle of neutrons from generation to absorption/leakage
• Calculate system criticality and flux distribution
• Analyze the impact of material/geometry configurations on reactor performance
• Verify results from deterministic transport methods

Compared to deterministic methods, Monte Carlo methods have strong geometric adaptability, can accurately handle complex geometries and energy spectra, and are important tools for reactor physics research.

Progressive Learning Path Design

The project adopts a progressive learning model from basic to complex:

Basic Stage: Infinite Lattice Calculation

• Geometric modeling of components like fuel rods, cladding, and moderators
• Definition of material properties and cross-section data
• Setting of periodic boundary conditions
• Calculation of infinite multiplication factor and lattice homogenization parameters

Advanced Stage: Finite Geometry and Reflectors

• Definition of finite-size fuel assemblies
• Role and modeling of reflectors
• Impact of leakage effects on criticality
• Calculation of effective multiplication factor for finite systems

Advanced Stage: Full-Core Modeling

• Construction of multi-assembly core geometry
• Modeling of control rods and burnable poisons
• Preliminary concepts of power distribution and thermal-hydraulic feedback
• Basics of burnup calculation and fuel management

Core Knowledge Points of Light Water Reactor Lattice Physics

Thermal Neutron Reactor Physics

• Neutron moderation: Mechanism of light water as a moderator, moderation ratio and average logarithmic energy decrement
• Resonance absorption: Self-shielding effect in the U-238 resonance energy region, calculation of effective resonance integral
• Thermal neutron utilization factor: Analysis of thermal neutron distribution in fuel and moderator

Lattice Non-Uniformity Effects

• Spatial self-shielding: Causes of flux depression inside fuel rods
• Dancoff effect: Mutual shielding effect between adjacent fuel rods
• Lattice optimization: Impact of fuel-moderator ratio on criticality and power distribution

Criticality and Reactivity

• Effective multiplication factor: Physical meaning and calculation methods
• Reactivity coefficients: Safety parameters like temperature coefficient, void coefficient, and fuel temperature coefficient
• Critical search: Techniques for adjusting parameters to achieve system criticality

Key Technical Skills Developed by the Project

Python Programming

• Use of OpenMC Python API
• Programmatic definition of geometry and materials
• Extraction and analysis of result data
• Application of visualization tools

Computational Physics Methods

• Statistical error analysis of Monte Carlo simulations
• Convergence judgment and source iteration acceleration
• Basics of parallel computing and distributed simulation
• Management and optimization of computing resources

Scientific Computing Toolchain

• Git version control
• Jupyter Notebook interactive analysis
• Matplotlib data visualization
• HDF5 large-scale data processing

Educational Value and Project Expansion Directions

Educational Value

• Practice-oriented: Deepen understanding of physical concepts by modifying parameters and running simulations
• Open-source ecosystem experience: Participate in open-source projects, learn version control and community collaboration
• Professional skills: Cultivate skills like Python and Monte Carlo simulation that are in demand in the nuclear energy industry

Project Limitations

• Steady-state calculation only, no consideration of transient behavior
• Fixed temperature, no thermal-hydraulic feedback
• Simplified geometry, not fully reflecting the complexity of commercial reactors

Expansion Directions

• Advanced physics: Burnup calculation, transient analysis, thermal-hydraulic coupling
• Other reactor types: Fast reactors, high-temperature gas-cooled reactors, molten salt reactors
• Experimental validation: Verify models by comparing with experimental data
• Uncertainty quantification: Sensitivity analysis and uncertainty assessment

OpenMC Community and Learning Resources

OpenMC has an active community and rich resources:

• Official Documentation: Detailed user guides and API documentation
• Example Library: Official examples covering various application scenarios
• User Forum: Active discussion community where you can ask questions and exchange ideas
• Academic Literature: A large number of research papers based on OpenMC for reference

These resources provide a good support environment for learners.