nook.plotting.chart

The chart of nuclides.

One square per nuclide on an N-Z grid. The chart is a map, so it is drawn like one: magic numbers as ruled lines because they are the coastline everyone navigates by, the valley of stability picked out in black, and everything else coloured by whatever property is being asked about.

Two colouring modes, because they answer different questions. "decay" uses the field’s own categorical convention, so a reader who has seen a Karlsruhe chart recognises it instantly. Any numeric attribute – half_life_s, s_n, q_alpha – gets a continuous ramp built from the package palette, which keeps the chart visually of a piece with the level schemes.

nook.plotting.chart.DECAY_COLOURS = {'A': '#C98A2B', 'B+': '#A6321F', 'B-': '#1F5673', 'EC': '#A6321F', 'IT': '#6E4E8F', 'N': '#7A8B3D', 'P': '#2E7D6B', 'SF': '#8C5A3C', 'stable': '#14181F'}

Categorical colours, following the chart-of-nuclides convention but re-hued to match the rest of the package.

nook.plotting.chart.AXIS_LABELS = {'beta2': '$\\beta_2$', 'gamma_width_mev_milli': '$\\langle\\Gamma_\\gamma\\rangle$  (meV)', 'half_life_s': '$\\log_{10}\\,(T_{1/2}\\,/\\,\\mathrm{s})$', 'q_alpha': '$Q_\\alpha$  (keV)', 'q_beta_minus': '$Q_{\\beta^-}$  (keV)', 'residual_kev': '$\\Delta_{\\mathrm{th}}-\\Delta_{\\mathrm{exp}}$  (keV)', 's_n': '$S_n$  (keV)', 's_p': '$S_p$  (keV)', 'spacing_kev': '$\\log_{10}\\,(D_0\\,/\\,\\mathrm{keV})$', 'strength_1e4': '$S_0$  $(10^{-4})$', 'two_j': 'ground-state $2J$'}

Proper notation for the quantities a chart is usually coloured by.

nook.plotting.chart.plot_chart(states, colour_by='decay', log=None, title=None, figsize=(11.0, 7.0), label_elements=True, robust=True, vmin=None, vmax=None, mark=None, mark_label='flagged', ax=None, colorbar=True)

Draw a chart of nuclides from nook.survey.survey() output.

colour_by is "decay" for the categorical convention, or the name of any numeric NuclideSummary attribute. log defaults to true for half-lives, which span some thirty decades.

ax draws into an existing axes – the hook multi-panel figures such as plot_resonance_charts() use; figsize is ignored then. colorbar=False skips the per-axes bar so panel figures sharing one scale can draw a single shared bar instead.

robust clips the colour scale to the 1st-99th percentile. Evaluated files contain the odd transcription error – a sign-flipped separation energy is enough to stretch the scale until the real structure washes out – and one bad record should not decide how 3000 good ones are drawn. Pass vmin/vmax to set the range yourself, or robust=False for the full extent. See inconsistencies().

mark rings a set of nuclides – handy for showing which squares are flagged as suspect, or simply the ones you care about.