pandas.io.formats.style.Styler.text_gradient

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

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

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

Parameters:

cmap:str или colormap

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, необязательно

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

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

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

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

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

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

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

New in version 1.3.0.

Returns:

Styler

См. также

Styler.background_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.text_gradient(axis=0)  

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

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

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

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

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

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

Установка gmap и применение ко всем столбцам с другим cmap

>>> df.style.text_gradient(axis=0, gmap=df['Temp (c)'], cmap='YlOrRd')
...  

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

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