Calculate the expanding variance.

  • ddof (int, default 1 (Not supported yet)) – Delta Degrees of Freedom. The divisor used in calculations is N - ddof, where N represents the number of elements.

  • numeric_only (bool, default False (Not supported yet)) –

    Include only float, int, boolean columns.

    New in version 1.5.0(pandas).

  • engine (str, default None (Not supported yet)) –

    • 'cython' : Runs the operation through C-extensions from cython.

    • 'numba' : Runs the operation through JIT compiled code from numba.

    • None : Defaults to 'cython' or globally setting compute.use_numba

      New in version 1.4.0(pandas).

  • engine_kwargs (dict, default None (Not supported yet)) –

    • For 'cython' engine, there are no accepted engine_kwargs

    • For 'numba' engine, the engine can accept nopython, nogil and parallel dictionary keys. The values must either be True or False. The default engine_kwargs for the 'numba' engine is {'nopython': True, 'nogil': False, 'parallel': False}

      New in version 1.4.0(pandas).


Return type is the same as the original object with np.float64 dtype.

Return type

Series or DataFrame

See also


Equivalent method for NumPy array.


Calling expanding with Series data.


Calling expanding with DataFrames.


Aggregating var for Series.


Aggregating var for DataFrame.


The default ddof of 1 used in Series.var() is different than the default ddof of 0 in numpy.var().

A minimum of one period is required for the rolling calculation.


>>> s = pd.Series([5, 5, 6, 7, 5, 5, 5])  
>>> s.expanding(3).var()  
0         NaN
1         NaN
2    0.333333
3    0.916667
4    0.800000
5    0.700000
6    0.619048
dtype: float64

This docstring was copied from pandas.core.window.expanding.Expanding.