eelbrain.plot.TopomapBins

class eelbrain.plot.TopomapBins(y, xax=None, ds=None, sub=None, bin_length=0.05, tstart=None, tstop=None, vmax=None, vmin=None, cmap=None, contours=None, proj='default', res=None, interpolation=None, clip='even', clip_distance=0.05, head_radius=None, head_pos=0, im_interpolation=None, sensorlabels=None, mark=None, mcolor=None, **kwargs)

Topomaps in time-bins

Parameters
  • y ((list of) NDVar, dims = ([case,] sensor, time)) – Data to plot.

  • xax (None | categorial) – Create a separate plot for each cell in this model.

  • ds (Dataset) – If a Dataset is provided, data can be specified as strings.

  • sub (str | array) – Specify a subset of the data.

  • vmax (scalar) – Upper limits for the colormap (default is determined from data).

  • vmin (scalar) – Lower limit for the colormap (default -vmax).

  • cmap (str) – Colormap (default depends on the data).

  • contours (int | sequence | dict) – Contours to draw on topomaps. Can be an int (number of contours, including vmin/vmax), a sequence (values at which to draw contours), or a **kwargs dict (must contain at least the “levels” key). Default is no contours.

  • proj (str) – The sensor projection to use for topomaps.

  • res (int) – Resolution of the topomaps (width = height = res).

  • interpolation ('nearest' | 'linear' | 'spline') – Method for interpolating topo-map between sensors (default is based on mne-python).

  • clip (bool | 'even' | 'circle') – Outline for clipping topomaps: ‘even’ to clip at a constant distance (default), ‘circle’ to clip using a circle.

  • clip_distance (scalar) – How far from sensor locations to clip (1 is the axes height/width).

  • head_radius (scalar | tuple) – Radius of the head outline drawn over sensors (on sensor plots with normalized positions, 0.45 is the outline of the topomap); 0 to plot no outline; tuple for separate (right, anterior) radius. The default is determined automatically.

  • head_pos (scalar) – Head outline position along the anterior axis (0 is the center, 0.5 is the top end of the plot).

  • im_interpolation (str) – Topomap image interpolation (see Matplotlib’s imshow()). Matplotlib 1.5.3’s SVG output can’t handle uneven aspect with interpolation='none', use interpolation='nearest' instead.

  • sensorlabels ('none' | 'index' | 'name' | 'fullname') – Show sensor labels. For ‘name’, any prefix common to all names is removed; with ‘fullname’, the full name is shown.

  • mark (Sensor index) – Sensors which to mark.

  • mcolor (matplotlib color) – Color for marked sensors.

  • .. – Also accepts General layout parameters.

Notes

Keys:
  • t: open a Topomap plot for the map under the mouse pointer.

  • T: open a larger Topomap plot with visible sensor names for the map under the mouse pointer.

Methods

add_contour(level[, color, meas])

Add a contour line

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()

Close the figure.

draw()

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

draw_crosshairs([enable])

Draw crosshairs under the cursor

get_vlim([meas])

Retrieve colormap value limits as (vmin, vmax) tuple

image([name, format, close])

Create FMTXT Image from the figure

mark_sensors(sensors[, axis, s, c, marker])

Mark given sensors on the plots

plot_colorbar([label, label_position, …])

Plot a colorbar corresponding to the displayed data

save(*args, **kwargs)

Short-cut for Matplotlib’s savefig()

separate_labels([pad])

Move overlapping labels apart along the x axis

set_cmap(cmap[, meas])

Change the colormap in the array plots

set_label_color([color])

set_label_text([text])

Add/remove sensor labels

set_name(name)

Set the figure window title

set_vlim([v, vmax, meas])

Change the colormap limits

set_xlabel(label[, ax])

Set the label for the x-axis

set_xtick_rotation(rotation)

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

set_ylabel(label[, ax])

Set the label for the y-axis