matplotlib.axes.Axes.eventplot

Axes.eventplot(self, 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' Направление последовательности событий: 'horizontal': события располагаются горизонтально. Индикаторные линии вертикальны. 'vertical': события располагаются вертикально. Индикаторные линии горизонтальны. lineoffsetsfloat or array-like, default: 1 Смещение центра линий от начала координат в направлении, перпендикулярном orientation. Если positions двумерный, это может быть последовательность, длина которой соответствует длине positions. linelengthsfloat or array-like, default: 1 Общая высота линий (т.е. линии простираются от lineoffset - linelength/2 до %%%CODE_BLOCK_6%%). Если 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' По умолчанию 'solid'. Допустимые строки: ['solid', 'dashed', 'dashdot', 'dotted', '-', '--', '-.', ':']. Кортежи для штриховки должны иметь вид: (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.axes.Axes.eventplot