matplotlib.axes.Axes.eventplot#
- Axes.eventplot(positions, *, orientation='horizontal', lineoffsets=1, linelengths=1, linewidths=None, colors=None, alpha=None, linestyles='solid', data=None, **kwargs)[source]#
在给定位置绘制相同的平行线。
这种绘图方式常用于神经科学中表示神经事件，通常被称为脉冲光栅图 (spike raster)、点光栅图 (dot raster) 或光栅图 (raster plot)。
然而，在任何需要展示多组离散事件的时间或位置的场景中，它都非常有用，例如每个月某项业务的访客到达时间，或者上个世纪每年飓风发生的日期。
- 参数:
- positions类数组或类数组列表
一维类数组定义了一系列事件的位置。
可以通过类数组列表传入多组事件。通过向 lineoffsets、linelengths、linewidths、colors 和 linestyles 传递数值列表，可以分别为每组事件设置样式。
注意，positions 可以是二维数组，但在实践中，不同的事件组通常具有不同的计数，因此通常使用长度不同的数组列表，而不是二维数组。
- orientation{'horizontal', 'vertical'}，默认值: 'horizontal'
事件序列的方向
'horizontal'（水平）：事件水平排列。指示线为垂直方向。
'vertical'（垂直）：事件垂直排列。指示线为水平方向。
- lineoffsets浮点数或类数组，默认值：1
线条中心距原点的偏移量，方向与 orientation 正交。
如果 positions 是二维的，则该参数可以是一个长度与 positions 长度匹配的序列。
- linelengths浮点数或类数组，默认值：1
线条的总高度（即线条从
lineoffset - linelength/2延伸至lineoffset + linelength/2）。如果 positions 是二维的，则该参数可以是一个长度与 positions 长度匹配的序列。
- linewidths浮点数或类数组对象，默认：
rcParams["lines.linewidth"]（默认：1.5） 事件线条的线宽（以点为单位）。
如果 positions 是二维的，则该参数可以是一个长度与 positions 长度匹配的序列。
- colors颜色 或颜色列表，默认值：
rcParams["lines.color"](默认:'C0') 事件线条的颜色。
如果 positions 是二维的，则该参数可以是一个长度与 positions 长度匹配的序列。
- alpha浮点数或类数组，默认值：1
Alpha 透明度值，介于 0（透明）和 1（不透明）之间。
如果 positions 是二维的，则该参数可以是一个长度与 positions 长度匹配的序列。
- linestyles字符串、元组或此类值的列表，默认值：'solid'
默认值为 'solid'。有效的字符串包括 ['solid', 'dashed', 'dashdot', 'dotted', '-', '--', '-.', ':']。虚线元组应采用特定格式。
(offset, onoffseq),
其中 onoffseq 是一个偶数长度的元组，表示点中的开/关墨迹。
如果 positions 是二维的，则该参数可以是一个长度与 positions 长度匹配的序列。
- data可索引对象，可选
如果给定，以下参数也接受字符串
s，如果s是data中的键，则将其解释为data[s]。positions、lineoffsets、linelengths、linewidths、colors、linestyles
- **kwargs
其他关键字参数为线集合属性。有关有效属性的列表，请参阅
LineCollection。
- 返回:
EventCollection列表已添加的
EventCollection。
备注
对于 linelengths、linewidths、colors、alpha 和 linestyles，如果只提供单个值，则该值应用于所有线条。如果提供类数组，其长度必须与 positions 相同，并且每个值将应用于数组的对应行。
示例
