pandas.core.window.expanding.Expanding.apply¶
- Expanding.apply(func, raw=False, engine=None, engine_kwargs=None, args=None, kwargs=None)[source]¶
Calculate the expanding custom aggregation function.
- Parameters
- funcfunction
Must produce a single value from an ndarray input if
raw=Trueor a single value from a Series ifraw=False. Can also accept a Numba JIT function withengine='numba'specified.Changed in version 1.0.0.
- rawbool, default False
False: passes each row or column as a Series to the function.True: the passed function will receive ndarray objects instead. If you are just applying a NumPy reduction function this will achieve much better performance.
- enginestr, default None
'cython': Runs rolling apply through C-extensions from cython.'numba': Runs rolling apply through JIT compiled code from numba. Only available whenrawis set toTrue.None: Defaults to'cython'or globally settingcompute.use_numbaNew in version 1.0.0.
- engine_kwargsdict, default None
For
'cython'engine, there are no acceptedengine_kwargsFor
'numba'engine, the engine can acceptnopython,nogilandparalleldictionary keys. The values must either beTrueorFalse. The defaultengine_kwargsfor the'numba'engine is{'nopython': True, 'nogil': False, 'parallel': False}and will be applied to both thefuncand theapplyrolling aggregation.New in version 1.0.0.
- argstuple, default None
Positional arguments to be passed into func.
- kwargsdict, default None
Keyword arguments to be passed into func.
- Returns
- Series or DataFrame
Return type is the same as the original object with
np.float64dtype.
See also
pandas.Series.expandingCalling expanding with Series data.
pandas.DataFrame.expandingCalling expanding with DataFrames.
pandas.Series.applyAggregating apply for Series.
pandas.DataFrame.applyAggregating apply for DataFrame.