Spec-Zone.ru › Matplotlib 3.2

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

Параметры:
xarray-like, optional

Позиции x стержней. По умолчанию: (0, 1, ..., len(y) - 1).

yarray-like

Значения y головок стержней.

linefmtstr, optional

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

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

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

Примечание: Хотя технически можно указать допустимые форматы, отличные от цвета или цвета и стиля линии (например, 'rx' или '-.'), это выходит за рамки целей метода и, скорее всего, не приведет к разумному графику.

markerfmtstr, optional

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

basefmtstr, optional

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

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

bottomfloat, optional, default: 0

Положение y базовой линии.

labelstr, optional, default: None

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

use_line_collectionbool, optional, default: False

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

Возвращает:
containerStemContainer

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

Примечания

См. также

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

Примечание

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

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

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

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

Stem Plot

График стержней

© 2012–2018 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.2.2/api/_as_gen/matplotlib.pyplot.stem.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API