Skip to content
dominuszainPublic

About

ICARUS: Maxwellian-averaged neutron-capture cross sections and thermonuclear reaction rates for heavy nuclei

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

21 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ICARUS

Maxwellian-averaged cross sections and thermonuclear reaction rates

License: MIT Python

ICARUS computes Maxwellian-averaged cross sections (MACS) and thermonuclear reaction rates for neutron-capture reactions. It takes tabulated cross sections as input and integrates them over a Maxwellian energy distribution. The code was developed for my bachelor's thesis on heavy nuclei and can be coupled with reaction-network codes such as YAHFC.

Author: Zain Ul Abideen
GitHub repository: dominuszain/ICARUS

Latest version

The current implementation is the Python version in v1.22/. The earlier Fortran and Scilab implementations are kept in legacy/ for reference.

Quick start

python3 -m venv .venv
source .venv/bin/activate
pip install -r v1.22/requirements.txt
cd v1.22
python icarus.py ncap.txt --target 152

This writes results.txt with four columns: incident neutron energy (keV), equivalent stellar temperature (GK), Maxwellian-averaged cross section (mb), and reaction rate (cm³ s⁻¹ mol⁻¹).

Useful options:

python icarus.py ncap.txt --target 152 --plot
python icarus.py ncap.txt --target 87 --output rb87_results.txt
python icarus.py ncap.txt --target 152 --start-e 1 --end-e 200 --step-e 10

See v1.22/README.md for the complete CLI reference, input format, and output description. v1.22/DETAIL.md documents the implementation in more depth.

Input format

The input file has two whitespace-separated columns:

Column Quantity Unit
1 Incident neutron energy MeV
2 Cross section millibarn

Sample inputs are in v1.22/ncap.txt, v1.22/sample_input.txt, and v1.22/152gd.txt.

Method

The Maxwellian-averaged cross section is evaluated as

<σv> = (2 / (√π (kT)²)) ∫ σ(E) E exp(-E/kT) dE

The integral uses Simpson's rule, and the upper limit is replaced by a sufficiently large finite energy. The reaction rate follows from <σv>, the neutron velocity, and Avogadro's number. The v1.22 implementation also detects the number of input points automatically and can produce plots of the cross section and reaction rate.

The legacy Fortran and Scilab versions in legacy/ use a Riemann-sum approximation with a finite cutoff; v1.22 uses Simpson's rule.

Repository layout

.
├── v1.22/                  # current Python implementation
│   ├── icarus.py
│   ├── README.md
│   ├── DETAIL.md
│   ├── requirements.txt
│   └── sample inputs
├── legacy/                 # earlier Fortran and Scilab versions
│   ├── fortran-v1.21/
│   ├── fortran-prototypes/
│   ├── fortran-small-update/
│   └── scilab/
├── docs/                   # reference plots
├── CITATION.cff
└── LICENSE

Citation

If you use ICARUS, please cite the code:

@software{ulabideen_icarus_2026,
  author = {Ul Abideen, Zain},
  title  = {ICARUS: Maxwellian-averaged cross sections and thermonuclear reaction rates},
  year   = {2026},
  url    = {https://github.com/dominuszain/ICARUS}
}

License

The code is released under the MIT License.

About

ICARUS: Maxwellian-averaged neutron-capture cross sections and thermonuclear reaction rates for heavy nuclei

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages