matplotlib.axes.Axes.eventplot
-
Axes.eventplot(positions, orientation='horizontal', lineoffsets=1, linelengths=1, linewidths=None, colors=None, linestyles='solid', *, data=None, **kwargs)[source] -
Отображает идентичные параллельные линии в заданных позициях.
positions должна быть 1D или 2D массивоподобным объектом, где каждая строка соответствует строке или столбцу линий.
Этот тип графика часто используется в нейронауке для представления нейронных событий, где он обычно называется растром импульсов, растром точек или растровым графиком.
Однако он полезен в любой ситуации, где вы хотите показать временную шкалу или положение нескольких наборов дискретных событий, таких как время прибытия людей в бизнес каждый день месяца или дата ураганов каждый год прошлого столетия.
Параметры: -
positions : 1D or 2D array-like object -
Каждое значение — событие. Если positions — 2D массивоподобный объект, каждая строка соответствует строке или столбцу линий (в зависимости от параметра orientation).
-
orientation : {'horizontal', 'vertical'}, optional -
Управляет направлением коллекций событий:
- 'horizontal' : линии выстраиваются горизонтально по строкам, и являются вертикальными.
- 'vertical' : линии выстраиваются вертикально по столбцам, и являются горизонтальными.
-
lineoffsets : scalar or sequence of scalars, optional, default: 1 -
Смещение центра линий от начала координат в направлении, перпендикулярном orientation.
-
linelengths : scalar or sequence of scalars, optional, default: 1 -
Полная высота линий (т.е. линии простираются от
lineoffset - linelength/2доlineoffset + linelength/2). -
linewidths : scalar, scalar sequence or None, optional, default: None -
Толщина линии(й) линий событий в пунктах. Если значение None, по умолчанию используется значение из rcParams.
-
colors : color, sequence of colors or None, optional, default: None -
Цвет(ы) линий событий. Если значение None, по умолчанию используется значение из rcParams.
-
linestyles : str or tuple or a sequence of such values, optional -
По умолчанию 'solid'. Допустимые строки: ['solid', 'dashed', 'dashdot', 'dotted', '-', '--', '-.', ':']. Кортежи штриховки должны иметь вид:
(offset, onoffseq),
где onoffseq — кортеж чётной длины, содержащий значения включения и выключения чернил в пунктах.
-
**kwargs : optional -
Другие ключевые аргументы — свойства коллекции линий. См.
LineCollectionдля списка допустимых свойств.
Возвращает: -
list : A list of EventCollection objects. -
Содержит
EventCollection, которые были добавлены.
Примечания
Для linelengths, linewidths, colors и linestyles, если задано только одно значение, это значение применяется ко всем линиям. Если задан массивоподобный объект, его длина должна совпадать с длиной positions, и каждое значение будет применено к соответствующей строке массива.
Примеры
(Исходный код, png, pdf)
Примечание
В дополнение к вышеописанным аргументам, эта функция может принимать ключевой аргумент data. Если такой аргумент data задан, следующие аргументы заменяются на data[<arg>]:
- Все аргументы с именами: 'colors', 'linelengths', 'lineoffsets', 'linestyles', 'linewidths', 'positions'.
-
© 2012–2018 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/2.2.3/api/_as_gen/matplotlib.axes.Axes.eventplot.html