Metrics Tools API¶

Visualize a run's durable monitor and epoch health summary (P20).

`visualize_metrics(summary, output_dir=None)` ¶

Plot MRR, loss means, logit scales and each level's radius mean and SD from an epoch summary.

Parameters:

Name	Type	Description	Default
`summary`	`Path`	The run's `epoch_summary.jsonl`.	required
`output_dir`	`Optional[Path]`	Plot directory; by default `visualizations` beside the summary.	`None`

Returns:

Type	Description
`Dict[str, Any]`	The parsed rows (`metrics`), `num_epochs` and the PNG's `output_file` path.

Raises:

Type	Description
`FileNotFoundError`	If the summary is absent.
`ValueError`	If its rows are invalid or no epoch was recorded.
`ImportError`	If visualization dependencies are unavailable.