extract_regime function

Extract regime from a parameter vector

Extract regime from a parameter vector

extract_regime extracts the specified regime from the GMAR, StMAR, or G-StMAR model parameter vector. Doesn't extract mixing weight parameter α\alpha.

extract_regime( p, M, params, model = c("GMAR", "StMAR", "G-StMAR"), restricted = FALSE, constraints = NULL, regime, with_dfs = TRUE )

Arguments

  • p: a positive integer specifying the autoregressive order of the model.

  • M: - For GMAR and StMAR models:: a positive integer specifying the number of mixture components.

    • For G-StMAR models:: a size (2x1) integer vector specifying the number of GMAR type components M1 in the first element and StMAR type components M2 in the second element. The total number of mixture components is M=M1+M2.
  • params: a real valued parameter vector specifying the model.

    • For non-restricted models:: Size (M(p+3)+MM11x1)(M(p+3)+M-M1-1x1) vector theta ==(upsilon_{1} ,...,,...,upsilon_{M} , α1,...,αM1,\alpha_{1},...,\alpha_{M-1},nu ) where

        * upsilon_{m} $=(\phi_{m,0},$phi_{m} $,$$\sigma_{m}^2)$
        * phi_{m} $=(\phi_{m,1},...,\phi_{m,p}), m=1,...,M$
        * nu $=(\nu_{M1+1},...,\nu_{M})$
        * $M1$ is the number of GMAR type regimes.
       
       In the GMAR model, $M1=M$ and the parameter nu dropped. In the StMAR model, $M1=0$.
       
       If the model imposes linear constraints on the autoregressive parameters: Replace the vectors phi_{m} with the vectors psi_{m} that satisfy phi_{m} $=$C_{m}psi_{m} (see the argument `constraints`).
      
    • For restricted models:: Size (3M+MM1+p1x1)(3M+M-M1+p-1x1) vector theta =(ϕ1,0,...,ϕM,0,=(\phi_{1,0},...,\phi_{M,0},phi ,,

        $\sigma_{1}^2,...,\sigma_{M}^2,$$\alpha_{1},...,\alpha_{M-1},$nu ), where phi =$(\phi_{1},...,\phi_{p})$
       
       contains the AR coefficients, which are common for all regimes.
       
       If the model imposes linear constraints on the autoregressive parameters: Replace the vector phi with the vector psi that satisfies phi $=$Cpsi (see the argument `constraints`).
      

    Symbol ϕ\phi denotes an AR coefficient, σ2\sigma^2 a variance, α\alpha a mixing weight, and ν\nu a degrees of freedom parameter. If parametrization=="mean", just replace each intercept term ϕm,0\phi_{m,0} with the regimewise mean μm=ϕm,0/(1ϕi,m)\mu_m = \phi_{m,0}/(1-\sum\phi_{i,m}). In the G-StMAR model, the first M1 components are GMAR type

    and the rest M2 components are StMAR type. Note that in the case M=1 , the mixing weight parameters α\alpha are dropped, and in the case of StMAR or G-StMAR model, the degrees of freedom parameters ν\nu have to be larger than 22.

  • model: is "GMAR", "StMAR", or "G-StMAR" model considered? In the G-StMAR model, the first M1 components are GMAR type and the rest M2 components are StMAR type.

  • restricted: a logical argument stating whether the AR coefficients ϕm,1,...,ϕm,p\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 (pxqm)(pxq_{m}) constraint matrices C_{m} of full column rank satisfying phi_{m} ==C_{m}psi_{m} for all m=1,...,Mm=1,...,M, where phi_{m} =(ϕm,1,...,ϕm,p)=(\phi_{m,1},...,\phi_{m,p}) and psi_{m} =(ψm,1,...,ψm,qm)=(\psi_{m,1},...,\psi_{m,q_{m}}).
    • For restricted models:: a size (pxq)(pxq) constraint matrix C of full column rank satisfying phi ==Cpsi , where phi =(ϕ1,...,ϕp)=(\phi_{1},...,\phi_{p}) and psi =ψ1,...,ψq=\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.

  • regime: a positive integer in the interval [1, M] defining which regime should be extracted.

  • with_dfs: Should the degrees of freedom parameter (if any) be included?

Returns

Returns a numeric vector corresponding to the regime with...

  • For non-restricted models:: - For GMAR model:: Size (p+2x1)(p+2x1) vector (ϕm,0,ϕm,1,...,ϕm,p,σm2)(\phi_{m,0},\phi_{m,1},...,\phi_{m,p}, \sigma_{m}^2). - For StMAR model:: Size (p+3x1)(p+3x1) vector (ϕm,0,ϕm,1,...,ϕm,p,σm2,νm)(\phi_{m,0},\phi_{m,1},...,\phi_{m,p}, \sigma_{m}^2, \nu_{m}). - For G-StMAR model:: Same as GMAR for GMAR type regimes and same as StMAR for StMAR type regimes. - With linear constraints :: Parameter vector as described above, but vector phi_{m} replaced with vector psi_{m} that satisfies phi_{m} ==R_{m}psi_{m} .
  • For restricted models:: - For GMAR model:: Size (2x1)(2x1) vector (ϕm,0,σm2)(\phi_{m,0}, \sigma_{m}^2). - For StMAR model:: Size (3x1)(3x1) vector (ϕm,0,σm2,νm)(\phi_{m,0}, \sigma_{m}^2, \nu_{m}). - For G-StMAR model:: Same as GMAR for GMAR type regimes and same as StMAR for StMAR type regimes. - With linear constraints :: Parameter vector as described above.
  • Maintainer: Savi Virolainen
  • License: GPL-3
  • Last published: 2025-04-07

Useful links