EEGLAB工具箱中topoplot()函数使用方法

EEGLAB工具箱中topoplot()函数使用方法

1解释：

在精细笛卡尔网格上使用插值在二维圆形视图（俯视头顶）中绘制头皮数据字段的地形图。还可以显示指定的通道位置，或在任意头皮位置返回内插值（参见“noplot”）。

默认情况下，头部中心以下的通道位置（arc_length 0.5）显示在卡通头部外的“裙子”中（参见下面的“plotrad”和“headrad”选项）。鼻子在情节的顶部；左边是左边；右边就是右边。

使用选项 'plotgrid'，绘图可以是一个或多个矩形网格。

2用法：

>>topoplot(datavector, EEG.chanlocs);  % 使用 EEG chanlocs 结构绘制地图

>> topoplot(datavector, 'my_chan.locs'); % 读取通道位置文件并绘制地图

>> topoplot('example');  % 给出一个电极位置文件的例子

>>[h grid_or_val plotrad_or_grid, xmesh, ymesh]=topoplot(datavector, chan_locs, 'Input1','Value1', ...);

3必需的输入：

参数	解释	示例/备注
datavector	通道的值的单个向量。或者，如果选定子集的向量(int) channel numbers ->使用“style”“blank”标记它们的位置。
chan_locs	EEG电极位置文件的名称，或者，一个 EEG.chanlocs 结构。	（示例：>>  topoplot example）。 （示例：>> help readlocs 或 >> topoplot example）

4可选输入：

 4.1：'maplimits'

参数	可选项	解释
'maplimits'	'absmax'	将地图颜色缩放到 +/- 绝对最大值（使绿色为 0）； 默认值：'absmax'
	'maxmin'	将颜色缩放到数据范围（使绿色中间范围）；
	[lo.hi]	使用用户定义的 lo/hi 限制

 4.2：'style'

参数	可选项	解释
'style'	'map'	仅绘制彩色地图
	'contour'	只绘制等高线
	'both'	绘制彩色地图和等高线
	'fill'	在等高线之间绘制恒定颜色
	'blank'	仅绘制电极位置 {default: 'both'}

4.3：'electrodes'

参数	可选项	解释
'electrodes'	'on','off','labels','numbers','ptslabels','ptsnumbers'	设置“pts”标记，请参阅下面的“绘图细节选项(Plot detail options:)”。 {默认值：'on' -> 标记电极带点 ('.') 的位置，若超过 64 个通道，则默认是 'off'}。

4.4'plotchans'

参数	可选项	解释
'plotchans'		[vector] 通道号（索引）用于制作头部图。  {默认值：[] -> 绘制所有通道}

4.5'chantype'

  'chantype'- 要绘制的通道类型的元胞数组。也将接受单引号字符串类型。通道 k 的通道类型是字段 EEG.chanlocs(k).type。

如果存在，则使用字段覆盖“plotchans”和“chaninfo”''chantype''。例子： 'EEG' or {'EEG','EOG'} {default: all, or 'plotchans' arg}。

If present, overrides 'plotchans' and also 'chaninfo' with field 'chantype'. Ex. 'EEG' or {'EEG','EOG'} {default: all, or 'plotchans' arg}。

4.6 'plotgrid'

 'plotgrid'   [channels] 在一个或多个矩形网格中绘制通道数据，如由 [channels] 指定，一个定义了通道编号的位置矩阵网格中通道的地形位置。零值是给定图形背景颜色；负整数，颜色极性反转通道值。

例如：>>  figure; topoplot(values,'chanlocs','plotgrid',[11 12 0; 13 14 15]);

% 绘制一个 (2,3) 来自通道 11-15 的数据值网格，其中一个为空网格单元（右上角）{默认：no grid plot}

4.7：'nosedir'

 - ['+X'|'-X'|'+Y'|'-Y'] 鼻子的方向 {默认：'+X'}

4.8：'chaninfo'

 [struct] 包含字段 'nosedir'、'plotrad' 的可选结构和/或“chantype”。请参阅上面和下面的这些（单独的）字段定义

{默认：nosedir +X，plotrad 0.5，所有通道}

4.9：'plotrad'

[0.15<=float<=1.0] 绘制半径 = 要绘制的最大通道 arc_length。请参见 >> 地形图示例。如果 plotrad > 0.5，则 arc_length > 0.5（即耳朵下方）被绘制在一个圆形的“裙子”外面卡通头。请参阅下面的“内部”。

{默认值：max(max(chanlocs.radius),0.5);如果 chanlocs 结构包含一个字段 chanlocs.plotrad，它的值是默认值}。

4.10：'headrad'

[0.15<=float<=1.0] 卡通头部的绘制半径（arc_length）。

注意：只有 headrad = 0.5 在解剖学上是正确的！ 0 -> 不要画头；'rim' -> 在图的外边缘显示卡通头 {default: 0.5}

4.11：'intrad'

[0.15<=float<=1.0] 头皮图插值区域的半径（正方形或磁盘，请参阅下面的“intsquare”）。在该区域插入电极并使用限制定义头皮图插值数据矩阵的边界

