matplotlib.axes.Axes.bar

Axes.bar(*args, data=None, **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, используется для создания погрешностей по оси x на столбчатой диаграмме, по умолчанию: None yerr : скаляр или массив-подобный объект, необязательно если не None, используется для создания погрешностей по оси y на столбчатой диаграмме, по умолчанию: 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’.
• Все позиционные аргументы.