mne_denoise.viz.plot_metric_violins

mne_denoise.viz.plot_metric_violins(data, metric_cols, metric_labels=None, group_col='group', subject_col='subject', group_order=None, group_colors=None, group_labels=None, baseline_group=None, reference_lines=None, show_paired=True, suptitle=None, figsize=None, fname=None, show=True)

Plot violin + strip distributions with optional paired subject lines.

Parameters:

datamapping of str to array-like

Columnar mapping with group/subject columns and one or more metrics.

metric_colslist of str

Metric columns to render.

metric_labelslist of str | None

Labels corresponding to metric_cols.

group_colstr

Grouping column name.

subject_colstr

Subject identifier column name.

group_orderlist of str | None, default=None

Optional group order. If None, first-seen order is used.

group_colorsdict | None, default=None

Optional color overrides keyed by group.

group_labelsdict | None, default=None

Optional display-label overrides keyed by group.

baseline_groupstr | None, default=None

Optional group used to draw a baseline mean line.

reference_linesdict | None

Optional horizontal reference lines per metric.

show_pairedbool, default=True

Whether to draw subject-level paired lines.

suptitlestr | None, default=None

Figure-level title.

figsizetuple | None, default=None

Figure size in inches. Defaults to (4 * n_metrics, 5.5).

fnamepath-like | None, default=None

Optional output path.

showbool, default=True

Whether to display the figure.

Returns:

figmatplotlib.figure.Figure

Figure handle.

Raises:

ImportError

If seaborn is unavailable.