pandas.io.formats.style.Styler.pipe

Styler.pipe(func, *args, **kwargs) [source]

Применить func(self, *args, **kwargs), и вернуть результат.

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

Параметры:	func : function Функция для применения к Styler. В качестве альтернативы, кортеж (callable, keyword), где keyword — строка, указывающая ключевое слово callable , которое ожидает Styler. *args, **kwargs : Аргументы, передаваемые в func.
Возвращает:	object : Значение, возвращаемое func.

См. также

DataFrame.pipe

Аналогичный метод для DataFrame.

Styler.apply

Применение функции по строкам, столбцам или всей таблице для изменения стилей DataFrame.

Примечания

Как и DataFrame.pipe(), этот метод может упростить применение нескольких пользовательских функций к стилизатору. Вместо того чтобы писать:

f(g(df.style.set_precision(3), arg1=a), arg2=b, arg3=c)

пользователи могут написать:

(df.style.set_precision(3)
   .pipe(g, arg1=a)
   .pipe(f, arg2=b, arg3=c))

В частности, это позволяет пользователям определять функции, которые принимают объект styler, а также другие параметры, и возвращают styler после внесения изменений в стили (например, вызывая Styler.apply() или Styler.set_properties()). Используя .pipe, эти пользовательские «преобразования» стилей могут быть вставлены в вызовы встроенного интерфейса Styler.

Примеры

>>> def format_conversion(styler):
...     return (styler.set_properties(**{'text-align': 'right'})
...                   .format({'conversion': '{:.1%}'}))

Пользовательская функция format_conversion выше может быть вызвана в последовательности других изменений стилей:

>>> df = pd.DataFrame({'trial': list(range(5)),
...                    'conversion': [0.75, 0.85, np.nan, 0.7, 0.72]})
>>> (df.style
...    .highlight_min(subset=['conversion'], color='yellow')
...    .pipe(format_conversion)
...    .set_caption("Results with minimum conversion highlighted."))