matplotlib.pyplot.eventplot#
- matplotlib.pyplot.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） 事件线的线宽，单位为点（points）。
如果 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
其他关键字参数为线集合（line collection）属性。有关有效属性列表，请参阅
LineCollection。
- 返回:
EventCollection列表所添加的
EventCollection。
备注
注意
这是 pyplot 包装器，用于
axes.Axes.eventplot。对于 linelengths、linewidths、colors、alpha 和 linestyles，如果仅提供单个值，则该值将应用于所有线条。如果提供类数组，则其长度必须与 positions 相同，且每个值将应用于数组的相应行。
示例
