diagnostics(series, alpha=0.05, nparam=0, lags=15, stats=(), float_fmt='{0:.2f}')[source]#

Methods to compute various diagnostics checks for a time series.

  • series (pandas.Series) – Time series to compute the diagnostics for.

  • alpha (float, optional) – significance level to use for the hypothesis testing.

  • nparam (int, optional) – Number of parameters of the noisemodel.

  • lags (int, optional) – Maximum number of lags (in days) to compute the autocorrelation tests for.

  • stats (tuple, optional) – Tuple with the diagnostic checks to perform. Not implemented yet.

  • float_fmt (str) – String to use for formatting the floats in the returned DataFrame.


df – DataFrame with the information for the diagnostics checks. The final column in this DataFrame report if the Null-Hypothesis is rejected. If H0 is not rejected (=False) the data is in agreement with one of the properties of white noise (e.g., normally distributed).

Return type:



Different tests are computed depending on the regularity of the time step of the provided time series. pd.infer_freq is used to determined if the time steps are regular.


>>> data = pd.Series(index=pd.date_range(start=0, periods=1000, freq="D"),
>>>                 data=np.random.rand(1000))
>>> ps.stats.diagnostics(data)
                  Checks Statistic P-value  Reject H0
Shapiroo       Normality      1.00    0.86      False
D'Agostino     Normality      1.18    0.56      False
Runs test      Autocorr.     -0.76    0.45      False
Durbin-Watson  Autocorr.      2.02     nan      False
Ljung-Box      Autocorr.      5.67    1.00      False

In this example, the Null-hypothesis is not rejected and the data may be assumed to be white noise.