Description Usage Arguments Details Value Author(s) References Examples
Point forecasts and the respective forecasting intervals for autoregressive movingaverage (ARMA) models can be calculated, the latter under the assumption of normally distributed innovations, by means of this function.
1 2 3 4 5 6 7 8 9 10 
X 
a numeric vector that contains the time series that is assumed to follow an ARMA model ordered from past to present. 
p 
an integer value >= 0 that defines the AR order p of the
underlying ARMA(p,q) model within 
q 
an integer value >= 0 that defines the MA order q of the
underlying ARMA(p,q) model within 
include.mean 
a logical value; if set to 
h 
an integer that represents the forecasting horizon; if n is
the number of observations, point forecasts and forecasting intervals will be
obtained for the time points n + 1 to n + h; is set to 
alpha 
a numeric vector of length 1 with 0 < 
plot 
a logical value that controls the graphical output; for

... 
additional arguments for the standard plot function, e.g.,

This function is part of the smoots
package and was implemented under
version 1.1.0. For a given time series X_[t], t = 1, 2, ..., n,
the point forecasts and the respective forecasting intervals will be
calculated.
It is assumed that the series follows an ARMA(p,q) model
X_[t]  μ = ε_[t] + β_[1] (X_[t1]  μ) + ... + β_[p] (X_[tp]  μ) + α_[1] ε_[t1] + ... + α_[q] ε_[tq],
where α_[j] and β_[i] are real numbers (for i = 1, 2, .., p and j = 1, 2, ..., q) and ε_[t] are i.i.d. (identically and independently distributed) random variables with zero mean and constant variance. μ is equal to E(X_[t]).
The point forecasts and forecasting intervals for the future periods n + 1, n + 2, ..., n + h will be obtained. With respect to the point forecasts hat[X]_[n+k], where k = 1, 2, ..., h,
hat[X]_[n+k] = hat[μ] + sum_[i=1]^[p] {hat[β]_[i](X_[n+ki]  hat[μ])} + sum_[j=1]^[q] {hat[α]_[j]hat[ε]_[n+kj]}
with X_[n+ki] = hat[X]_[n+ki] for n+ki > n and hat[ε]_[n+kj] = E(ε_[t]) = 0 for n+kj > n will be applied.
The forecasting intervals on the other hand are obtained under the assumption of normally distributed innovations. Let q(c) be the 100cpercent quantile of the standard normal distribution. The 100apercent forecasting interval at a point n + k, where k = 1, 2, ..., h, is given by
[hat[X]_[n+k]  q(a_[r])s_[k], hat[X]_[n+k] + q(a_[r])s_[k]]
with s_[k] being the standard deviation of the forecasting error at the time point n + k and with a_[r] = 1  (1  a)/2. For ARMA models with normal innovations, the variance of the forecasting error can be derived from the MA(infinity) representation of the model. It is
σ_[ε] ^[2] * sum_[i=0]^[k1] {d_[i]^[2]},
where d_[i] are the coefficients of the MA(infinity) representation and σ_[ε]^[2] is the innovation variance.
The function normCast
allows for different adjustments to
the forecasting progress. At first, a vector with the values of the observed
time series ordered from past to present has to be passed to the argument
X
. Orders p and q of the underlying ARMA process can be
defined via the arguments p
and q
. If only one of these orders
is inserted by the user, the other order is automatically set to 0
. If
none of these arguments are defined, the function will choose orders based on
the Bayesian Information Criterion (BIC) for 0 ≤
p,q ≤ 5. Via the logical argument include.mean
the user can decide,
whether to consider the mean of the series within the estimation process.
Furthermore, the argument h
allows for the definition of the maximum
future time point n + h. Point forecasts and forecasting intervals will
be returned for the time points n + 1 to n + h. Another argument
is alpha
, which is the equivalent of the confidence level considered
within the calculation of the forecasting intervals, i.e., the quantiles
(1  alpha
)/2 and
1  (1  alpha
)/2 of the
forecasting intervals will be obtained.
For simplicity, the function also incorporates the possibility to directly
create a plot of the output, if the argument plot
is set to
TRUE
. By the additional and optional arguments ...
, further
arguments of the standard plot function can be implemented to shape the
returned plot.
NOTE:
Within this function, the arima
function of the
stats
package with its method "CSSML"
is used throughout
for the estimation of ARMA models.
The function returns a 3 by h matrix with its columns
representing the future time points and the point forecasts, the lower
bounds of the forecasting intervals and the upper bounds of the
forecasting intervals as the rows. If the argument plot
is set to
TRUE
, a plot of the forecasting results is created.
Dominik Schulz (Research Assistant) (Department of Economics, Paderborn
University),
Package Creator and Maintainer
Feng, Y., Gries, T. and Fritz, M. (2020). Datadriven local polynomial for the trend and its derivatives in economic time series. Journal of Nonparametric Statistics, 32:2, 510533.
Feng, Y., Gries, T., Letmathe, S. and Schulz, D. (2019). The smoots package in R for semiparametric modeling of trend stationary time series. Discussion Paper. Paderborn University. Unpublished.
Feng, Y., Gries, T., Fritz, M., Letmathe, S. and Schulz, D. (2020). Diagnosing the trend and bootstrapping the forecasting intervals using a semiparametric ARMA. Discussion Paper. Paderborn University. Unpublished.
Fritz, M., Forstinger, S., Feng, Y., and Gries, T. (2020). Forecasting economic growth processes for developing economies. Unpublished.
1 2 3 4 5 6 7 8 9 10 11 12 13 14  ### Example 1: Simulated ARMA process ###
# Simulation of the underlying process
n < 2000
n.start = 1000
set.seed(21)
X < arima.sim(model = list(ar = c(1.2, 0.7), ma = 0.63), n = n,
rand.gen = rnorm, n.start = n.start) + 7.7
# Application of normCast()
result < normCast(X = X, p = 2, q = 1, include.mean = TRUE, h = 5,
plot = TRUE, xlim = c(1971, 2005), col = "deepskyblue4",
type = "b", lty = 3, pch = 16, main = "Exemplary title")
result

Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.