mdl {mbreaks} | R Documentation |
Comprehensive structural change estimation and testing
Description
'mdl()' calls main functions of the 'mbreaks' package to execute the following estimation procedures:
- 'dotest()'
Function
dotest
conducts Sup F tests of '0' versus 'm' breaks and Double Max tests.- 'doseqtests()'
Function
doseqtests
conducts the sequential Sup F tests of 'l' versus 'l+1' breaks.- 'doorder()'
Function
doorder
conducts the number of breaks selection from '1' to 'm' breaks using the following information critera:KT
,BIC
, andLWZ
.- 'dosequa()'
Function
dosequa
conducts the number of breaks selection by sequential tests from '1' to 'm' breaks using sequential Sup F tests.- 'dofix()'
Function
dofix
conducts structural break model estimation with 'fixn' breaks.
All the procedures automatically identify if the 'model' is either i) pure structural breaks model or ii) partial structural breaks model
Usage
mdl(
y_name,
z_name = NULL,
x_name = NULL,
data,
eps1 = 0.15,
m = 5,
prewhit = 1,
robust = 1,
hetdat = 1,
hetvar = 1,
hetomega = 1,
hetq = 1,
maxi = 10,
eps = 1e-05,
fixn = -1,
fixb = 0,
betaini = 0,
printd = 0,
const = 1,
signif = 2,
h = NULL
)
Arguments
y_name |
name of dependent variable in the data set. |
z_name |
name of independent variables in the data set which coefficients are allowed to change
across regimes. |
x_name |
name of independent variables in the data set which coefficients are constant across
regimes. |
data |
the data set for estimation. |
eps1 |
value of trimming (in percentage) for the construction
and critical values. Minimal segment length 'h' will be set
at
The default value is set at |
m |
Maximum number of structural changes allowed. If not specify,
m will be set to |
prewhit |
set to |
robust |
set to |
hetdat |
option for the construction of the F tests. Set to 1 if want to
allow different moment matrices of the regressors across segments.
If |
hetvar |
option for the construction of the F tests.Set to |
hetomega |
used in the construction of the confidence intervals for the break
dates. If |
hetq |
used in the construction of the confidence intervals for the break
dates. If |
maxi |
number of maximum iterations for recursive calculations of finding
global minimizers. |
eps |
convergence criterion for recursive calculations (For partial change model ONLY) |
fixn |
number of pre-specified breaks. |
fixb |
option to use fixed initial input |
betaini |
Initial |
printd |
Print option for model estimation. |
const |
indicates whether the regression model include an intercept changing across regimes. Default value is 1. |
signif |
significance level used to sequential test to select number of breaks.
|
h |
Minimum segment length of regime considered in estimation. If users want to specify a particular value, please set 'eps1=0' |
Value
A list that contains the following:
- sbtests
A list of class 'sbtests' representing Sup F tests of 0 versus m breaks and Double Max tests.
- seqtests
A list of class 'seqtests' representing sequential Sup F test of l versus l+1 breaks.
- BIC
A list of class 'model' with structural break model estimated by number of breaks by
BIC
criterion.- LWZ
A list of class 'model' with structural break model estimated by number of breaks by
LWZ
criterion.- KT
A class 'model' with structural break model estimated by number of breaks by
KT
criterion.- sequa
A class 'model' with structural break model estimated by number of breaks by sequential tests.
- fix
A class 'model' with structural break model estimated by pre-specified 'fixn' number of breaks.
Note: All default
values of error assumptions (robust
,
hetdat
, hetvar
, hetq
) are set to 1. The implications on
the structure of model\'s errors related to individual settings are explained within
the arguments section for each option.
See Also
dotest
, doseqtests
, doorder
, dosequa
, and dofix
which are functions called by 'mdl()'.
Examples
US_rate = mdl('rate',data=real)
nkpc_lbs = mdl('inf',c('inflag','lbs','inffut'),data=nkpc,prewhit = 0)