pandas.Series.pipe — pandas 0.25.3 documentation (original) (raw)
Series. pipe(self, func, *args, **kwargs)[source]¶
Apply func(self, *args, **kwargs).
| Parameters: | func : function function to apply to the Series/DataFrame.args, and kwargs are passed into func. Alternatively a (callable, data_keyword) tuple wheredata_keyword is a string indicating the keyword ofcallable that expects the Series/DataFrame. args : iterable, optional positional arguments passed into func. kwargs : mapping, optional a dictionary of keyword arguments passed into func. |
|---|---|
| Returns: | object : the return type of func. |
Notes
Use .pipe when chaining together functions that expect Series, DataFrames or GroupBy objects. Instead of writing
f(g(h(df), arg1=a), arg2=b, arg3=c)
You can write
(df.pipe(h) ... .pipe(g, arg1=a) ... .pipe(f, arg2=b, arg3=c) ... )
If you have a function that takes the data as (say) the second argument, pass a tuple indicating which keyword expects the data. For example, suppose f takes its data as arg2:
(df.pipe(h) ... .pipe(g, arg1=a) ... .pipe((f, 'arg2'), arg1=a, arg3=c) ... )