matplotlib.pyplot.eventplot

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

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

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

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

Parameters:

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. linestylesстрока или кортеж или список таких значений, по умолчанию: 'сплошная' Значение по умолчанию 'сплошная'. Допустимые строки ['сплошная', 'штриховая', 'пунктирная', 'точковая', '-', '--', '-.', ':']. Кортежи штрихов должны иметь вид: (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.pyplot.eventplot