matplotlib.pyplot.eventplot

matplotlib.pyplot.eventplot(positions, orientation='horizontal', lineoffsets=1, linelengths=1, linewidths=None, colors=None, linestyles='solid', hold=None, data=None, **kwargs)

Построение идентичных параллельных линий в заданных позициях.

positions должно быть одномерным или двумерным массивоподобным объектом, где каждая строка соответствует строке или столбцу линий.

Этот тип графика обычно используется в нейробиологии для представления нейронных событий, где он обычно называется графиком импульсов, точечным графиком или графиком событий.

Однако он полезен в любой ситуации, когда требуется показать временные или позиционные параметры нескольких наборов дискретных событий, таких как время прибытия людей в бизнес каждый день месяца или дата ураганов каждый год прошлого столетия.

Параметры:

positions : одномерный или двумерный массивоподобный объект Каждое значение — это событие. Если positions — двумерный массивоподобный объект, каждая строка соответствует строке или столбцу линий (в зависимости от параметра orientation). orientation : {‘horizontal’, ‘vertical’}, необязательно Определяет направление коллекций событий: ‘horizontal’ : линии расположены горизонтально в строках, и являются вертикальными. ‘vertical’ : линии расположены вертикально в столбцах, и являются горизонтальными. lineoffsets : скаляр или последовательность скаляров, необязательно, по умолчанию: 1 Смещение центра линий от начала координат в направлении, ортогональном orientation. linelengths : скаляр или последовательность скаляров, необязательно, по умолчанию: 1 Полная высота линий (т.е. линия простирается от lineoffset - linelength/2 до lineoffset + linelength/2). linewidths : скаляр, последовательность скаляров или None, необязательно, по умолчанию: None Ширина линии(й) линий событий в пунктах. Если None, используется значение из rcParams. colors : цвет, последовательность цветов или None, необязательно, по умолчанию: None Цвет(а) линий событий. Если None, используется значение из rcParams. linestyles : строка или кортеж или последовательность таких значений, необязательно По умолчанию ‘solid’. Допустимые строки [‘solid’, ‘dashed’, ‘dashdot’, ‘dotted’, ‘-‘, ‘–’, ‘-.’, ‘:’]. Кортежи штрихов должны быть вида: (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’.