matplotlib.pyplot.eventplot

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

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

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

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

Параметры:

positionsarray-like or list of array-like Одномерный массив, определяющий позиции одной последовательности событий. Несколько групп событий могут быть переданы как список массивов. Каждую группу можно стилизовать независимо, передавая списки значений в lineoffsets, linelengths, linewidths, colors и linestyles. Обратите внимание, что positions может быть двумерным массивом, но на практике различные группы событий обычно имеют разное количество, поэтому обычно используется список массивов различной длины, а не двумерный массив. orientation{'horizontal', 'vertical'}, default: 'horizontal' Направление последовательности событий: 'горизонтально': события располагаются горизонтально. Линии индикаторов вертикальны. 'вертикально': события располагаются вертикально. Линии индикаторов горизонтальны. lineoffsetsfloat or array-like, default: 1 Смещение центра линий от начала координат в направлении, перпендикулярном orientation. Если positions является двумерным, это может быть последовательность с длиной, соответствующей длине positions. linelengthsfloat or array-like, default: 1 Полная высота линий (т.е. линии простираются от lineoffset - linelength/2 до lineoffset + linelength/2). Если positions является двумерным, это может быть последовательность с длиной, соответствующей длине positions. linewidthsfloat or array-like, default: rcParams["lines.linewidth"] (default: 1.5) Ширина линии(й) линий события, в пунктах. Если positions является двумерным, это может быть последовательность с длиной, соответствующей длине positions. colorscolor or list of colors, default: rcParams["lines.color"] (default: 'C0') Цвет(ы) линий события. Если positions является двумерным, это может быть последовательность с длиной, соответствующей длине positions. linestylesstr or tuple or list of such values, default: 'solid' По умолчанию 'сплошная'. Допустимые строки ['сплошная', 'штриховая', 'штрихпунктирная', 'пунктирная', '-', '--', '-.', ':']. Кортежи штрихов должны иметь вид: (offset, onoffseq), где onoffseq — кортеж чётной длины включения и выключения чернил в пунктах. Если positions является двумерным, это может быть последовательность с длиной, соответствующей длине positions. **kwargs Другие ключевые аргументы — свойства коллекций линий. См. LineCollection для списка допустимых свойств.

Возвращает:

list of EventCollection Добавленные EventCollection.

Примечания

Для linelengths, linewidths, colors и linestyles, если задано только одно значение, это значение применяется ко всем линиям. Если задан массив, его длина должна быть такой же, как у positions, и каждое значение будет применено к соответствующей строке массива.

Примеры

(Исходный код, png, pdf)

Примечание

В дополнение к вышеописанным аргументам, эта функция может принимать ключевой аргумент data. Если такой аргумент data задан, следующие аргументы также могут быть строками s, которые интерпретируются как data[s] (если это не вызывает исключения): positions, lineoffsets, linelengths, linewidths, colors, linestyles.

Объекты, переданные как data, должны поддерживать доступ по элементам (data[s]) и проверку на принадлежность (s in data).

Примеры использования matplotlib.pyplot.eventplot