Quickstart¶
Fit a Gaussian DCC(1,1) with default constant-mean GARCH(1,1) marginals:
import pymgarch as mg
res = mg.DCC().fit(returns) # (T, N) DataFrame, percent scale
print(res.summary())
res.params # {"alpha": ..., "beta": ...}
res.std_errors # two-stage robust standard errors
res.conditional_correlations # (T, N, N)
res.conditional_covariances # (T, N, N)
Distributions and asymmetry¶
mg.DCC(dist="t").fit(returns) # multivariate Student-t stage 2
mg.ADCC().fit(returns) # asymmetric (Cappiello-Engle-Sheppard)
mg.CCC().fit(returns) # constant-correlation baseline
Custom marginals¶
Apply one spec to every column, or bring fitted arch results:
spec = mg.UnivariateSpec(vol="GARCH", p=1, o=1, q=1, dist="t") # GJR-t
res = mg.DCC().fit(returns, marginals=spec)
from arch import arch_model
fitted = [
arch_model(returns[c], rescale=False).fit(disp="off")
for c in returns.columns
]
res = mg.DCC().fit(returns, marginals=fitted)
Forecasting and filtering¶
fc = res.forecast(horizon=10) # analytic
fc = res.forecast(horizon=10, method="simulation", n_paths=2000)
fc.variances # (h, N)
fc.correlations # (h, N, N)
fc.covariances # (h, N, N)
flt = res.filter(new_returns) # apply fitted params to new data
ADCC has no standard analytic multi-step correlation forecast; use
method="simulation" there.
Scaling note¶
Like arch, the optimizers behave best when returns are on a percent scale
(roughly unit variance). pymgarch fits marginals with rescale=False so
parameters stay comparable with R fits on the same series; multiply decimal
returns by 100 before fitting.