nook.plotting.decay

Decay scheme drawings.

The classic layout: the parent sits above and to one side, the daughter’s levels form a ladder, and feeding arrows run from the parent onto the levels they populate. Feeding intensity sets arrow width and is printed with the log ft, because those two together are what a reader checks – a low log ft onto a level two units of spin away is a red flag.

Intensities are drawn on the absolute scale (per 100 parent decays) whenever the dataset carries an N record, since relative intensities are meaningless outside their own dataset. The axis label says which you got.

The two quantities get separate visual channels: arrow width is intensity, arrow darkness is log ft. Printing every log ft beside its arrow works for four or five branches and turns to noise beyond that, so only the extremes are labelled – the fastest and slowest transitions, and the strongest branch. Those are the ones a reader checks anyway.

nook.plotting.decay.plot_decay_scheme(scheme, max_levels=10, show_gammas=True, title=None, figsize=(8.6, 6.4), annotate=None)

Draw a decay scheme: parent, feedings and the daughter’s levels.

annotate caps how many feedings are labelled in place. The default labels all of them when there are five or fewer, and otherwise only the extremes: fastest log ft, slowest log ft, and strongest branch.