pandas.io.formats.style.Styler.background_gradient

Styler.background_gradient(cmap='PuBu', low=0, high=0, axis=0, subset=None, text_color_threshold=0.408, vmin=None, vmax=None, gmap=None)[source]

Заливка фона в стиле градиента.

Цвет фона определяется в соответствии с данными в каждом столбце, строке или таблице или заданным отображением градиента. Требуется matplotlib.

Параметры

cmap:str или цветовая карта

Цветовая карта Matplotlib.

low:float

Сжать диапазон цветов с низким значением. Это кратное диапазону данных для расширения ниже минимума; хорошие значения обычно находятся в диапазоне [0, 1], по умолчанию 0.

high:float

Сжать диапазон цветов с высоким значением. Это кратное диапазону данных для расширения выше максимума; хорошие значения обычно находятся в диапазоне [0, 1], по умолчанию 0.

axis:{0, 1, “индекс”, “столбцы”, None}, по умолчанию 0

Применить к каждому столбцу (axis=0 или 'index'), к каждой строке (axis=1 или 'columns'), или ко всему DataFrame сразу с axis=None.

subset:метка, массив-подобный объект, IndexSlice, необязательно

Действительный двумерный вход для DataFrame.loc[<subset>], или, в случае одномерного входа или одного ключа, для DataFrame.loc[:, <subset>], где столбцы имеют приоритет, чтобы ограничить data до применения функции.

text_color_threshold:float или int

Пороговое значение яркости для определения цвета текста в [0, 1]. Улучшает видимость текста на различных цветах фона. Весь текст темный, если 0, и светлый, если 1, по умолчанию 0.408.

vmin:float, необязательно

Минимальное значение данных, соответствующее минимальному значению цветовой карты. Если не указано, используется минимальное значение данных (или gmap).

Введено в версии 1.0.0.

vmax:float, необязательно

Максимальное значение данных, соответствующее максимальному значению цветовой карты. Если не указано, используется максимальное значение данных (или gmap).

Введено в версии 1.0.0.

gmap:массив-подобный объект, необязательно

Карта градиента для определения цветов фона. Если не указано, используется исходные данные из строк, столбцов или таблицы. Если задан как ndarray или список-подобный объект, должен быть идентичной формы к исходным данным, учитывая axis и subset. Если задан как DataFrame или Series, должен иметь те же метки индекса и столбцов, учитывая axis и subset. Если задан, vmin и vmax должны быть заданы относительно этой карты градиента.

Введено в версии 1.3.0.

Возвращаемое значение

self:Styler

См. также

Styler.text_gradient

Окрашивание текста в стиле градиента.

Примечания

При использовании low и high диапазон градиента, заданный данными, если gmap не задан, или gmap, расширяется с низким значением эффективно map.min - low * map.range и с высоким значением map.max + high * map.range перед тем, как цвета будут нормализованы и определены.

Если комбинировать с vmin и vmax, map.min, map.max и map.range заменяются значениями в соответствии со значениями, полученными из vmin и vmax.

Этот метод предварительно выбирает числовые столбцы и игнорирует нечисловые столбцы, если не указан gmap, в этом случае предварительный выбор не выполняется.

Примеры

>>> df = pd.DataFrame(columns=["City", "Temp (c)", "Rain (mm)", "Wind (m/s)"],
...                   data=[["Stockholm", 21.6, 5.0, 3.2],
...                         ["Oslo", 22.4, 13.3, 3.1],
...                         ["Copenhagen", 24.5, 0.0, 6.7]])

Заливка значений по столбцам с axis=0, предварительно выбирая числовые столбцы

>>> df.style.background_gradient(axis=0)  

Заливка всех значений совместно с помощью axis=None

>>> df.style.background_gradient(axis=None)  

Сжатие цветовой карты с обеих low и high сторон

>>> df.style.background_gradient(axis=None, low=0.75, high=1.0)  

Ручная установка vmin и vmax пороговых значений градиента

>>> df.style.background_gradient(axis=None, vmin=6.7, vmax=21.6)  

Установка карты градиента для dataframe (т.е. axis=None), нам нужно явно указать subset для соответствия gmap форме

>>> gmap = np.array([[1,2,3], [2,3,4], [3,4,5]])
>>> df.style.background_gradient(axis=None, gmap=gmap,
...     cmap='YlOrRd', subset=['Temp (c)', 'Rain (mm)', 'Wind (m/s)']
... )