matplotlib.pyplot.stem

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

Создать график стебля.

График стебля строит вертикальные линии в каждой позиции x от базовой линии до y и размещает там маркер.

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

stem([x,] y, linefmt=None, markerfmt=None, basefmt=None)

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

Параметры:

x : array-like, optional Позиции x стеблей. По умолчанию: (0, 1, ..., len(y) - 1). y : array-like Значения y головок стеблей. linefmt : str, optional Строка, определяющая свойства вертикальных линий. Обычно это будет цвет или цвет и стиль линии: Символ Стиль линии '-' сплошная линия '--' штриховая линия '-.' штрихпунктирная линия ':' пунктирная линия По умолчанию: 'C0-', т.е. сплошная линия первого цвета цикла цветов. Примечание: хотя технически можно указать другие допустимые форматы, кроме цвета или цвета и стиля линии (например, 'rx' или '-.'), это выходит за рамки назначения метода и, скорее всего, не приведет к разумному графику. markerfmt : str, optional Строка, определяющая свойства маркеров в головках стеблей. По умолчанию: 'C0o', т.е. заполненные кружки первого цвета цикла цветов. basefmt : str, optional Строковый формат, определяющий свойства базовой линии. По умолчанию: 'C3-' ('C2-' в классическом режиме). bottom : float, optional, default: 0 Позиция y базовой линии. label : str, optional, default: None Метка для использования для стеблей в легендах. use_line_collection : bool, optional, default: False Если True, хранить и отображать линии стеблей как LineCollection вместо отдельных линий. Это значительно увеличивает производительность, и станет вариантом по умолчанию в Matplotlib 3.3. Если False, возвращается к старому поведению использования списка объектов Line2D.

Возвращает:

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

Примечания

См. также

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

Примечание

В дополнение к описанным выше аргументам, эта функция может принимать ключевой аргумент data. Если такой аргумент data задан, следующие аргументы заменяются на data[<arg>]:

• Все позиционные и все ключевые аргументы.

Объекты, переданные как data, должны поддерживать доступ по элементам (data[<arg>]) и проверку на принадлежность (<arg> in data).

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

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