matplotlib.pyplot.stem

matplotlib.pyplot.stem(*args, linefmt=None, markerfmt=None, basefmt=None, bottom=0, label=None, use_line_collection=, 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 можно указать позиционно, но все остальные форматы должны быть указаны в качестве ключевых аргументов.

Параметры:

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

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

headsarray-like

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

linefmtstr, необязательно

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

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

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

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

markerfmtstr, необязательно

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

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

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

orientation{'vertical', 'horizontal'}, по умолчанию: 'vertical'

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

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

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

labelstr, по умолчанию: None

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

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

Устарело начиная с версии 3.6

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

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

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

Возвращает:

StemContainer

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

Примечания

См. также

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

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

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

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