pandas.io.formats.style.Styler.highlight_between#

Styler.highlight_between(subset=None, color='yellow', axis=0, left=None, right=None, inclusive='both', props=None)[源代码]#

使用样式高亮显示定义的范围。

在 1.3.0 版本加入.

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

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

colorstr,默认为 ‘yellow’

用于高亮的背景颜色。

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

如果 leftright 被提供为序列,则沿其应用这些边界的轴。请参阅示例。

left标量或类 datetime,或序列或类数组,默认为 None

用于定义范围的左边界。

right标量或类 datetime,或序列或类数组,默认为 None

用于定义范围的右边界。

inclusive{‘both’, ‘neither’, ‘left’, ‘right’}

标识边界是闭合的还是开放的。

propsstr,默认 None

用于高亮的 CSS 属性。如果提供了 props,则不使用 color

Returns:
Styler

参见

Styler.highlight_null

使用样式高亮显示缺失值。

Styler.highlight_max

使用样式高亮显示最大值。

Styler.highlight_min

使用样式高亮显示最小值。

Styler.highlight_quantile

使用样式高亮显示由分位数定义的值。

Notes

如果 leftNone,则仅应用右边界。如果 rightNone,则仅应用左边界。如果两者都为 None,则所有值都将被高亮。

仅当 leftright 作为序列或类数组对象以匹配形状时,才需要 axis。如果 leftright 都是标量,则所有 axis 输入都将产生相同的结果。

此函数仅适用于兼容的 dtypes。例如,类 datetime 的区域只能使用等效的类 datetime 的 leftright 参数。使用 subset 来控制具有多个 dtypes 的区域。

Examples

基本用法

>>> df = pd.DataFrame({
...     'One': [1.2, 1.6, 1.5],
...     'Two': [2.9, 2.1, 2.5],
...     'Three': [3.1, 3.2, 3.8],
... })
>>> df.style.highlight_between(left=2.1, right=2.9)  
../../_images/hbetw_basic.png

沿 axis 使用范围输入序列,在这种情况下,为每个列单独设置 leftright

>>> df.style.highlight_between(left=[1.4, 2.4, 3.4], right=[1.6, 2.6, 3.6],
...     axis=1, color="#fffd75")  
../../_images/hbetw_seq.png

使用 axis=None 并将 left 参数提供为与输入 DataFrame 匹配的数组,并具有固定的 right

>>> df.style.highlight_between(left=[[2,2,3],[2,2,3],[3,3,3]], right=3.5,
...     axis=None, color="#fffd75")  
../../_images/hbetw_axNone.png

使用 props 代替默认背景颜色

>>> df.style.highlight_between(left=1.5, right=3.5,
...     props='font-weight:bold;color:#e83e8c')  
../../_images/hbetw_props.png