jmstate.utils.plot_params_history

plot_params_history(model, *, figsize=(10, 8))

Visualize the evolution of model parameters during fitting.

This function generates a grid of subplots showing the trajectory of each model parameter across iterations, allowing assessment of convergence and exploration of the optimization process.

Parameters:

• model (MultiStateJointModel) – The fitted model whose parameter history is to be plotted.

• figsize (tuple[int, int], optional) – Figure dimensions (width, height). Defaults to (10, 8).

Raises:

ValueError – If the model contains fewer than two recorded parameter states, preventing visualization.

Returns:

A tuple containing the matplotlib Figure

object and a flattened array of Axes objects corresponding to the subplots.

Return type:

tuple[plt.Figure, np.ndarray]