pandas.DataFrame.pipe — pandas 0.16.2 documentation (original) (raw)
DataFrame.pipe(func, *args, **kwargs)¶
Apply func(self, *args, **kwargs)
New in version 0.16.2.
| Parameters: | func : function function to apply to the NDFrame.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 NDFrame. args : positional arguments passed into func. kwargs : a dictionary of keyword arguments passed into func. |
|---|---|
| Returns: | object : the return type of func. |
Notes
Use .pipe when chaining together functions that expect on Series or DataFrames. 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) ... )