specify_starting_values_bsvar_exh: R6 Class Representing StartingValuesBSVAREXH

In bsvars: Bayesian Estimation of Structural Vector Autoregressive Models

R6 Class Representing StartingValuesBSVAREXH

Description

The class StartingValuesBSVAREXH presents starting values for the bsvar model with exogenous regime change Heteroskedasticity.

Super class

StartingValuesBSVAR -> StartingValuesBSVAREXH

Public fields

A

an NxK matrix of starting values for the parameter A.

B

an NxN matrix of starting values for the parameter B.

hyper

a (2*N+1)x2 matrix of starting values for the shrinkage hyper-parameters of the hierarchical prior distribution.

sigma2

an NxM matrix of starting values for the regime-specific variances of the structural shocks. Its elements sum to value M over the rows.

xi

an MxT matrix of starting values for the Markov process indicator. Its columns are a chosen column of an identity matrix of order M.

lambda

a NxT matrix of starting values for latent variables.

df

an Nx1 vector of positive numbers with starting values for the equation-specific degrees of freedom parameters of the Student-t conditional distribution of structural shocks.

Methods

Public methods

• StartingValuesBSVAREXH$new()

• StartingValuesBSVAREXH$get_starting_values()

• StartingValuesBSVAREXH$set_starting_values()

• StartingValuesBSVAREXH$clone()

---

StartingValuesBSVAREXH$new()

Create new starting values StartingValuesBSVAREXH.

Usage

StartingValuesBSVAREXH$new(A, B, N, p, T, d = 0, variance_regimes = rep(1, T))

Arguments

A

a logical NxK matrix containing value TRUE for the elements of the autoregressive matrix A to be estimated and value FALSE for exclusion restrictions to be set to zero.

B

a logical NxN matrix containing value TRUE for the elements of the structural matrix B to be estimated and value FALSE for exclusion restrictions to be set to zero.

N

a positive integer - the number of dependent variables in the model.

p

a positive integer - the autoregressive lag order of the SVAR model.

T

a positive integer - the the time series dimension of the dependent variable matrix Y.

d

a positive integer - the number of exogenous variables in the model.

variance_regimes

a T-vector with exogenous regime indicators that are integer numbers associating the time observation with heteroskedastic regime.

Returns

Starting values StartingValuesBSVAREXH.

---

StartingValuesBSVAREXH$get_starting_values()

Returns the elements of the starting values StartingValuesBSVAR-MS as a list.

Usage

StartingValuesBSVAREXH$get_starting_values()

Examples

# starting values for a homoskedastic bsvar with 1 lag for a 3-variable system
A = matrix(TRUE, 3, 4)
B = matrix(TRUE, 3, 3)
sv = specify_starting_values_bsvar_exh$new(A = A, B = B, N = 3, p = 1, T = 100)
sv$get_starting_values()   # show starting values as list

---

StartingValuesBSVAREXH$set_starting_values()

Returns the elements of the starting values StartingValuesBSVAREXH as a list.

Usage

StartingValuesBSVAREXH$set_starting_values(last_draw)

Arguments

last_draw

a list containing the last draw.

Returns

An object of class StartingValuesBSVAREXH including the last draw of the current MCMC as the starting value to be passed to the continuation of the MCMC estimation using estimate().

Examples

# starting values for a bsvar model with 1 lag for a 3-variable system
A = matrix(TRUE, 3, 4)
B = matrix(TRUE, 3, 3)
sv = specify_starting_values_bsvar_exh$new(A = A, B = B, N = 3, p = 1, T = 100)

# Modify the starting values by:
sv_list = sv$get_starting_values()   # getting them as list
sv_list$A <- matrix(rnorm(12), 3, 4) # modifying the entry
sv$set_starting_values(sv_list)      # providing to the class object

---

StartingValuesBSVAREXH$clone()

The objects of this class are cloneable with this method.

Usage

StartingValuesBSVAREXH$clone(deep = FALSE)

Arguments

deep

Whether to make a deep clone.

Examples

# starting values for a bsvar model for a 3-variable system
A = matrix(TRUE, 3, 4)
B = matrix(TRUE, 3, 3)
sv = specify_starting_values_bsvar_exh$new(A = A, B = B, N = 3, p = 1, T = 100)


## ------------------------------------------------
## Method `StartingValuesBSVAREXH$get_starting_values()`
## ------------------------------------------------

# starting values for a homoskedastic bsvar with 1 lag for a 3-variable system
A = matrix(TRUE, 3, 4)
B = matrix(TRUE, 3, 3)
sv = specify_starting_values_bsvar_exh$new(A = A, B = B, N = 3, p = 1, T = 100)
sv$get_starting_values()   # show starting values as list


## ------------------------------------------------
## Method `StartingValuesBSVAREXH$set_starting_values()`
## ------------------------------------------------

# starting values for a bsvar model with 1 lag for a 3-variable system
A = matrix(TRUE, 3, 4)
B = matrix(TRUE, 3, 3)
sv = specify_starting_values_bsvar_exh$new(A = A, B = B, N = 3, p = 1, T = 100)

# Modify the starting values by:
sv_list = sv$get_starting_values()   # getting them as list
sv_list$A <- matrix(rnorm(12), 3, 4) # modifying the entry
sv$set_starting_values(sv_list)      # providing to the class object

bsvars documentation built on Aug. 22, 2026, 5:09 p.m.