This content refers to an unreleased development version of PyMVPA

To provide the most recent news and documentation www.pymvpa.org reflects the development 0.6 series of PyMVPA. If you are interested in the documentation of the previous stable 0.4 series of PyMVPA, please visit v04.pymvpa.org.

mvpa.misc.plot.topo.plot_head_topography

mvpa.misc.plot.topo.plot_head_topography(topography, sensorlocations, plotsensors=False, resolution=51, masked=True, plothead=True, plothead_kwargs=None, **kwargs)

Plot distribution to a head surface, derived from some sensor locations.

The sensor locations are first projected onto the best fitting sphere and finally projected onto a circle (by simply ignoring the z-axis).

Parameters :

topography : array

A vector of some values corresponding to each sensor.

sensorlocations : (nsensors x 3) array

3D coordinates of each sensor. The order of the sensors has to match with the topography vector.

plotsensors : bool

If True, sensor will be plotted on their projected coordinates. No sensor are shown otherwise.

plothead : bool

If True, a head outline is plotted.

plothead_kwargs : dict

Additional keyword arguments passed to plot_head_outline().

resolution : int

Number of surface samples along both x and y-axis.

masked : bool

If True, all surface sample extending to head outline will be masked.

**kwargs :

All additional arguments will be passed to pylab.imshow().

Returns :

(map, head, sensors) :

The corresponding matplotlib objects are returned if plotted, ie. if plothead is set to False, head will be None.

map

The colormap that makes the actual plot, a matplotlib.image.AxesImage instance.

head

What is returned by plot_head_outline().

sensors

The dots marking the electrodes, a matplotlib.lines.Line2d instance.