matplotlib.axes.Axes.eventplot#
- Axes.eventplot(positions, *, orientation='horizontal', lineoffsets=1, linelengths=1, linewidths=None, colors=None, alpha=None, linestyles='solid', data=None, **kwargs)[源代码][源代码]#
在给定位置绘制相同且平行的线条。
这种类型的图在神经科学中常用于表示神经事件,通常称为尖峰栅格、点栅格或栅格图。
然而,在你希望展示多组离散事件的时间或位置的任何情况下,它都是有用的,例如每个月每天人们到达企业的到达时间,或上个世纪每年飓风的日期。
- 参数:
- 职位类数组或类数组列表
一维类数组定义了一个事件序列的位置。
多个事件组可以作为类似数组的列表传递。每个组可以通过向 lineoffsets、linelengths、linewidths、colors 和 linestyles 传递值的列表来独立设置样式。
请注意,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
,如果s
是data
中的一个键,则解释为data[s]
:positions, lineoffsets, linelengths, linewidths, colors, linestyles
- **kwargs
其他关键字参数是线条集合属性。有关有效属性的列表,请参见
LineCollection
。
- 返回:
EventCollection
的列表添加的
EventCollection
。
注释
对于 linelengths、linewidths、colors、alpha 和 linestyles,如果只给出一个值,该值将应用于所有线条。如果给出一个类似数组的对象,它必须与 positions 的长度相同,并且每个值将应用于数组的相应行。
示例
(
Source code
,2x.png
,png
)