gets.logitx: General-to-Specific (GETS) Modelling of objects of class...

In gets: General-to-Specific (GETS) Modelling and Indicator Saturation Methods

General-to-Specific (GETS) Modelling of objects of class 'logitx'

Description

General-to-Specific (GETS) Modelling of a dynamic Autoregressive (AR) logit model with covariates ('X') of class 'dlogitx'.

Usage

## S3 method for class 'logitx'
gets(x, t.pval = 0.05, wald.pval = t.pval, do.pet = TRUE, 
    user.diagnostics = NULL, keep = NULL, include.gum = FALSE,
    include.1cut = TRUE, include.empty = FALSE, max.paths = NULL,
    turbo = TRUE, print.searchinfo = TRUE, plot = NULL, alarm = FALSE,
    ...) 

Arguments

x	an object of class 'logitx', see logitx
t.pval	numeric value between 0 and 1. The significance level used for the two-sided regressor significance t-tests
wald.pval	numeric value between 0 and 1. The significance level used for the Parsimonious Encompassing Tests (PETs). By default, it is the same as t.pval
do.pet	logical that determines whether a Parsimonious Encompassing Test (PET) against the GUM should be undertaken at each regressor removal for the joint significance of all the deleted regressors along the current path. If FALSE, then a PET is not undertaken at each regressor removal
user.diagnostics	NULL (default) or a list with two entries, name and pval, see getsFun
keep	NULL or a vector of integers that determines which regressors to be excluded from removal in the specification search
include.gum	logical that determines whether the GUM (i.e. the starting model) should be included among the terminal models. If FALSE (default), then the GUM is not included
include.1cut	logical that determines whether the 1-cut model should be added to the list of terminal models. If FALSE (default), then the 1-cut is not added, unless it is a terminal model in one of the paths
include.empty	logical that determines whether an empty model should be added to the list of terminal models, if it passes the diagnostic tests. If FALSE (default), then the empty model is not added, unless it is a terminal model in one of the paths
max.paths	NULL (default) or an integer greater than 0. If NULL, then there is no limit to the number of paths. If an integer (e.g. 1), then this integer constitutes the maximum number of paths searched (e.g. a single path)
turbo	logical. If TRUE (the default), then (parts of) paths are not searched twice (or more) unnecessarily, thus yielding a significant potential for speed-gain. The checking of whether the search has arrived at a point it has already been at comes with a slight computational overhead. So faster search is not guaranteed when turbo=TRUE
print.searchinfo	logical. If TRUE (default), then a print is returned whenever simiplification along a new path is started
plot	NULL or logical. If TRUE, then a plot is produced. If NULL (default), then the value set by options determines whether a plot is produced or not
alarm	logical. If TRUE, then a sound or beep is emitted (in order to alert the user) when the model selection ends
...	further arguments passed to or from other methods

Details

The model of class 'logitx' is a dynamic Autoregressive (AR) logit model with (optional) covariates ('X') proposed by Kauppi and Saikkonen (2008). Internally, gets.logitx undertakes the General-to-Specific (GETS) modelling with the getsFun function, see Sucarrat (2020).

Author(s)

Genaro Sucarrat, http://www.sucarrat.net/

References

Heikki Kauppi and Penti Saikkonen (2008): 'Predicting U.S. Recessions with Dynamic Binary Response Models'. The Review of Economic Statistics 90, pp. 777-791

See Also

logitx, logitxSim, coef.logitx, getsFun

Examples

##simulate from ar(1), create covariates:
set.seed(123) #for reproducibility
y <- logitxSim(100, ar=0.3)
x <- matrix(rnorm(5*100), 100, 5)

##estimate model:
mymod <- logitx(y, ar=1:4, xreg=x)

##do gets modelling:
gets(mymod)

gets documentation built on Sept. 11, 2024, 9:03 p.m.