matplotlib.axes.Axes.eventplot
- Axes.eventplot(positions, orientation='horizontal', lineoffsets=1, linelengths=1, linewidths=None, colors=None, alpha=None, linestyles='solid', *, data=None, **kwargs)[source]
-
Отображение идентичных параллельных линий в заданных позициях.
Этот тип графика обычно используется в нейронауке для представления нейронных событий, где он обычно называется графиком импульсов, точечным графиком или графиком импульсов.
Однако он полезен в любой ситуации, где необходимо показать временной или позиционный интервал нескольких наборов дискретных событий, таких как время прибытия людей в бизнес-центр в каждый день месяца или дата ураганов в каждом году прошлого столетия.
- Параметры:
-
- positionsмассив-подобный объект или список массивов-подобных объектов
-
Массив-подобный объект 1D определяет позиции одной последовательности событий.
Несколько групп событий могут быть переданы в виде списка массивов-подобных объектов. Каждая группа может быть стилизована независимо путем передачи списков значений в lineoffsets, linelengths, linewidths, colors и linestyles.
Обратите внимание, что positions может быть 2D-массивом, но на практике разные группы событий обычно имеют разное количество событий, поэтому вместо 2D-массива обычно используется список массивов различной длины.
- orientation{'horizontal', 'vertical'}, по умолчанию: 'horizontal'
-
Направление последовательности событий:
- 'horizontal': события расположены горизонтально. Линии индикаторов — вертикальные.
- 'vertical': события расположены вертикально. Линии индикаторов — горизонтальные.
- lineoffsetsвещественное число или массив-подобный объект, по умолчанию: 1
-
Смещение центра линий от начала координат в направлении, ортогональном orientation.
Если positions является 2D, то это может быть последовательность с длиной, соответствующей длине positions.
- linelengthsвещественное число или массив-подобный объект, по умолчанию: 1
-
Полная высота линий (т. е. линии простираются от
lineoffset - linelength/2доlineoffset + linelength/2).Если positions является 2D, то это может быть последовательность с длиной, соответствующей длине positions.
-
linewidthsвещественное число или массив-подобный объект, по умолчанию:
rcParams["lines.linewidth"](по умолчанию:1.5) -
Толщина линии(й) линий событий в пунктах.
Если positions является 2D, то это может быть последовательность с длиной, соответствующей длине positions.
-
colorsцвет или список цветов, по умолчанию:
rcParams["lines.color"](по умолчанию:'C0') -
Цвет(а) линий событий.
Если positions является 2D, то это может быть последовательность с длиной, соответствующей длине positions.
- alphaвещественное число или массив-подобный объект, по умолчанию: 1
-
Значение альфа-смешивания (от 0 — прозрачный до 1 — непрозрачный).
Если positions является 2D, то это может быть последовательность с длиной, соответствующей длине positions.
- linestylesстрока или кортеж или список таких значений, по умолчанию: 'solid'
-
По умолчанию 'solid'. Допустимые строки: ['solid', 'dashed', 'dashdot', 'dotted', '-', '--', '-.', ':']. Кортежи пунктирных линий должны иметь вид:
(offset, onoffseq),
где onoffseq — кортеж чётной длины, содержащий значения включения и выключения чернил в пунктах.
Если positions является 2D, то это может быть последовательность с длиной, соответствующей длине 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)
Примеры, использующие matplotlib.axes.Axes.eventplot
© 2012–2023 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.8.4/api/_as_gen/matplotlib.axes.Axes.eventplot.html