nook.plotting.levels

Level and band scheme drawings.

The layout follows the Nuclear Data Sheets vernacular rather than a generic plot: levels are horizontal rules on an energy axis, transitions are arrows that run downward from the depopulated level, and arrow width carries intensity. Readers of these figures already know that language, so borrowing it costs nothing and saves a legend.

For band schemes the columns are the structure: one column per rotational band, ordered by bandhead energy, so a K-isomer sits visibly apart from the ground-state band instead of being buried in a single crowded ladder.

nook.plotting.levels.plot_level_scheme(scheme, max_energy=None, limit=20, show_gammas=True, title=None, ax=None, figsize=(5.2, 7.0))

Draw a single-column level scheme.

limit caps the number of levels drawn from the bottom up, because a scheme with 240 levels is a solid black rectangle rather than a figure.

nook.plotting.levels.plot_band_scheme(scheme, bands=None, max_bands=5, max_energy=None, title=None, figsize=(9.0, 6.5))

Draw rotational bands side by side, one column each.

Columns are ordered by bandhead energy. Each is tinted and labelled with its decoded BAND() text, so a K-isomer reads as a separate structure rather than as levels interleaved with the ground-state band.