matplotlib.axes.Axes.eventplot
-
Axes.eventplot(positions, orientation='horizontal', lineoffsets=1, linelengths=1, linewidths=None, colors=None, linestyles='solid', *, data=None, **kwargs) -
Отображение идентичных параллельных линий в заданных позициях.
positions должно быть одномерным или двумерным массивоподобным объектом, где каждая строка соответствует строке или столбцу линий.
Этот тип графика обычно используется в нейронауке для представления нейронных событий, где он обычно называется графиком импульсов, графиком точек или графиком событий.
Однако он полезен в любой ситуации, где требуется показать временные или позиционные характеристики нескольких наборов дискретных событий, таких как время прибытия людей в бизнес каждый день месяца или дата ураганов каждый год прошлого века.
Параметры: positions : одномерный или двумерный массивоподобный объект
Каждое значение — это событие. Если positions — двумерный массивоподобный объект, каждая строка соответствует строке или столбцу линий (в зависимости от параметра orientation).
orientation : {‘горизонтальный’, ‘вертикальный’}, необязательно
Управляет направлением коллекций событий:
- ‘горизонтальный’ : линии расположены горизонтально в строках, и являются вертикальными.
- ‘вертикальный’ : линии расположены вертикально в столбцах, и являются горизонтальными.
lineoffsets : скаляр или последовательность скаляров, необязательно, по умолчанию: 1
Смещение центра линий от начала координат в направлении, перпендикулярном orientation.
linelengths : скаляр или последовательность скаляров, необязательно, по умолчанию: 1
Общую высоту линий (т. е. линии простираются от
lineoffset - linelength/2доlineoffset + linelength/2).linewidths : скаляр, последовательность скаляров или None, необязательно, по умолчанию: None
Толщина линии(й) линий событий в пунктах. Если None, по умолчанию используется значение из rcParams.
colors : цвет, последовательность цветов или None, необязательно, по умолчанию: None
Цвет(а) линий событий. Если None, по умолчанию используется значение из rcParams.
linestyles : строка или кортеж или последовательность таких значений, необязательно
По умолчанию — ‘сплошная’. Допустимые строки: [‘сплошная’, ‘пунктирная’, ‘штрихпунктирная’, ‘точечная’, ‘-‘, ‘–’, ‘-.’, ‘:’]. Кортежи штрихов должны иметь вид:
(offset, onoffseq),
где onoffseq — кортеж чётной длины, содержащий значения включения и выключения чернил в пунктах.
**kwargs : необязательно
Другие ключевые аргументы — свойства коллекции линий. Смотрите
LineCollectionдля списка допустимых свойств.Возвращает: Список объектов
matplotlib.collections.EventCollection, которыебыли добавлены.
Примечания
Для linelengths, linewidths, colors и linestyles, если задано только одно значение, это значение применяется ко всем линиям. Если задан массивоподобный объект, его длина должна совпадать с длиной positions, и каждое значение будет применено к соответствующей строке массива.
Примеры
(Исходный код, png, pdf)
Примечание
В дополнение к описанным выше аргументам, эта функция может принимать ключевой аргумент data. Если такой аргумент data задан, следующие аргументы заменяются на data[<arg>]:
- Все аргументы с следующими именами: ‘colors’, ‘linelengths’, ‘lineoffsets’, ‘linestyles’, ‘linewidths’, ‘positions’.
© 2012–2017 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
http://matplotlib.org/2.1.0/api/_as_gen/matplotlib.axes.Axes.eventplot.html