Welcome to Isotopes’s documentation!

A minimal python interface to isotope data based on NUbase 2020, and to integer representations of isotopes, as used by libraries such as ENDF. Two distinct objects are defined:

  • ZAID, which is an encoding of isotope enumeration by its atomic number (Z), nucleon number (A) and isomeric state.

  • Isotope, which builds upon ZAID and adds data such as mass, natural abundance and decay rates.

For ease of use, all known isotopes are available to be imported directly from the top package level.

Examples

>>> from isotopes import ZAID, H, H3, Hydrogen2, Xenon135m1
>>> ZAID(92, 235, 0)
922350
>>> H.name
'Hydrogen'
>>> f"{H.mass:.10f}"
'1.0079709420'
>>> H.abundance
{H1: 0.999855, H2: 0.000145}
>>> H3.decay
1.782871574100462e-09
>>> Hydrogen2.A
2
>>> Xenon135m1.m
1