matplotlib.axes.Axes.eventplot#

Axes.eventplot(positions, *, orientation='horizontal', lineoffsets=1, linelengths=1, linewidths=None, colors=None, alpha=None, linestyles='solid', data=None, **kwargs)[源代码][源代码]#

在给定位置绘制相同且平行的线条。

这种类型的图在神经科学中常用于表示神经事件,通常称为尖峰栅格、点栅格或栅格图。

然而,在你希望展示多组离散事件的时间或位置的任何情况下,它都是有用的,例如每个月每天人们到达企业的到达时间,或上个世纪每年飓风的日期。

参数:
职位类数组或类数组列表

一维类数组定义了一个事件序列的位置。

多个事件组可以作为类似数组的列表传递。每个组可以通过向 lineoffsetslinelengthslinewidthscolorslinestyles 传递值的列表来独立设置样式。

请注意,positions 可以是一个二维数组,但在实际操作中,不同的活动组通常有不同的计数,因此通常会使用不同长度的数组列表,而不是一个二维数组。

方向{'horizontal', 'vertical'}, 默认: 'horizontal'

事件序列的方向:

  • 'horizontal': 事件是水平排列的。指示线是垂直的。

  • 'vertical': 事件垂直排列。指示线是水平的。

lineoffsets浮点数或类似数组的对象,默认值:1

线条中心相对于原点的偏移量,方向与 orientation 垂直。

如果 positions 是二维的,这可以是一个与 positions 长度匹配的序列。

行长度浮点数或类似数组的对象,默认值:1

线条的总高度(即线条从 lineoffset - linelength/2 延伸到 lineoffset + linelength/2)。

如果 positions 是二维的,这可以是一个与 positions 长度匹配的序列。

linewidths : float 或 array-like, 默认值: rcParams["lines.linewidth"] (default: 1.5)浮点数或类数组,默认值:

事件线的线宽,以点为单位。

如果 positions 是二维的,这可以是一个与 positions 长度匹配的序列。

颜色 : color 或颜色列表,默认值: rcParams["lines.color"] (default: 'C0')颜色或颜色列表,默认值:rcParams["lines.color"](默认值:'C0')

事件线的颜色。

如果 positions 是二维的,这可以是一个与 positions 长度匹配的序列。

alpha浮点数或类似数组的对象,默认值:1

阿尔法混合值,介于0(透明)和1(不透明)之间。

如果 positions 是二维的,这可以是一个与 positions 长度匹配的序列。

线型str 或 tuple 或此类值的列表,默认值:'solid'

默认值为 'solid'。有效字符串包括 ['solid', 'dashed', 'dashdot', 'dotted', '-', '--', '-.', ':']。虚线元组应为以下形式:

(offset, onoffseq),

其中 onoffseq 是一个偶数长度的元组,包含点和点的墨水开关。

如果 positions 是二维的,这可以是一个与 positions 长度匹配的序列。

数据可索引对象,可选

如果给出,以下参数还接受一个字符串 s,如果 sdata 中的一个键,则解释为 data[s]

positions, lineoffsets, linelengths, linewidths, colors, linestyles

**kwargs

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

返回:
EventCollection 的列表

添加的 EventCollection

注释

对于 linelengthslinewidthscolorsalphalinestyles,如果只给出一个值,该值将应用于所有线条。如果给出一个类似数组的对象,它必须与 positions 的长度相同,并且每个值将应用于数组的相应行。

示例

(Source code, 2x.png, png)

使用 matplotlib.axes.Axes.eventplot 的示例#

eventplot(D)

eventplot(D)