mne_denoise.viz.plot_asr_calibration_fraction#

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

Bar chart of the clean calibration fraction for one or more estimators.

Compares how much of the candidate calibration data was retained as clean reference material. For standard ASR this is the fraction of clean windows; for JugglerASR it is the fraction of clean samples selected by DBSCAN or GEV. Too small a fraction suggests the cutoff or data quality needs adjustment.

Parameters:

  • estimators (fitted estimator | list of fitted estimators) – One or more fitted ASR-family estimators. Each contributes one bar extracted from its calibration_info_ attribute.

  • labels (list of str | None, default=None) – Bar labels. If None, defaults to the class name of each estimator.

  • title (str | None, default=None) – Custom title for the plot. If None, uses a sensible default.

  • 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 bar chart.