# Ljung–Box test

The Ljung–Box test (named for Greta M. Ljung and George E. P. Box) is a type of statistical test of whether any of a group of autocorrelations of a time series are different from zero. Instead of testing randomness at each distinct lag, it tests the "overall" randomness based on a number of lags, and is therefore a portmanteau test.
This test is sometimes known as the Ljung–Box Q test, and it is closely connected to the Box–Pierce test (which is named after George E. P. Box and David A. Pierce). In fact, the Ljung–Box test statistic was described explicitly in the paper that led to the use of the Box–Pierce statistic, and from which that statistic takes its name. The Box–Pierce test statistic is a simplified version of the Ljung–Box statistic for which subsequent simulation studies have shown poor performance.
The Ljung–Box test is widely applied in econometrics and other applications of time series analysis. A similar assessment can be also carried out with the Breusch–Godfrey test and the Durbin–Watson test.

## Formal definition

The Ljung–Box test may be defined as:
    $H_{0}$: The data is not correlated (i.e. the correlations in the population from which the sample is taken are 0, so that any observed correlations in the data result from randomness of the sampling process).
    $H_{a}$: The data exhibit serial correlation.
The test statistic is:
    $Q=n(n+2)\sum _{k=1}^{h}{\frac {{\hat {\rho }}_{k}^{2}}{n-k}}$
where n is the sample size, ${\hat {\rho }}_{k}$ is the sample autocorrelation at lag k, and h is the number of lags being tested. Under $H_{0}$ the statistic Q asymptotically follows a $\chi _{(h)}^{2}$. For significance level α, the critical region for rejection of the hypothesis of randomness is:
    $Q>\chi _{1-\alpha ,h}^{2}$
where $\chi _{1-\alpha ,h}^{2}$ is the (1 − α)-quantile of the chi-squared distribution with h degrees of freedom.
The Ljung–Box test is commonly used in autoregressive integrated moving average (ARIMA) modeling. Note that it is applied to the residuals of a fitted ARIMA model, not the original series, and in such applications the hypothesis actually being tested is that the residuals from the ARIMA model have no autocorrelation. When testing the residuals of an estimated ARIMA model, the degrees of freedom need to be adjusted to reflect the parameter estimation. For example, for an ARIMA(p,0,q) model, the degrees of freedom should be set to $h-p-q$.

## Box–Pierce test

The Box–Pierce test uses the test statistic, in the notation outlined above, given by
    $Q_{\text{BP}}=n\sum _{k=1}^{h}{\hat {\rho }}_{k}^{2},$
and it uses the same critical region as defined above.
Simulation studies have shown that the distribution for the Ljung–Box statistic is closer to a $\chi _{(h)}^{2}$ distribution than is the distribution for the Box–Pierce statistic for all sample sizes including small ones.

## Implementations in statistics packages

* R: the Box.test function in the stats package
* Python: the acorr_ljungbox function in the statsmodels package
* Julia: the Ljung–Box tests and the Box–Pierce tests in the HypothesisTests package
* SPSS: the Box-Ljung statistic is included by default in output produced by the IBM SPSS Statistics Forecasting module.