matplotlib.pyplot.stem

matplotlib.pyplot.stem(*args, linefmt=None, markerfmt=None, basefmt=None, bottom=0, label=None, use_line_collection=True, orientation='vertical', data=None)[source]

Создать график stem.

График stem рисует линии, перпендикулярные базовой линии в каждой позиции locs от базовой линии до heads, и размещает маркер там. Для вертикальных графиков stem (по умолчанию), locs - это x-позиции, а heads - y-значения. Для горизонтальных графиков stem, locs - это y-позиции, а heads - x-значения.

Вызов функции:

stem([locs,] heads, linefmt=None, markerfmt=None, basefmt=None)

Позиции locs являются необязательными. Форматы могут быть предоставлены как позиционными, так и в виде ключевых аргументов.

Parameters

locsмассив, по умолчанию: (0, 1, ..., len(heads) - 1)

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

headsмассив

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

linefmtстрока, необязательно

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

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

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

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

markerfmtстрока, необязательно

Строка, определяющая цвет и/или форму маркеров в головках стеблей. По умолчанию: 'C0o', т.е. заполненные круги с первым цветом цикла цветов.

basefmtстрока, по умолчанию: 'C3-' ('C2-' в классическом режиме)

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

orientationстрока, по умолчанию: 'vertical'

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

bottomчисло, по умолчанию: 0

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

labelстрока, по умолчанию: None

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

use_line_collectionbool, по умолчанию: True

Если True, хранить и отображать линии стеблей как LineCollection вместо отдельных линий, что значительно увеличивает производительность. Если False, по умолчанию используется старое поведение использования списка объектов Line2D. Этот параметр может быть устаревшим в будущем.

dataиндексируемый объект, необязательно

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

Returns

StemContainer

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

Notes

См. также

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

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