pandas.core.window.rolling.Rolling.var¶
-
Rolling.var(ddof=1, *args, **kwargs)[source]¶ Calculate the rolling variance.
- Parameters
- ddofint, default 1
Delta Degrees of Freedom. The divisor used in calculations is
N - ddof, whereNrepresents the number of elements.- *args
For NumPy compatibility and will not have an effect on the result.
- **kwargs
For NumPy compatibility and will not have an effect on the result.
- Returns
- Series or DataFrame
Return type is the same as the original object.
See also
numpy.varEquivalent method for NumPy array.
pandas.Series.rollingCalling rolling with Series data.
pandas.DataFrame.rollingCalling rolling with DataFrames.
pandas.Series.varAggregating var for Series.
pandas.DataFrame.varAggregating var for DataFrame.
Notes
The default
ddofof 1 used inSeries.var()is different than the defaultddofof 0 innumpy.var().A minimum of one period is required for the rolling calculation.
The implementation is susceptible to floating point imprecision as shown in the example below.
Examples
>>> s = pd.Series([5, 5, 6, 7, 5, 5, 5]) >>> s.rolling(3).var() 0 NaN 1 NaN 2 3.333333e-01 3 1.000000e+00 4 1.000000e+00 5 1.333333e+00 6 6.661338e-16 dtype: float64