matplotlib.pyplot.eventplot

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

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

positions должно быть одномерным или двумерным массивоподобным объектом, где каждая строка соответствует строке или столбцу линий.

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

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

Параметры:

positions1D or 2D array-like object Каждое значение является событием. Если positions — двумерный массивоподобный объект, каждая строка соответствует строке или столбцу линий (в зависимости от параметра orientation). orientation{'horizontal', 'vertical'}, optional Управляет направлением набора событий: 'horizontal' : линии выстроены горизонтально по строкам, и являются вертикальными. 'vertical' : линии выстроены вертикально по столбцам, и являются горизонтальными. lineoffsetsscalar or sequence of scalars, optional, default: 1 Смещение центра линий от начала координат в направлении, перпендикулярном orientation. linelengthsscalar or sequence of scalars, optional, default: 1 Общая высота линий (т.е. линии простираются от lineoffset - linelength/2 до lineoffset + linelength/2). linewidthsscalar, scalar sequence or None, optional, default: None Толщина линий событий (в пунктах). Если None, используется значение по умолчанию из rcParams. colorscolor, sequence of colors or None, optional, default: None Цвет(ы) линий событий. Если None, используется значение по умолчанию из rcParams. linestylesstr or tuple or a sequence of such values, optional По умолчанию 'solid'. Допустимые строки: ['solid', 'dashed', 'dashdot', 'dotted', '-', '--', '-.', ':']. Кортежи пунктира должны иметь вид: (offset, onoffseq), где onoffseq — кортеж чётной длины, содержащий значения включения и выключения чернил в пунктах. **kwargsoptional Другие ключевые параметры — свойства коллекции линий. Смотрите LineCollection для списка допустимых свойств.

Возвращаемое значение:

listA list of EventCollection objects. Содержит EventCollection, которые были добавлены.

Примечания

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

Примеры

(Исходный код, png, pdf)

Примечание

В дополнение к вышеописанным аргументам, эта функция может принимать ключевой аргумент data. Если такой аргумент data задан, следующие аргументы заменяются на data[<arg>]:

• Все аргументы с именами: 'colors', 'linelengths', 'lineoffsets', 'linestyles', 'linewidths', 'positions'.

Объекты, передаваемые как data, должны поддерживать доступ к элементам (data[<arg>]) и проверку на членство (<arg> in data).