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)。
但是,它在任何需要显示多组离散事件的时间或位置的情况下都很有用,例如某个月份每天到达某个企业的人数,或者上世纪每年飓风的日期。
- 参数:
- positionsarray-like 或 array-like 列表
一个一维 array-like 定义了一系列事件的位置。
多个事件组可以作为 array-like 列表传入。每个组可以通过向 lineoffsets、linelengths、linewidths、colors 和 linestyles 传递值列表来独立设置样式。
请注意,positions 可以是二维数组,但实际上不同的事件组通常具有不同的计数,因此会使用不同长度的数组列表而不是二维数组。
- orientation{'horizontal', 'vertical'},默认值: 'horizontal'
事件序列的方向
'horizontal':事件水平排列。指示线垂直。
'vertical':事件垂直排列。指示线水平。
- lineoffsets浮点数或 array-like,默认值:1
线段中心距原点的偏移量,方向与 orientation 正交。
如果 positions 是二维的,这可以是一个与 positions 长度匹配的序列。
- linelengths浮点数或 array-like,默认值:1
线段的总高度(即线段从
lineoffset - linelength/2
延伸到lineoffset + linelength/2
)。如果 positions 是二维的,这可以是一个与 positions 长度匹配的序列。
- linewidths浮点数或 array-like,默认值:
rcParams["lines.linewidth"]
(默认值:1.5
) 事件线的线宽(单位:点)。
如果 positions 是二维的,这可以是一个与 positions 长度匹配的序列。
- colors颜色 或颜色列表,默认值:
rcParams["lines.color"]
(默认值:'C0'
) 事件线的颜色。
如果 positions 是二维的,这可以是一个与 positions 长度匹配的序列。
- alpha浮点数或 array-like,默认值: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
。
备注
注意
这是 pyplot 封装器,用于
axes.Axes.eventplot
。对于 linelengths、linewidths、colors、alpha 和 linestyles,如果只给出了一个值,则该值将应用于所有线条。如果给出了 array-like,则其长度必须与 positions 的长度相同,每个值将应用于数组的相应行。
示例