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 можно указать в качестве позиционного параметра, но все другие форматы должны быть предоставлены в качестве ключевых аргументов.

Parameters:

locsarray-like, default: (0, 1, ..., len(heads) - 1)

Для вертикальных графиков стебля — позиции x стеблей. Для горизонтальных графиков стебля — позиции y стеблей.

headsarray-like

Для вертикальных графиков стебля — значения y вершин стеблей. Для горизонтальных графиков стебля — значения x вершин стеблей.

linefmtstr, optional

Строка, определяющая цвет и/или тип линии вертикальных линий:

Символ	Тип линии
'-'	сплошная линия
'--'	штриховая линия
'-.'	штрихпунктирная линия
':'	пунктирная линия

По умолчанию: 'C0-', т. е. сплошная линия с первым цветом цикла цветов.

Примечание: Маркеры, заданные через этот параметр (например, 'x'), будут проигнорированы. Вместо этого маркеры следует задавать с помощью markerfmt.

markerfmtstr, optional

Строка, определяющая цвет и/или форму маркеров на вершинах стеблей. Если маркер не задан, используется маркер 'o', т. е. заполненные круги. Если цвет не задан, используется цвет из linefmt.

basefmtstr, default: 'C3-' ('C2-' in classic mode)

Строка формата, определяющая свойства базовой линии.

orientation{'vertical', 'horizontal'}, default: 'vertical'

Если 'vertical', создаст график со стеблями, ориентированными вертикально. Если 'horizontal', стебли будут ориентированы горизонтально.

bottomfloat, default: 0

Позиция базовой линии в y/x (в зависимости от ориентации).

labelstr, default: None

Метка для стеблей для использования в легендах.

dataindexable object, optional

Если указан, все параметры также принимают строку s, которая интерпретируется как data[s] (если это не вызывает исключение).

Returns:

StemContainer

Контейнер можно рассматривать как кортеж (markerline, stemlines, baseline)

Примечания

См. также

Функцию MATLAB stem, которая послужила вдохновением для этого метода.

Примеры использования matplotlib.pyplot.stem

График стебля

График стебля