nook.sources.ripl3

RIPL-3 backend: the IAEA Reference Input Parameter Library, from disk.

RIPL-3 is a static library (Capote et al., Nucl. Data Sheets 110 (2009) 3107; the discrete-levels segment was last cut in 2021), so unlike the other backends it is mirrored wholesale into the repository – data/ripl3/ – by tools/fetch_ripl3.py, and parsed from there.

The discrete levels derive from ENSDF, which is what makes cross-source comparison meaningful; everything else (masses, resonances, optical potentials, level densities, gamma strength, fission barriers) has no counterpart in the other two backends.

nook.sources.ripl3.RIPL3_EVALUATIONS = {'abundance': 'isotopic abundances as shipped with RIPL-3', 'beta2_frdm95': 'FRDM ground-state deformations', 'beta2_hfb14': 'HFB-14 ground-state deformations', 'fission_barriers': 'RIPL-3 empirical and HFB fission barriers', 'gdr': 'RIPL-3 giant dipole resonance parameters', 'gsf': 'RIPL-3 gamma-ray strength functions', 'hfb_density': 'HFB plus combinatorial level densities (Goriely et al.)', 'level_density': 'RIPL-3 level-density parameters', 'levels': 'RIPL-3 discrete levels (2021 cut; derived from ENSDF, NUBASE2020 ground states, AME2020 separation energies)', 'levels_param': 'RIPL-3 constant-temperature fit of discrete level schemes', 'mass_excess_exp': 'Audi mass evaluation as shipped with RIPL-3', 'mass_excess_frdm95': 'FRDM (Moller, Nix, Myers, Swiatecki 1995)', 'mass_excess_hfb14': 'HFB-14 (Goriely, Samyn, Pearson 2007)', 'optical': 'RIPL-3 optical model parameter archive', 'resonances': 'RIPL-3 average neutron resonance parameters'}

Which compilation each RIPL-3 segment or quantity comes from. The same idea as nook.groundstate.EVALUATIONS: attribution families, not per-value citations.

nook.sources.ripl3.RIPL3_UNITS = {'abundance': '% (mole fraction)', 'barrier_height': 'MeV', 'barrier_hw': 'MeV', 'd0': 'keV', 'd1': 'keV', 'gamma_energy': 'keV', 'gamma_intensity': 'probability (Pg, not per-100)', 'gamma_width': 'meV', 'gdr_cross_section': 'mb', 'gdr_energy': 'MeV', 'gdr_width': 'MeV', 'half_life': 's', 'level_energy': 'keV', 'mass_excess': 'keV', 's0': '1e-4', 's1': '1e-4', 'sn': 'keV', 'sp': 'keV', 'temperature': 'MeV'}

Units after parsing. File-native units (MeV, mostly) are converted at parse time; raw fields keep the file’s numbers.

nook.sources.ripl3.default_ripl_path()

$RIPL_PATH, else the repository’s committed mirror.

The mirror lives at data/ripl3 in the repository root, which resolves from an editable install; a wheel install has no mirror and must set $RIPL_PATH.

class nook.sources.ripl3.Ripl3Source(path=None)

Bases: object

Read RIPL-3 data from a local mirror.

name = 'ripl3-local'

levels(nuclide)

The raw RIPL block: counts, cutoffs, levels, gammas.

fetch(nuclide, up_to_nmax=False)

The discrete level scheme as a LevelScheme.

up_to_nmax=True truncates at RIPL’s own completeness cutoff Nmax – the evaluator’s judgement, as opposed to the heuristic complete_up_to().

levels_param()

The constant-temperature fit table for every nuclide.

sn_table(zs=None)

Neutron separation energies (keV) from the levels headers (bulk).

Walks every per-element levels file – half a minute cold, cached after – so zs can restrict the sweep to an iterable of Z values.

masses(nuclide)

Experimental and theoretical masses, deformations, abundance.

mass_table()

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

ground_state(nuclide)

The mass tables projected onto the shared ground-state model.

Far sparser than the Livechart ground state: RIPL carries mass excess and abundance, and its theory-only values (FRDM95, HFB-14, deformations) ride in metadata.

matter_density(nuclide)

The tabulated HFB-14 spherical matter-density profile.

resonances(nuclide, wave=0)

Average s-wave (0) or p-wave (1) resonance parameters for a target.

resonance_table(wave=0)

Every target’s average resonance parameters for one wave (bulk data).

gdr(nuclide)

Every GDR parameterisation: experimental fits first, then theory.

gsf(nuclide)

The microscopic (HFB+QRPA) E1 strength function table.

fission_barriers(nuclide, model='empirical')

Fission barriers, model = "empirical" or "hfb".

optical_potentials(nuclide=None, projectile=None, ripl_id=None, energy_mev=None)

Archive entries filtered by applicability (records, not V(r)).

deformations(nuclide)

Excited-level deformation parameters (coupled-channel input).

level_density_params(nuclide, model='egsm')

Analytic level-density parameters; models: egsm, bfm, ctm, hfm.

hfb_density(nuclide)

The microscopic HFB level-density table rho(E, J, parity).

Modules

densities	The RIPL-3 densities segment: level-density parameters and HFB tables.
fission	The RIPL-3 fission segment: barriers, empirical and HFB.
gamma	The RIPL-3 gamma segment: GDR parameters and gamma-ray strength functions.
levels	The RIPL-3 discrete-levels segment: per-element z0NN.dat files.
masses	The RIPL-3 masses segment: experimental and theoretical mass tables.
optical	The RIPL-3 optical segment: the optical model parameter archive.
resonances	The RIPL-3 resonances segment: average neutron resonance parameters.