nook.sources.ripl3.masses

The RIPL-3 masses segment: experimental and theoretical mass tables.

Three tables, two theory families:

• mass-frdm95.dat – FRDM (1995) masses and deformations, plus the Audi experimental mass excesses the file ships with, (2i4,1x,a2,1x,i1,4f10.3,4f8.3).

• mass-hfb14.dat – HFB-14 masses, deformations and Fermi-function density-shape parameters, same leading columns.

• abundance.dat – natural abundances (Nuclear Wallet Cards 2005).

The experimental columns cannot be split on whitespace: a nucleus with no measured mass (fl = 0) has an empty Mexp but a present Mth, which whitespace splitting silently shifts left. Everything slices by column. Energies convert MeV -> keV at parse time, matching the rest of the package; deformations and density parameters are dimensionless or fm-based and pass through.

class nook.sources.ripl3.masses.MassEntry(nuclide, mass_excess_exp, recommended_only=False, mass_excess_frdm95=None, mass_excess_hfb14=None, emic_frdm95=None, beta2_frdm95=None, beta3_frdm95=None, beta4_frdm95=None, beta6_frdm95=None, beta2_hfb14=None, beta4_hfb14=None, neutron_density_params=None, proton_density_params=None, abundance=None)

Bases: object

One nuclide across the RIPL-3 mass tables. Energies in keV.

nuclide: Nuclide

mass_excess_exp: Uncertain

Audi experimental/recommended mass excess as shipped with RIPL-3.

recommended_only: bool = False

fl = 1: the “experimental” value is recommended, not measured.

mass_excess_frdm95: Uncertain | None = None

mass_excess_hfb14: Uncertain | None = None

emic_frdm95: float | None = None

FRDM microscopic correction, keV.

beta2_frdm95: float | None = None

beta3_frdm95: float | None = None

beta4_frdm95: float | None = None

beta6_frdm95: float | None = None

beta2_hfb14: float | None = None

beta4_hfb14: float | None = None

neutron_density_params: tuple[float, float, float] | None = None

HFB-14 Fermi-function density parameters: (rho0 fm^-3, r fm, a fm).

proton_density_params: tuple[float, float, float] | None = None

abundance: Uncertain | None = None

provenance(quantity)

units(quantity)

to_ground_state()

Project onto the shared GroundState.

Only the fields RIPL actually carries are filled; theory values ride in metadata so the schema stays identical across sources.

class nook.sources.ripl3.masses.MatterDensity(nuclide, beta2, rows)

Bases: object

A spherically averaged HFB-14 matter-density profile.

nuclide: Nuclide

beta2: float | None

rows: tuple[tuple[float, float, float], ...]

(radius fm, neutron density fm^-3, proton density fm^-3) rows.

nook.sources.ripl3.masses.load_mass_entry(path, nuclide)

Everything the mass tables say about one nuclide.

nook.sources.ripl3.masses.load_mass_table(path)

Every nuclide across the mass tables, keyed (z, a) (bulk data).

nook.sources.ripl3.masses.load_matter_density(path, nuclide)

The tabulated HFB-14 density profile for one nuclide (bulk data).