class eelbrain.plot.Boxplot(y, x=None, match=None, sub=None, cells=None, test=True, tail=0, par=True, corr='Hochberg', trend=False, test_markers=True, bottom=None, top=None, xlabel=True, ylabel=True, labels=None, xticks=True, xtick_delim='\n', xtick_rotation=None, colors=False, data=None, label_fliers=False, **kwargs)

Boxplot for a continuous variable

  • y (Var | str) – Dependent variable.

  • x (Factor | Interaction | NestedEffect | str) – Category definition (draw one box for every cell in x).

  • match (Factor | Interaction | NestedEffect | str) – Match cases for a repeated measures design.

  • sub (Var | ndarray | str) – Use a subset of the data.

  • cells (Sequence[str | Tuple[str, ...]]) – Cells to plot (optional). All entries have to be cells of x). Can be used to change the order of the bars or plot only certain cells.

  • test (bool | scalar) – True (default): perform pairwise tests; False: no tests; scalar: 1-sample tests against this value.

  • tail (Literal[-1, 0, 1]) – Tailedness of the test (when testing against population mean).

  • par (bool) – Use parametric test for pairwise comparisons (use non-parametric tests if False).

  • corr (bool | Literal['hochberg', 'bonferroni', 'holm']) – Method for multiple comparison correction (default ‘hochberg’).

  • trend (bool | str) – Marker for a trend in pairwise comparisons.

  • test_markers (bool) – For pairwise tests, plot markers indicating significance level (stars).

  • bottom (float) – Lowest possible value on the y axis (default is 0 or slightly below the lowest value).

  • top (float) – Set the upper x axis limit (default is to fit all the data).

  • xlabel (bool | str) – X-axis label. By default the label is inferred from the data.

  • ylabel (bool | str) – Y-axis label. By default the label is inferred from the data.

  • labels (Dict[str | Tuple[str, ...], str]) – Labels for cells as {cell: label} dictionary.

  • xticks (bool | Dict[str | Tuple[str, ...], str] | Sequence[str]) – X-axis tick labels. The default is to use the cell names from x. Can be specified as list of labels or as {cell: label} dict, or set to False to plot no labels.

  • xtick_delim (str) – Delimiter for x axis category descriptors (default is '\n', i.e. the level on each Factor of x on a separate line).

  • xtick_rotation (float | str) – Tick label orientation – 'vertical' 'horizontal' or an angle.

  • colors (bool | sequence | dict of matplitlib colors) – Matplotlib colors to use for boxes (True to use the module default; default is False, i.e. no colors).

  • data (Dataset) – If a Dataset is specified, all data-objects can be specified as names of Dataset variables

  • label_fliers (bool) – Add labels to flier points (outliers); requires match to be specified.

  • ... – Also accepts General layout parameters and boxplot() parameters.


add_hline(y[, axes])

Draw a horizontal line on one or more axes

add_hspan(bottom, top[, axes])

Draw a horizontal bar on one or more axes

add_vline(x[, axes])

Draw a vertical line on one or more axes

add_vspan(xmin, xmax[, axes])

Draw a vertical bar on one or more axes


Close the figure.


(Re-)draw the figure (after making manual changes).


Draw crosshairs under the cursor


Draw the outline of the figure


image([name, format, close])

Create FMTXT Image from the figure

mark_pair(cell_1, cell_2, y[, dy, mark, ...])

Mark a pair of categories with a line and a label

save(*args, **kwargs)

Short-cut for Matplotlib's savefig()


Set the figure window title

set_xlabel(label[, ax])

Set the label for the x-axis


Rotate every x-axis tick-label by an angle (counterclockwise, in degrees)

set_ylabel(label[, ax])

Set the label for the y-axis

set_ylim([bottom, top])

Set the y-axis limits