predict: Model Prediction

predict.tsissm.estimateR Documentation

Model Prediction

Description

Prediction function for class “tsissm.estimate”.

Usage

## S3 method for class 'tsissm.estimate'
predict(
  object,
  h = 12,
  newxreg = NULL,
  nsim = 1000,
  forc_dates = NULL,
  innov = NULL,
  innov_type = "q",
  init_states = NULL,
  exact_moments = TRUE,
  sigma_scale = NULL,
  ...
)

Arguments

object

an object of class “tsissm.estimate”.

h

the forecast horizon.

newxreg

a matrix of external regressors in the forecast horizon.

nsim

the number of simulations to use for generating the simulated predictive distribution.

forc_dates

an optional vector of forecast dates equal to h. If NULL will use the implied periodicity of the data to generate a regular sequence of dates after the last available date in the data.

innov

an optional vector of uniform innovations which will be translated to regular innovations using the appropriate distribution quantile function and model standard deviation. The length of this vector should be equal to nsim x horizon.

innov_type

if ‘innov’ is not NULL, then this denotes the type of values passed, with “q” denoting quantile probabilities (default and backwards compatible) and “z” for standardized errors.

init_states

an optional vector of states to initialize the forecast. If NULL, will use the last available state from the estimated model.

exact_moments

whether to rescale the mean and variance of the simulated distribution by their exact (analytic) moments. This is performed on the transformed data.

sigma_scale

a vector of length h denoting a scaling factor which is applied to rescale the standard deviation of each simulated horizon's distribution.

...

not currently used.

Details

Like all models in the ts framework, prediction is done by simulating h-steps ahead in order to build a predictive distribution.

Value

An object of class “tsissm.predict” which also inherits “tsmodel.predict”, with slots for the simulated prediction distribution, the original series (as a zoo object), the original specification object and the mean forecast. The predictive distribution is back transformed if lambda was not set to NULL in the specification.


tsmodels/tsissm documentation built on Oct. 15, 2022, 6:44 a.m.