matplotlib.pyplot.stem
- matplotlib.pyplot.stem(*args, linefmt=None, markerfmt=None, basefmt=None, bottom=0, label=None, orientation='vertical', data=None)[source]
-
Создать график стебля.
График стебля рисует линии, перпендикулярные базовой линии в каждой позиции locs от базовой линии до heads, и размещает там маркер. Для вертикальных графиков стебля (по умолчанию) locs - это позиции по оси x, а heads - значения по оси y. Для горизонтальных графиков стебля locs - это позиции по оси y, а heads - значения по оси x.
Вызов:
stem([locs,] heads, linefmt=None, markerfmt=None, basefmt=None)
Позиции locs являются необязательными. linefmt может быть предоставлен как позиционный аргумент, но все остальные форматы должны быть предоставлены как ключевые аргументы.
- Параметры:
-
- locsмассив-подобный объект, по умолчанию: (0, 1, ..., len(heads) - 1)
-
Для вертикальных графиков стебля - позиции по оси x стеблей. Для горизонтальных графиков стебля - позиции по оси y стеблей.
- headsмассив-подобный объект
-
Для вертикальных графиков стебля - значения по оси y вершин стеблей. Для горизонтальных графиков стебля - значения по оси x вершин стеблей.
- linefmtстрока, необязательно
-
Строка, определяющая цвет и/или стиль линии вертикальных линий:
Символ
Стиль линии
'-'сплошная линия
'--'штриховая линия
'-.'штрихпунктирная линия
':'пунктирная линия
По умолчанию: 'C0-', т.е. сплошная линия первого цвета из цикла цветов.
Примечание: Маркеры, заданные через этот параметр (например, 'x'), будут проигнорированы. Вместо этого маркеры следует указывать с помощью markerfmt.
- markerfmtстрока, необязательно
-
Строка, определяющая цвет и/или форму маркеров на вершинах стеблей. Если маркер не задан, используется маркер 'o', т.е. заполненные кружки. Если цвет не задан, используется цвет из linefmt.
- basefmtстрока, по умолчанию: 'C3-' ('C2-' в классическом режиме)
-
Строка формата, определяющая свойства базовой линии.
- orientation{'вертикальный', 'горизонтальный'}, по умолчанию: 'вертикальный'
-
Направление стеблей.
- bottomвещественное число, по умолчанию: 0
-
Позиция базовой линии по оси y/x (в зависимости от orientation).
- labelстрока, необязательно
-
Метка для использования стеблей в легендах.
- dataиндексируемый объект, необязательно
-
Если задано, все параметры также принимают строку
s, которая интерпретируется какdata[s](если это не вызывает исключение).
- Возвращает:
-
StemContainer-
Контейнер может быть обработан как кортеж (markerline, stemlines, baseline)
Замечания
Примечание
Это обертка pyplot для
axes.Axes.stem.См. также
Функция MATLAB stem, которая послужила вдохновением для этого метода.
Примеры использования matplotlib.pyplot.stem
© 2012–2023 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/stable/api/_as_gen/matplotlib.pyplot.stem.html