matplotlib.axes.Axes.eventplot

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

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

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

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

Параметры:

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] (если это не вызывает исключение):

positions, lineoffsets, linelengths, linewidths, colors, linestyles

**kwargs

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

Возвращает:

список EventCollection

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

Примечания

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

Примеры

(Source code, png)

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

eventplot(D)

eventplot(D)