matplotlib.axes.Axes.eventplot

Axes.eventplot(positions, orientation='horizontal', lineoffsets=1, linelengths=1, linewidths=None, colors=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. linestylesстрока или кортеж или список таких значений, по умолчанию: 'solid' По умолчанию 'сплошная'. Допустимые строки: ['solid', 'dashed', 'dashdot', 'dotted', '-', '--', '-.', ':']. Кортежи штрихов должны иметь вид: (offset, onoffseq), где onoffseq — кортеж чётной длины, содержащий значения включения и выключения чернил в пунктах. Если positions двумерный, это может быть последовательность с длиной, соответствующей длине positions. **kwargs Другие ключевые параметры — свойства коллекции линий. См. LineCollection для списка допустимых свойств.

Возвращает:

список 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