pandas.io.formats.style.Styler

classpandas.io.formats.style.Styler(data, precision=None, table_styles=None, uuid=None, caption=None, table_attributes=None, cell_ids=True, na_rep=None, uuid_len=5, decimal=None, thousands=None, escape=None, formatter=None)[source]

Помогает стилизовать DataFrame или Series в соответствии с данными с помощью HTML и CSS.

Параметры:

data:Series или DataFrame

Данные, которые нужно стилизовать — либо Series, либо DataFrame.

precision:int, необязательно

Точность округления чисел с плавающей точкой. Если не указано, используется значение по умолчанию pandas.options.styler.format.precision.

Изменено в версии 1.4.0.

table_styles:последовательность, по умолчанию None

Список словарей {селектор: (атрибут, значение)}; см. Примечания.

uuid:строка, по умолчанию None

Уникальный идентификатор для избежания конфликтов CSS; генерируется автоматически.

caption:строка, кортеж, по умолчанию None

Подпись таблицы. Кортеж используется только для двойных подписей в LaTeX.

table_attributes:строка, по умолчанию None

Элементы, которые отображаются в открывающем <table> теге помимо автоматического (по умолчанию) идентификатора.

cell_ids:bool, по умолчанию True

Если True, каждый ячейке будет присвоен атрибут id в её HTML теге. Атрибут id имеет вид T_<uuid>_row<num_row>_col<num_col>, где <uuid> — уникальный идентификатор, <num_row> — номер строки, а <num_col> — номер столбца.

na_rep:строка, необязательно

Представление пропущенных значений. Если na_rep равно None, специального форматирования не применяется, и используется значение по умолчанию pandas.options.styler.format.na_rep.

uuid_len:целое число, по умолчанию 5

Если uuid не указано, длина uuid для случайной генерации, выраженная в шестнадцатеричных символах, в диапазоне [0, 32].

decimal:строка, необязательно

Символ, используемый в качестве разделителя десятичных знаков для чисел с плавающей точкой, комплексных чисел и целых чисел. Если не указано, используется pandas.options.styler.format.decimal.

Добавлен в версии 1.3.0.

thousands:строка, необязательно, по умолчанию None

Символ, используемый в качестве разделителя тысяч для чисел с плавающей точкой, комплексных чисел и целых чисел. Если не указано, используется pandas.options.styler.format.thousands.

Добавлен в версии 1.3.0.

escape:строка, необязательно

Используйте ‘html’, чтобы заменить символы &, <, >, ', и " в строке отображения ячейки на безопасные для HTML последовательности. Используйте ‘latex’, чтобы заменить символы &, %, $, #, _, {, }, ~, ^, и \ в строке отображения ячейки на безопасные для LaTeX последовательности. Используйте ‘latex-math’, чтобы заменить символы аналогично режиму ‘latex’, за исключением математических подстрок, которые либо окружены двумя символами $, либо начинаются с символа \( и заканчиваются символом \). Если не указано, используется pandas.options.styler.format.escape.

Добавлен в версии 1.3.0.

formatter:строка, вызываемый объект, словарь, необязательно

Объект, определяющий способ отображения значений. См. Styler.format. Если не указано, используется pandas.options.styler.format.formatter.

Добавлен в версии 1.4.0.

См. также

DataFrame.style

Возвращает объект Styler, содержащий методы для создания стилизованного HTML представления DataFrame.

Примечания

Большинство стилей выполняется путем передачи функций стилей в Styler.apply или Styler.map. Функции стилей должны возвращать значения со строками, содержащими CSS 'attr: value', которые будут применяться к указанным ячейкам.

Если используется в Jupyter Notebook, Styler определяет _repr_html_ для автоматического отображения. В противном случае вызовите Styler.to_html, чтобы получить сгенерированный HTML.

Классы CSS прикреплены к сгенерированному HTML

• Имена индексов и столбцов включают index_name и level<k>, где k — его уровень в MultiIndex

• Ячейки меток индекса включают

  • row_heading

  • row<n> где n — числовая позиция строки

  • level<k> где k — уровень в MultiIndex

• Ячейки меток столбцов включают * col_heading * col<n> где n — числовая позиция столбца * level<k> где k — уровень в MultiIndex

• Пустые ячейки включают blank

• Ячейки данных включают data

• Обрезанные ячейки включают col_trim или row_trim.

