PLOTTOPO Plot concatenated multichannel data epochs in a topographic or rectangular array. Uses a channel location file with the same format as topoplot(), or else plots data on a rectangular grid. If data are all positive, they are assumed to be spectra.


Usage: >> plottopo(data, 'key1', 'val1', 'key2', 'val2')
>> plottopo(data,'chan_locs') % old function call
>> plottopo(data,[rows cols]) % old function call
>> plottopo(data,'chan_locs',frames,limits,title,channels, axsize,colors,ydir,vert) % old function call

Inputs:
data   
data consisting of consecutive epochs of (chans,frames) or (chans,frames,n)

Optional inputs:
'chanlocs'   
[struct] channel structure or file plot ERPs at channel locations. See help readlocs() for data channel format.
'geom'   
[rows cols] plot ERP in grid (overwrite previous option). Grid size for rectangular matrix. Example: [6 4].
'frames'   
time frames (points) per epoch {def|0 -> data length}
'limits'   
[xmin xmax ymin ymax] (x's in ms or Hz) {def|0 (or both y's 0) -> use data limits)
'ylim'   
[ymin ymax] y axis limits. Overwrite option above.
'title'   
[string] plot title {def|'' -> none}
'chans'   
vector of channel numbers to plot {def|0 -> all}
'axsize'   
[x y] axis size {default [.07 .07]}
'legend'   
[cell array] cell array of string for the legend. Note the last element can be an integer to set legend position.
'showleg'   
['on'|'off'] show or hide legend.
'colors'   
[cell array] cell array of plot aspect. E.g. { 'k' 'k--' } for plotting the first curve in black and the second one in black dashed. Can also contain additional formating. { { 'k' 'fontweight' 'bold' } 'k--' } same as above but the first line is bolded.
'ydir'   
[1|-1] y-axis polarity (pos-up = 1; neg-up = -1) {def -> 1}
'vert'   
[vector] of times (in ms or Hz) to plot vertical lines {def none}
'regions'   
[cell array] cell array of size nchan. Each cell contains a float array of size (2,n) each column defining a time region [low high] to be highlighted.
'axsize'   
[x y] axis size {default [.07 .07]}

Author: Scott Makeig and Arnaud Delorme, SCCN/INC/UCSD, La Jolla, 3-2-98

See also: plotdata, topoplot()

See the matlab file plottopo.m (may require other functions)

Back to functions