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 列表传入。每个组可以通过向 lineoffsetslinelengthslinewidthscolorslinestyles 传递值列表来独立设置样式。

请注意,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,如果 sdata 中的一个键,则解释为 data[s]

positions, lineoffsets, linelengths, linewidths, colors, linestyles

**kwargs

其他关键字参数是线条集合属性。有关有效属性列表,请参见 LineCollection

返回:
EventCollection 列表

已添加的 EventCollection

备注

注意

这是 pyplot 封装器,用于 axes.Axes.eventplot

对于 linelengthslinewidthscolorsalphalinestyles,如果只给出了一个值,则该值将应用于所有线条。如果给出了 array-like,则其长度必须与 positions 的长度相同,每个值将应用于数组的相应行。

示例

源代码2x.pngpng