random_regime: Create random regime parameters

View source: R/geneticAlgorithm.R

random_regimeR Documentation

Create random regime parameters

Description

random_regime generates random regime parameters.

Usage

random_regime(
  p,
  mu_scale,
  sigma_scale,
  restricted = FALSE,
  constraints = NULL,
  m,
  forcestat = FALSE
)

Arguments

p

a positive integer specifying the autoregressive order of the model.

mu_scale

a real valued vector of length two specifying the mean (the first element) and standard deviation (the second element) of the normal distribution from which the \mu_{m} mean-parameters are generated in random mutations in the genetic algorithm. Default is c(mean(data), sd(data)). Note that the genetic algorithm optimizes with mean-parametrization even when parametrization=="intercept", but input (in initpop) and output (return value) parameter vectors may be intercept-parametrized.

sigma_scale

a positive real number specifying the standard deviation of the (zero mean, positive only by taking absolute value) normal distribution from which the component variance parameters are generated in the random mutations in the genetic algorithm. Default is var(stats::ar(data, order.max=10)$resid, na.rm=TRUE).

restricted

a logical argument stating whether the AR coefficients \phi_{m,1},...,\phi_{m,p} are restricted to be the same for all regimes.

constraints

specifies linear constraints imposed to each regime's autoregressive parameters separately.

For non-restricted models:

a list of size (pxq_{m}) constraint matrices C_{m} of full column rank satisfying \phi_{m}=C_{m}\psi_{m} for all m=1,...,M, where \phi_{m}=(\phi_{m,1},...,\phi_{m,p}) and \psi_{m}=(\psi_{m,1},...,\psi_{m,q_{m}}).

For restricted models:

a size (pxq) constraint matrix C of full column rank satisfying \phi=C\psi, where \phi=(\phi_{1},...,\phi_{p}) and \psi=\psi_{1},...,\psi_{q}.

The symbol \phi denotes an AR coefficient. Note that regardless of any constraints, the autoregressive order is always p for all regimes. Ignore or set to NULL if applying linear constraints is not desired.

m

which regime? This is required for models with constraints for which a list of possibly differing constraint matrices is provided.

forcestat

use the algorithm by Monahan (1984) to force stationarity on the AR parameters (slower)? Not supported for constrained models.

Details

If forcestat==TRUE, then the AR coefficients are relatively large, otherwise they are usually relatively small.

Value

Regular models:

\upsilon_{m}=(\phi_{m,0},\phi_{m},\sigma_{m}^2) where \phi_{m}=(\phi_{m,1},...,\phi_{m,p}).

Restricted models:

Not supported!

Constrained models:

Replace the vectors \phi_{m} with vectors \psi_{m}.

References

  • Monahan J.F. 1984. A Note on Enforcing Stationarity in Autoregressive-Moving Average Models. Biometrica 71, 403-404.


uGMAR documentation built on Aug. 19, 2023, 5:10 p.m.