mne_denoise.viz.plot_asr_repair_timeline#

mne_denoise.viz.plot_asr_repair_timeline(estimator, *, title: str | None = None, ax=None, show: bool = True, fname: str | None = None)[source]#

Plot the per-window count of reconstructed components over time.

Visualizes whether ASR surgically repaired isolated bursts (sparse activity is good) or modified a large portion of the recording (potential over-cleaning). The data is read from the fitted estimator’s diagnostics_ attribute.

Parameters:

  • estimator (ASR | AdaptiveASR | JugglerASR) – A fitted estimator that has been used to transform data, so that diagnostics_ is populated.

  • title (str | None, default=None) – Custom title for the plot. If None, an auto-generated title showing the percentage of modified windows is used.

  • ax (matplotlib.axes.Axes | None, default=None) – Axes to plot into. If None, a new themed figure is created.

  • show (bool, default=True) – Whether to call plt.show() after plotting.

  • fname (str | None, default=None) – If provided, the figure is saved to this file path.

Returns:

  • fig (matplotlib.figure.Figure) – The figure containing the plot.

  • ax (matplotlib.axes.Axes) – The axes with the repair timeline.

Raises:

ValueError – If the estimator has no transform diagnostics or if diagnostics contain no processing windows.