Skip to content

plot_mhmm()

plot_mhmm() visualizes mixture weights and per-cluster transition or emission matrices for a fitted MHMM.

Function Usage

python
plot_mhmm(
    model,
    which="clusters",
    figsize=None,
    ax=None
)

seqHMM Parameter Mapping

SequenzoseqHMM plot.mhmm()
modelFitted mhmm object
which="clusters"Mixture weight bar chart
which="transition" / "emission"Per-cluster parameter panels

Entry Parameters

ParameterRequiredTypeDescription
modelMHMMFitted mixture model.
whichstr"clusters", "transition", "emission", or "all". Default "clusters".
figsizetuple / NoneFigure size.
axAxes / NoneExisting matplotlib axes.

What It Returns

A matplotlib Figure.

Example

python
from sequenzo.seqhmm import build_mhmm, fit_mhmm, plot_mhmm
import matplotlib.pyplot as plt

mhmm = build_mhmm(seq, n_clusters=3, n_states=4, random_state=42)
mhmm = fit_mhmm(mhmm)

plot_mhmm(mhmm, which="all")
plt.show()

R Counterpart

  • Closest R function: seqHMM plot.mhmm()
  • Mapping note: Sequenzo uses matplotlib heatmaps; R uses igraph-based layouts per cluster.

Notes

  • Model must be fitted before plotting.
  • For single HMM graphs, use plot_hmm().

Authors

Code: Yuqi Liang

Documentation: Yuqi Liang

References

Helske, S., & Helske, J. (2019). Mixture hidden Markov models for sequence data: The seqHMM package in R. Journal of Statistical Software, 88(3), 1–32.