ACF, PACF and the correlogram
What these tools answer
The autocorrelation function (ACF) describes linear dependence between \(y_t\) and \(y_{t-k}\).
The partial autocorrelation function (PACF) measures the remaining lag-\(k\) association after accounting for the intermediate lags.
StochX exposes both directly:
from stochx.timeseries import acf, pacf, correlogram
acf_result = acf(y, nlags=24)
pacf_result = pacf(y, nlags=24)
corr = correlogram(y, nlags=24)
print(corr.table())
Why the correlogram is central
The CorrelogramResult combines the views an EViews user normally inspects together: lag, AC, PAC, Ljung–Box Q-statistic, p-value, degrees of freedom and confidence bands.
The report is intentionally table-oriented so it can be read in notebooks, tests and automated reports.
Interpretation patterns
A practical identification guide is:
| Pattern | Typical indication |
|---|---|
| ACF cuts off, PACF tails | MA-type behavior |
| PACF cuts off, ACF tails | AR-type behavior |
| Both tail off | ARMA-type behavior |
| Strong seasonal spikes | seasonal structure may be present |
| Slow decay at low lags | possible non-stationarity |
These are heuristics, not proofs. The selected model must still be estimated and validated.
Ljung–Box and Box–Pierce
The correlogram also provides residual serial-correlation diagnostics. For a residual series \(e_t\), the Ljung–Box statistic aggregates autocorrelation evidence over a set of lags.
from stochx.timeseries import ljung_box
result = ljung_box(residuals, lags=(1, 2, 4, 8))
print(result)
Use residual diagnostics after fitting rather than relying only on the original series' correlogram.
Numerical conventions
The StochX correlogram uses explicit finite-sample counts and confidence-band conventions. These conventions are frozen by regression fixtures because tiny changes in lag caps, effective sample sizes or standard-error formulas can change downstream identification decisions.
Practical workflow
- Plot or inspect the raw series.
- Make the series stationary if required.
- Compute ACF/PACF.
- Inspect the combined correlogram.
- Propose a small set of candidate orders.
- Estimate candidates.
- Check residuals.
Continue to Models and Box–Jenkins.