class eelbrain.plot.Regression(y, x, cat=None, match=None, sub=None, data=None, xlabel=True, ylabel=True, alpha=0.2, legend=None, labels=None, c=('#009CFF', '#FF7D26', '#54AF3A', '#FE58C6', '#20F2C3'), **kwargs)

Plot the regression of y on x

  • y (Var | str) – Variable for the y-axis.

  • x (Var | str) – Variable for the x-axis.

  • cat (Factor | Interaction | NestedEffect | str) – Plot the regression separately for different categories.

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

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

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

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

  • alpha (float) – alpha for individual data points (to control visualization of overlap)

  • legend (str | int | Tuple[float, float] | bool | None) – Matplotlib figure legend location argument or ‘fig’ to plot the legend in a separate figure.

  • labels (dict) – Alternative labels for legend as {cell: label} dictionary (preserves order).

  • c (color | sequence of colors) – Colors.

  • tight (bool) – Use matplotlib’s tight_layout to expand all axes to fill the figure (default True)

  • ... – Also accepts General layout 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

plot_legend([loc, labels])

Plot the legend (or remove it from the figure).

save(*args, **kwargs)

Short-cut for Matplotlib's savefig()

save_legend(*args, **kwargs)

Save the legend as image file


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