pymkm.mktable.plot

Plotting utilities for MKTable results.

This module defines the plot() method for the MKTable class, which allows visualization of microdosimetric quantities such as z̄*, z̄_d, and z̄_n as functions of energy or LET for different ions.

Plots include optional display of model configuration and geometry.

pymkm.mktable.plot.plot(self: MKTable, ions: List[str | int] | None = None, *, x: str = 'energy', y: str = 'z_bar_star_domain', verbose: bool = False, ax: Axes | None = None, show: bool | None = True)[source]

Plot microdosimetric quantities from the MKTable.

Parameters:

  • ions (list[str or int], optional) – List of ions to plot. If None, all computed ions are used.

  • x (str) – x-axis variable (‘energy’ or ‘let’).

  • y (str) – y-axis variable (‘z_bar_star_domain’, ‘z_bar_domain’, ‘z_bar_nucleus’).

  • verbose (bool) – Show model configuration in the plot.

  • ax (Optional[matplotlib.axes.Axes]) – Matplotlib Axes object to draw on. If None, a new figure is created.

  • show (Optional[bool]) – If True, displays the plot. Set False when embedding or scripting.

Raises:

  • RuntimeError – If table is empty.

  • ValueError – If x or y are invalid.