pandas.core.groupby.DataFrameGroupBy.pipe

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

Применить func с аргументами к этому объекту GroupBy и вернуть результат.

Используйте .pipe, чтобы улучшить читаемость, объединяя функции, которые ожидают объекты Series, DataFrame, GroupBy или Resampler. Вместо записи

>>> h = lambda x, arg2, arg3: x + 1 - arg2 * arg3
>>> g = lambda x, arg1: x * 5 / arg1
>>> f = lambda x: x ** 4
>>> df = pd.DataFrame([["a", 4], ["b", 5]], columns=["group", "value"])
>>> h(g(f(df.groupby('group')), arg1=1), arg2=2, arg3=3)  

Вы можете написать

>>> (df.groupby('group')
...    .pipe(f)
...    .pipe(g, arg1=1)
...    .pipe(h, arg2=2, arg3=3))  

что значительно улучшает читаемость.

Parameters:

func:callable or tuple of (callable, str)

Функция для применения к этому объекту GroupBy или, как альтернатива, кортеж (callable, data_keyword), где data_keyword — строка, указывающая ключевое слово callable, которое ожидает объект GroupBy.

args:iterable, optional

Позиционные аргументы, передаваемые в func.

kwargs:dict, optional

Словарь ключевых аргументов, передаваемых в func.

Returns:

тип возвращаемого значения func.

См. также

Series.pipe

Применить функцию с аргументами к серии.

DataFrame.pipe

Применить функцию с аргументами к фрейму данных.

apply

Применить функцию к каждой группе вместо всего объекта GroupBy.

Примечания

Дополнительную информацию можно найти здесь

Примеры

>>> df = pd.DataFrame({'A': 'a b a b'.split(), 'B': [1, 2, 3, 4]})
>>> df
   A  B
0  a  1
1  b  2
2  a  3
3  b  4

Чтобы получить разницу между максимальным и минимальным значением каждой группы в одном проходе, вы можете сделать следующее

>>> df.groupby('A').pipe(lambda x: x.max() - x.min())
   B
A
a  2
b  2