is_stationary: Check the stationary condition of a given GMVAR, StMVAR, or...

Description Usage Arguments Details Value Warning References

View source: R/argumentChecks.R


is_stationary checks the stationarity condition of a GMVAR, StMVAR, or G-StMVAR model.


  all_boldA = NULL,
  structural_pars = NULL,
  tolerance = 0.001



a positive integer specifying the autoregressive order of the model.

For GMVAR and StMVAR models:

a positive integer specifying the number of mixture components.

For G-StMVAR models:

a size (2x1) integer vector specifying the number of GMVAR type components M1 in the first element and StMVAR type components M2 in the second element. The total number of mixture components is M=M1+M2.


the number of time series in the system.


a real valued vector specifying the parameter values.

For reduced form models:

Should be size ((M(pd^2+d+d(d+1)/2+2)-M1-1)x1) and have the form θ = (υ_{1}, ...,υ_{M}, α_{1},...,α_{M-1},ν), where

  • υ_{m} = (φ_{m,0},φ_{m},σ_{m})

  • φ_{m} = (vec(A_{m,1}),...,vec(A_{m,p})

  • and σ_{m} = vech(Ω_{m}), m=1,...,M,

  • ν=(ν_{M1+1},...,ν_{M})

  • M1 is the number of GMVAR type regimes.

For structural model:

Should have the form θ = (φ_{1,0},...,φ_{M,0},φ_{1},...,φ_{M}, vec(W),λ_{2},...,λ_{M},α_{1},...,α_{M-1},ν), where

  • λ_{m}=(λ_{m1},...,λ_{md}) contains the eigenvalues of the mth mixture component.

Above, φ_{m,0} is the intercept parameter, A_{m,i} denotes the ith coefficient matrix of the mth mixture component, Ω_{m} denotes the error term covariance matrix of the m:th mixture component, and α_{m} is the mixing weight parameter. The W and λ_{mi} are structural parameters replacing the error term covariance matrices (see Virolainen, 2020). If M=1, α_{m} and λ_{mi} are dropped. If parametrization=="mean", just replace each φ_{m,0} with regimewise mean μ_{m}. vec() is vectorization operator that stacks columns of a given matrix into a vector. vech() stacks columns of a given matrix from the principal diagonal downwards (including elements on the diagonal) into a vector.

In the GMVAR model, M1=M and ν is dropped from the parameter vector. In the StMVAR model, M1=0. In the G-StMVAR model, the first M1 regimes are GMVAR type and the rest M2 regimes are StMVAR type. In StMVAR and G-StMVAR models, the degrees of freedom parameters in ν should be strictly larger than two.

The notation is similar to the cited literature.


3D array containing the ((dp)x(dp)) "bold A" matrices related to each mixture component VAR-process, obtained from form_boldA. Will be computed if not given.


If NULL a reduced form model is considered. For structural model, should be a list containing the following elements:

  • W - a (dxd) matrix with its entries imposing constraints on W: NA indicating that the element is unconstrained, a positive value indicating strict positive sign constraint, a negative value indicating strict negative sign constraint, and zero indicating that the element is constrained to zero.

  • C_lambda - a (d(M-1) x r) constraint matrix that satisfies (λ_{2},..., λ_{M}) = C_{λ} γ where γ is the new (r x 1) parameter subject to which the model is estimated (similarly to AR parameter constraints). The entries of C_lambda must be either positive or zero. Ignore (or set to NULL) if the eigenvalues λ_{mi} should not be constrained.

See Virolainen (2020) for the conditions required to identify the shocks and for the B-matrix as well (it is W times a time-varying diagonal matrix with positive diagonal entries).


Returns FALSE if modulus of any eigenvalue is larger or equal to 1-tolerance.


If the model is constrained, remove the constraints first with the function reform_constrained_pars.


Returns TRUE if the model is stationary and FALSE if not. Based on the argument tolerance, is_stationary may return FALSE when the parameter vector is in the stationarity region, but very close to the boundary (this is used to ensure numerical stability in estimation of the model parameters).


No argument checks!


@keywords internal

saviviro/gmvarkit documentation built on Oct. 25, 2021, 2:14 a.m.