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]#
在给定位置绘制相同的平行线。
这种类型的图表常用于神经科学中表示神经事件，通常被称为脉冲栅格图、点栅格图或栅格图。
然而，它在任何需要显示多组离散事件的时间或位置的情况下都很有用，例如人们在一个月内每天到达企业的时间，或上世纪每年飓风发生的日期。
- 参数:
- 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 相同，并且每个值将应用于数组的相应行。
示例