{默认：最大频道位置半径}

4.12：'intsquare'

['on'|'off'] 'on' -> 在位于整体的电极处插入值包含（内半径）插值圆盘的正方形； '关闭' -> 插值仅在插值盘中显示的电极值

{default: 'on'}。

4.13： 'conv'

 ['on'|'off'] 仅显示到凸包的地图插值电极位置以最小化外推。使用此选项 ['on'] 时绘制 pvalues

{default: 'off'}

4.14：'noplot'

 ['on'|'off'|[rad theta]] 不绘制（但返回插值数据）。或者，如果 [rad theta] 是（可能丢失的）通道的坐标返回通道位置的内插值。欲了解更多信息，参见 >> 地形图“示例”

{默认值：“关闭”}

4.15：'verbose'

 ['on'|'off'] 对命令行操作的注释

{default: 'on'}。

5 ’Plot detail options’(绘图细节选项)：

参数	解释	默认
'drawaxis'	- ['on'|'off'] 在左上角绘制轴。
'emarker'	Matlab 标记字符 | {markerchar color size linewidth} char, else 元胞数组指定电极“pts”标记。例如：{'s','r',32,1} -> 32 点立体红方格。	{default: {'.','k',[],1} 其中标记大小 ([]) 取决于数字绘制的通道数}。
'emarker2'	{markchans}|{markchans 标记颜色大小 linewidth} 元胞数组指定指定“plotchans”的替代标记。例如：{[3 17],'s','g'}	{default: none, or if {markchans} only is specified,then {markchans,'o','r',10,1}}
'hcolor'	卡通头像的颜色。使用 'hcolor','none' 绘制无头。	{默认值：'k' = 黑色}
'shading'	'flat','interp'	{default: 'flat'}
'numcontour'	等高线的数量	{default: 6}
'contourvals'	- 轮廓值	{默认：与输入值相同}
'pmask'	掩蔽地形图的值。与输入大小相同的零和 1 数组值数组	{默认值：[]}
'color'	轮廓的颜色	{默认：深灰色}
'whitebk'	('on'|'off') 使背景颜色为白色（例如，打印空的 plotgrid 通道）	{默认值：'关闭'}
'gridscale'	[int > 32] 内插头皮图数据矩阵的大小（nrows）	{默认值：67}
'colormap'	(n,3) 任何大小的颜色图	{default: existing colormap}
'circgrid'	[int > 100] 头部和边框圆圈中的元素（角度）数{201}
'emarkercolor'	'blank' 选项的颜色元胞数组。
'plotdisk'	['on'|'off'] 为“空白”选项绘制磁盘而不是电极的点。磁盘大小由每个电极的输入值控制。如果提供虚数值，绘制部分圆圈，红色代表实数值，蓝色代表虚数值。

   

6 ‘Dipole plotting options’偶极绘图选项：

参数	解释	示例
'dipole'	- [xi yi xe ye ze] 在头皮图的顶部绘制偶极子从坐标 (xi,yi) 到坐标 (xe,ye,ze)（偶极头模型的半径为 1)。如果有多行，则每行绘制一个偶极子。可以使用 dipplot() 返回的坐标。可以接受一个 EEG.dipfit.model 结构（参见 >> help dipplot）。	例如：,'dipole',EEG.dipfit.model(17) % Plot dipole(s) for comp. 17.
'dipnorm'	['on'|'off'] 标准化偶极子长度	{default: 'on'}。
'diporient'	- [-1|1] 反转偶极子方向	{default: 1}。
'diplen'	- [real] 标度偶极子长度	{default: 1}。
'dipscale'	- [真实] 比例偶极子尺寸	{默认值：1}。
'dipsphere'	偶极球的 [真实] 大小。	{默认值：85 毫米}。
'dipcolor'	[color] 偶极子颜色作为 Matlab 代码代码或 [r g b] 向量	{默认值：'k' = 黑色}。

7 输出：

7.1handle

彩色表面的句柄。如果只绘制轮廓，然后是句柄对方组。 （如果没有绘制曲面或轮廓，返回“gca”，当前图的句柄）。

7.2 grid_or_val

 [矩阵] 插值数据图像（头外点 = NaN）。或者，指定 'noplot' arg 通道的单个内插值位置（[rad theta]），如果有的话。

7.3 plotrad_or_grid

 如果上面返回网格图像，那么网格的“plotrad”半径。或者，网格图像。

7.4 xmesh, ymesh

返回网格的 x 和 y 值（上图）。

8 Chan_locs format：

 参见 >>     topoplot 'example'

9 Examples:

仅绘制通道位置：

>>figure；topoplot([],EEG.chanlocs,'style','blank','electrodes','labelpoint','chaninfo',EEG.chaninfo);

   注意： - 要将绘图地图遮罩环更改为新的图形背景颜色，

              >> set(findobj(gca,'type','patch'),'facecolor',get(gcf,'color'))

          - 可以旋转地形图。 从命令行 >> view([deg 90]) {default: [0 90])

          - 绘制 pvalues 时，请确保使用选项 'conv' 以最小化外推效应