Любой, или все, или эти классы могут быть переименованы, используя аргумент css_class_names в Styler.set_table_classes, задавая значение, такое как {“row”: “MY_ROW_CLASS”, “col_trim”: “”, “row_trim”: “”}.

Примеры

>>> df = pd.DataFrame([[1.0, 2.0, 3.0], [4, 5, 6]], index=['a', 'b'],
...                   columns=['A', 'B', 'C'])
>>> pd.io.formats.style.Styler(df, precision=2,
...                            caption="My table")  

См. Визуализация таблиц для получения дополнительных примеров.

Атрибуты

env	(Jinja2 jinja2.Environment)
template_html	(Jinja2 Шаблон)
template_html_table	(Jinja2 Шаблон)
template_html_style	(Jinja2 Шаблон)
template_latex	(Jinja2 Шаблон)
loader	(Jinja2 Загрузчик)

Методы

apply(func[, axis, subset])	Применить функцию стилизации CSS по столбцам, строкам или всей таблице.
apply_index(func[, axis, level])	Применить функцию стилизации CSS к индексу или заголовкам столбцов по уровням.
applymap(func[, subset])	(УСТАРЕЛО) Применить функцию стилизации CSS к элементам.
applymap_index(func[, axis, level])	(УСТАРЕЛО) Применить функцию стилизации CSS к индексу или заголовкам столбцов по элементам.
background_gradient([cmap, low, high, axis, ...])	Заполнить ячейки фоном в стиле градиента.
bar([subset, axis, color, cmap, width, ...])	Отобразить диаграмму в виде столбцов в фоновых цветах ячеек.
clear()	Сбросить Styler, удалив ранее примененные стили.
concat(other)	Добавить другой Styler для объединения вывода в одну таблицу.
export()	Экспортировать стили, примененные к текущему Styler.
format([formatter, subset, na_rep, ...])	Отформатировать отображаемое значение текста ячеек.
format_index([formatter, axis, level, ...])	Отформатировать отображаемое значение текста меток индекса или заголовков столбцов.
from_custom_template(searchpath[, ...])	Функция-фабрика для создания подкласса Styler.
hide([subset, axis, level, names])	Скрыть весь индекс/заголовки столбцов или определенные строки/столбцы из отображения.
highlight_between([subset, color, axis, ...])	Выделить заданный диапазон стилем.
highlight_max([subset, color, axis, props])	Выделить максимальное значение стилем.
highlight_min([subset, color, axis, props])	Выделить минимальное значение стилем.
highlight_null([color, subset, props])	Выделить пропущенные значения стилем.
highlight_quantile([subset, color, axis, ...])	Выделить значения, определяемые квантилем, стилем.
map(func[, subset])	Применить функцию стилизации CSS к элементам.
map_index(func[, axis, level])	Применить функцию стилизации CSS к индексу или заголовкам столбцов по элементам.
pipe(func, *args, **kwargs)	Применить func(self, *args, **kwargs), и вернуть результат.
relabel_index(labels[, axis, level])	Переименовать ключи индекса или заголовков столбцов, чтобы отобразить набор указанных значений.
set_caption(caption)	Установить текст, добавленный к элементу HTML <caption>.
set_properties([subset])	Установить заданные свойства CSS для каждого элемента HTML <td> для заданного подмножества.
set_sticky([axis, pixel_size, levels])	Добавить CSS для постоянного отображения индекса или заголовков столбцов в области прокрутки.
set_table_attributes(attributes)	Установить атрибуты таблицы, добавленные к элементу HTML <table>.
set_table_styles([table_styles, axis, ...])	Установить стили таблицы, включенные в элемент HTML <style>.
set_td_classes(classes)	Установить атрибут class элементов HTML <td>.
set_tooltips(ttips[, props, css_class])	Установить DataFrame строк на Styler для создания всплывающих подсказок :hover.
set_uuid(uuid)	Установить uuid, примененный к атрибутам id элементов HTML.
text_gradient([cmap, low, high, axis, ...])	Заполнить текст цветом в стиле градиента.
to_excel(excel_writer[, sheet_name, na_rep, ...])	Записать Styler в лист Excel.
to_html([buf, table_uuid, table_attributes, ...])	Записать Styler в файл, буфер или строку в формате HTML-CSS.
to_latex([buf, column_format, position, ...])	Записать Styler в файл, буфер или строку в формате LaTeX.
to_string([buf, encoding, sparse_index, ...])	Записать Styler в файл, буфер или строку в текстовом формате.

use(стили)

Установить стили в текущем Styler.