nuclib - a collection of nuclear physics functions

by Ricardo Yanez
Last updated: December 14, 2019

nuclib is a collection of nuclear physics functions useful for calculations in the analisis of data and simulations. The library consists of many functions that can be called from any C or C++ program. Manual pages and examples are available.


nuclib is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2, or (at your option) any later version.

This is distributed in the hope that it will be useful, but without any warranty; without even the implied warranty of merchantability or fitness for a particular purpose. See the GNU General Public License for more details.


File: nuclib-1.0.0.tar.gz

Size: 1238850 bytes

MD5 checksum: ff4262a283ae8afc20de7b0c1f133bb9


nuclib uses the GNU Scientific Library (GSL) for numerical calculations and autoconf, automake and libtool for compilation and installation of the library. All of these are available in most Linux distributions. Install them before proceeding. (In Debian install packages libgsl-dev autoconf automake libtool)

Untar the source,

$ tar -zxvf nuclib-1.0.0.tar.gz

For a basic installation do shell commands,

$ cd nuclib-1.0.0
$ ./configure
$ make
$ sudo make install
$ make distclean
$ sudo ldconfig


$ ./configure --help
for more configuration options.


Do 'man nuclib' to see the synopsis and list of function groups. Do 'man alevel', for example, to see the synopsis and description of a collection of level density parameter functions.

alevel groups functions to calculate the level density parameter in the Fermi-gas model, the temperature dependent level density parameter of Lestone, and the excitation energy fade-out level density parameter of Ignatyuk.

angular groups functions to calculate angular distributions, in particular, the fission angular distribution of Vandenbosch and Huizenga.

bass groups functions related to the Bass Model, like the fusion, interaction and Coulomb barriers, the fusion radius and the fusion cross section.

bf groups functions to calculate fission barriers, in particular, the Thomas-Fermi fission barrier.

bn is a function that returns the neutron binding energy of a nucleus.

djmk groups functions to calculate the values of the rotational wave function used in calculations of angular distributions.

elastic groups functions related to elastic scattering.

epax groups functions to calculate the fragmentation cross section according to the EPAX formula.

folding is a function to calculate the fission folding angle.

gngf is a function to calculate Gn/Gf of a nucleus.

grazing is a function to calculate the grazing angle and angular momentum in a nuclear reaction.

jave is a function to calculate the average spin of a compound nucleus.

K0 is a function to calculate standard deviation of the K-distribution.

kinem groups functions to calculate kinematical quantities in nuclear reactions, like the energy and velocity of the center-of-mass, the velocities and momenta of the compound nucleus and ejectiles, both relativistic and non-relativistic.

masses groups functions to calculate nuclear masses.

nu groups functions to calculate neutron multiplicities in fission.

pxn is a function to calculate the neutron evaporation probability from a compound nucleus.

rldm groups functions related to the Rotating Liquid Drop model of Cohen, Plasil and Swiatecki.

sierk groups functions related to Finite Range Liquid Drop model of Sierk.

symbol is a function that returns the name of an element.

tke is a function that returns the Total Kinetic Energy release in fission.

tl groups functions to calculate transmission coefficients.

xeff is a function that calculates the effective fissility parameter.

zname is a function that returns the atomic number of a given element.


Many examples can be found in directory test/. These programs can be compiled and used to test the functions. They also serve to illustrate how to call the functions.

nuclib in ROOT

To use the nuclib functions in ROOT load the library with,


and includes

gROOT->ProcessLine(".include /usr/local/include")


nuclib.3 alevel.3 angular.3 bass.3 bf.3 bn.3 djmk.3 elastic.3 epax.3 folding.3 gngf.3 grazing.3 jave.3 K0.3 (kinem.3 cn.3 com.3 proj.3) masses.3 nu.3 pxn.3 rldm.3 sierk.3 symbol.3 tke.3 tl.3 xeff.3 zname.3


range (1.0.0-1) unstable; urgency=low

  * Initial release.

 -- Ricardo Yanez <> Tue Oct 24 16:03:10 PDT 2017

This document was generated using AFT v5.098