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 版本发生变更.

参数:
子集label, 类似数组, IndexSlice, 可选

一个有效的 2d 输入到 DataFrame.loc[<subset>],或者,在 1d 输入或单个键的情况下,到 DataFrame.loc[:, <subset>],其中列优先,以限制 data 在应用函数 之前

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

应用于每一列(axis=0'index'),应用于每一行(axis=1'columns'),或一次性应用于整个 DataFrame(axis=None)。

颜色str 或 2-元组/列表

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

cmapstr, matplotlib.cm.ColorMap

一个 matplotlib 颜色映射的字符串名称,或是一个颜色映射对象。不能与 color 一起使用。

Added in version 1.4.0.

宽度float, 默认 100

从左侧测量,绘制条形的单元格百分比,在 [0, 100] 范围内。

高度float, 默认 100

单元格中条形的百分比高度,居中对齐,在 [0,100] 范围内。

Added in version 1.4.0.

对齐str, int, float, callable, 默认 ‘mid’

如何在相对于宽度调整中心的单元格内对齐条。如果字符串必须是以下之一:

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

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

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

  • ‘mid’ : 一个值为 (max-min)/2 位于单元格的中心,或者如果所有值都是负的(正的),则零对齐在单元格的右边(左边)。

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

如果给定一个浮点数或整数,这将指示单元格的中心。

如果一个可调用对象应该接受一个一维或二维数组并返回一个标量。

在 1.4.0 版本发生变更.

vminfloat, 可选

最小条形值,定义条形绘制范围的左手极限,较低的值将被裁剪到 vmin。当为 None(默认)时:将使用数据的最小值。

vmaxfloat, 可选

最大条形值,定义条形绘制范围的右手极限,高于 vmax 的值将被裁剪。当为 None(默认)时:将使用数据的最大值。

propsstr, 可选

扩展以添加条形图的单元格的基本CSS。默认为 “width: 10em;”

Added in version 1.4.0.

返回:
Styler

备注

本用户指南的部分:表格可视化 提供了不同设置和颜色协调的多个示例。

例子

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