pandas.io.formats.style.Styler.bar

Styler.bar(subset=None, axis=0, *, color=None, cmap=None, width=100, height=100, align='mid', vmin=None, vmax=None, props='width: 10em;')

在单元格背景中绘制条形图。

在 1.4.0 版本发生变更.

Parameters:

subset标签、类数组、IndexSlice、可选

DataFrame.loc[<subset>] 的有效二维输入，或者，在输入为一维或单个键的情况下，为 DataFrame.loc[:, <subset>]，其中列优先，用于在应用函数 之前 限制 data。

axis{0 或 ‘index’, 1 或 ‘columns’, None}，默认 0

按列（axis=0 或 'index'）、按行（axis=1 或 'columns'）或一次性应用于整个 DataFrame（axis=None）。

colorstr 或 2 元组/列表

如果传递字符串，则负数和正数的颜色相同。如果使用 2 元组/列表，第一个元素是 color_negative，第二个元素是 `color_positive`（例如：[‘#d65f5f’, ‘#5fba7d’]）。

cmapstr, matplotlib.cm.ColorMap

matplotlib Colormap 的字符串名称，或 Colormap 对象。不能与 color 一起使用。

在 1.4.0 版本加入.

widthfloat, default 100

要在单元格中绘制条形的单元格百分比，从左侧测量，单位为 [0, 100]。

heightfloat, default 100

条形在单元格中的百分比高度，居中对齐，单位为 [0,100]。

在 1.4.0 版本加入.

alignstr, int, float, callable, default ‘mid’

如何在单元格内对齐条形，相对于经过宽度调整的中心。如果为字符串，则必须是以下之一：

• ‘left’ : 条形从最小值向右绘制。

• ‘right’ : 条形从最大值向左绘制。

• ‘zero’ : 零值位于单元格的中心。

• ‘mid’ : (max-min)/2 的值位于单元格的中心，或者如果所有值都为负（正），则零值位于单元格的右侧（左侧）。

• ‘mean’ : 数据的平均值位于单元格的中心。

如果给定 float 或 int，则表示单元格的中心。

如果给定 callble，它将接收一个一维或二维数组并返回一个标量。

在 1.4.0 版本发生变更.

vminfloat，可选

条形最小值，定义条形绘制范围的左侧限制，较小的值将被截断到 vmin。当为 None（默认）时：将使用数据的最小值。

vmaxfloat，可选

条形最大值，定义条形绘制范围的右侧限制，较大的值将被截断到 vmax。当为 None（默认）时：将使用数据的最大值。

propsbool, default False

单元格的基础 CSS，通过扩展该 CSS 来添加条形图。默认为 “width: 10em;”。

在 1.4.0 版本加入.

Returns:

Styler

Notes

用户指南的这一部分：Table Visualization 提供了许多关于不同设置和颜色协调的示例。

Examples

>>> df = pd.DataFrame({'A': [1, 2, 3, 4], 'B': [3, 4, 5, 6]})
>>> df.style.bar(subset=['A'], color='gray')