matplotlib.pyplot.eventplot

matplotlib.pyplot.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.

Примечания

Примечание

Это обёртка pyplot для axes.Axes.eventplot.

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

Примеры

(Source code, 2x.png, png)