Spec-Zone.ru › Matplotlib 2.1

matplotlib.pyplot.bar

matplotlib.pyplot.bar(*args, **kwargs)

Построение столбчатой диаграммы.

Возможные подписи:

bar(x, height, *, align='center', **kwargs)
bar(x, height, width, *, align='center', **kwargs)
bar(x, height, width, bottom, *, align='center', **kwargs)

Построение столбчатой диаграммы с прямоугольниками, ограниченными

(левыми, правыми, нижними и верхними границами) по умолчанию. x, height, width и bottom могут быть скалярами или последовательностями.

Ключевые параметры align и orientation управляют интерпретацией x и bottom.

Ключевой параметр align определяет, интерпретируется ли x как центр или левая граница прямоугольника.

Параметры:

x : последовательность скаляров

координаты x столбцов.

align управляет, является ли x центром столбца (по умолчанию) или левой границей.

height : скаляр или последовательность скаляров

высота(ы) столбцов

width : скаляр или массив, необязательно

ширина(ы) столбцов, по умолчанию: 0.8

bottom : скаляр или массив, необязательно

координата(ы) y столбцов, по умолчанию: None

align : {‘center’, ‘edge’}, необязательно, по умолчанию: ‘center’

Если ‘center’, интерпретирует x как координаты центров столбцов. Если ‘edge’, выравнивает столбцы по их левым границам

Для выравнивания столбцов по правой границе передайте отрицательное значение width и align='edge'

Возвращает:

bars : matplotlib.container.BarContainer

Контейнер со всеми столбцами + ошибочными значениями

Другие параметры:

color : скаляр или массив, необязательно

цвета граней столбцов

edgecolor : скаляр или массив, необязательно

цвета границ столбцов

linewidth : скаляр или массив, необязательно

ширина границы(ц) столбца. Если None, используется значение по умолчанию; если 0, границы не рисуются. По умолчанию: None

tick_label : строка или массив, необязательно

метки меток столбцов, по умолчанию: None

xerr : скаляр или массив, необязательно

если не None, используется для создания ошибочных значений на диаграмме столбцов, по умолчанию: None

yerr : скаляр или массив, необязательно

если не None, используется для создания ошибочных значений на диаграмме столбцов, по умолчанию: None

ecolor : скаляр или массив, необязательно

устанавливает цвет ошибочных значений, по умолчанию: None

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

определяет длину в пунктах колпачков ошибочных значений, по умолчанию: None, которое будет взято из errorbar.capsize rcParam.

error_kw : словарь, необязательно

словарь ключевых параметров, которые должны быть переданы методу errorbar. ecolor и capsize могут быть указаны здесь вместо независимых ключевых параметров.

log : логическое значение, необязательно

Если True, устанавливает масштаб оси в логарифмический. По умолчанию: False

orientation : {‘vertical’, ‘horizontal’}, необязательно

Это используется для внутренней работы, пожалуйста, не используйте его напрямую, используйте barh вместо этого.

Направление столбцов.

См. также

barh
Построение горизонтальной столбчатой диаграммы.

Примечания

Дополнительные параметры color, edgecolor, linewidth, xerr и yerr могут быть скалярами или последовательностями длины, равной количеству столбцов. Это позволяет использовать bar в качестве основы для составных столбчатых диаграмм или диаграмм свечей. Подробности: xerr и yerr передаются непосредственно в errorbar(), поэтому они также могут иметь форму 2xN для независимой спецификации нижних и верхних ошибок.

Другие необязательные ключевые параметры:

Свойство Описание
agg_filter неизвестно
alpha число с плавающей точкой или None
animated [True | False]
antialiased или aa [True | False] или None по умолчанию
capstyle [‘butt’ | ‘round’ | ‘projecting’]
clip_box экземпляр matplotlib.transforms.Bbox
clip_on [True | False]
clip_path [ (Path, Transform) | Patch | None ]
color спецификация цвета matplotlib
contains вызываемая функция
edgecolor или ec спецификация цвета mpl, None, ‘none’ или ‘auto’
facecolor или fc спецификация цвета mpl или None по умолчанию, или ‘none’ для отсутствия цвета
figure экземпляр matplotlib.figure.Figure
fill [True | False]
gid строка-идентификатор
hatch [‘/’ | ‘' | ‘|’ | ‘-‘ | ‘+’ | ‘x’ | ‘o’ | ‘O’ | ‘.’ | ‘*’]
joinstyle [‘miter’ | ‘round’ | ‘bevel’]
label строка или любой печатаемый элемент с преобразованием ‘%s’
linestyle или ls [‘solid’ | ‘dashed’, ‘dashdot’, ‘dotted’ | (смещение, последовательность включения-выключения штрихов) | '-' | '--' | '-.' | ':' | 'None' | ' ' | '']
linewidth или lw число с плавающей точкой или None по умолчанию
path_effects неизвестно
picker [None|число с плавающей точкой|булево значение|вызываемая функция]
rasterized [True | False | None]
sketch_params неизвестно
snap неизвестно
transform экземпляр Transform
url строка url
visible [True | False]
zorder любое число

Примечание

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

  • Все аргументы со следующими именами: ‘bottom’, ‘color’, ‘ecolor’, ‘edgecolor’, ‘height’, ‘left’, ‘linewidth’, ‘tick_label’, ‘width’, ‘x’, ‘xerr’, ‘y’, ‘yerr’.
  • Все позиционные аргументы.

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

../../_images/sphx_glr_bar_stacked_thumb.png

Столбчатая диаграмма с группировкой

../../_images/sphx_glr_table_demo_thumb.png

Демонстрация таблицы

../../_images/sphx_glr_system_monitor_thumb.png

Мониторинг системы

../../_images/sphx_glr_custom_ticker1_thumb.png

Настраиваемый штрих 1

../../_images/sphx_glr_pyplot_thumb.png

Учебник по Pyplot

© 2012–2017 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
http://matplotlib.org/2.1.0/api/_as_gen/matplotlib.pyplot.bar.html

Spec-Zone.ru

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