matplotlib.axes.Axes.eventplot

Axes.eventplot(positions, *, orientation='horizontal', lineoffsets=1, linelengths=1, linewidths=None, colors=None, alpha=None, linestyles='solid', data=None, **kwargs)[источник]

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

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

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

Параметры:

positionsмассивоподобный объект или список массивоподобных объектов

Одномерный массивоподобный объект задаёт позиции одной последовательности событий.

Несколько групп событий можно передать в виде списка массивоподобных объектов. Для каждой группы можно независимо задать стиль, передав списки значений параметрам lineoffsets, linelengths, linewidths, colors и linestyles.

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

orientation{'horizontal', 'vertical'}, по умолчанию: 'horizontal'

Направление последовательности событий:

• 'horizontal': события расположены горизонтально. Линии-индикаторы вертикальны.
• 'vertical': события расположены вертикально. Линии-индикаторы горизонтальны.

lineoffsetsчисло с плавающей запятой или массивоподобный объект, по умолчанию: 1

Смещение центра линий относительно начала координат в направлении, перпендикулярном orientation.

Если positions — двумерный массив, здесь можно передать последовательность той же длины, что и positions.

linelengthsчисло с плавающей запятой или массивоподобный объект, по умолчанию: 1

Общая высота линий (т. е. линии простираются от lineoffset - linelength/2 до lineoffset + linelength/2).

Если positions — двумерный массив, здесь можно передать последовательность той же длины, что и positions.

linewidthsчисло с плавающей запятой или массивоподобный объект, по умолчанию: rcParams["lines.linewidth"] (значение по умолчанию: 1.5)

Ширина линий событий в пунктах.

Если positions — двумерный массив, здесь можно передать последовательность той же длины, что и positions.

colorsцвет или список цветов, по умолчанию: rcParams["lines.color"] (значение по умолчанию: 'C0')

Цвета линий событий.

Если positions — двумерный массив, здесь можно передать последовательность той же длины, что и positions.

alphaчисло с плавающей запятой или массивоподобный объект, по умолчанию: 1

Значения альфа-смешивания от 0 (прозрачный) до 1 (непрозрачный).

Если positions — двумерный массив, здесь можно передать последовательность той же длины, что и positions.

linestylesстрока, кортеж или список таких значений, по умолчанию: 'solid'

По умолчанию используется 'solid'. Допустимые строки: ['solid', 'dashed', 'dashdot', 'dotted', '-', '--', '-.', ':']. Кортежи штрихов должны иметь следующий вид:

(offset, onoffseq),

где onoffseq — кортеж чётной длины, задающий чередование отрезков и пробелов в пунктах.

Если positions — двумерный массив, здесь можно передать последовательность той же длины, что и positions.

dataиндексируемый объект, необязательный

Если задан, следующие параметры также принимают строку s, которая интерпретируется как data[s], если s является ключом в data:

positions, lineoffsets, linelengths, linewidths, colors, linestyles

**kwargs

Другие именованные аргументы задают свойства коллекции линий. Список допустимых свойств см. в описании LineCollection.

Возвращает:

список объектов EventCollection

Добавленные объекты EventCollection.

Примечания

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

Примеры

(Source code, 2x.png, png)

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

eventplot(D)

eventplot(D)