matplotlib.pyplot.eventplot

matplotlib.pyplot.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{'горизонтально', 'вертикально'}, по умолчанию: 'горизонтально'

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

• 'горизонтально': события выстраиваются горизонтально. Линии индикаторов — вертикальные.
• 'вертикально': события выстраиваются вертикально. Линии индикаторов — горизонтальные.

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строка или кортеж или список таких значений, по умолчанию: 'сплошная'

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

(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, 2x.png, png)