Function forecasting::MovingAverage(dataValues, estimates, noObservations, noAveragingPeriods, ErrorMeasures, Residuals)

forecasting::MovingAverage

The moving average procedure is a time series forecasting procedure. Essentially, this procedure forecasts by taking the average over the last \(N\) observations.

Mathematical Formulation

Using the notation for observations and estimates given in Time Series Forecasting Notation, the estimates are defined as:

\[\begin{split}e_t = \sum_{\tau=t-1-N}^{t-1} {\tilde y}_\tau / N \mspace{4mu}\mspace{4mu}\mspace{4mu} \textrm{ where } {\tilde y}_\tau = \left\{ \begin{array}{ll} y_1 & \textrm{ if } \tau < 1 \\ y_\tau & \textrm{ if } \tau \in \{1 .. T \} \\ e_\tau & \textrm{ if } \tau > T \end{array} \right.\end{split}\]

Function Prototype

To provide the error measures and residuals only when you need them, there are three flavors of the MovingAverage procedure provided:

forecasting::MovingAverage(    ! Provides the estimates, but not the
                                ! error measures nor the residuals
        dataValues,              ! Input, parameter indexed over time set
        estimates,               ! Output, parameter indexed over time set
        noObservations,          ! Scalar input, length history
        noAveragingPeriods)      ! Scalar input, averaging length

forecasting::MovingAverageEM(  ! Provides estimates and error measures,
                                ! but not the residuals
        dataValues,              ! Input, parameter indexed over time set
        estimates,               ! Output, parameter indexed over time set
        noObservations,          ! Scalar input, length history
        noAveragingPeriods,      ! Scalar input, averaging length
        ErrorMeasures)           ! Output, indexed over forecasting::ems

forecasting::MovingAverageEMR( ! Provides estimates, error measures,
                                ! and residuals
        dataValues,              ! Input, parameter indexed over time set
        estimates,               ! Output, parameter indexed over time set
        noObservations,          ! Scalar input, length history
        noAveragingPeriods,      ! Scalar input, averaging length
        ErrorMeasures,           ! Output, indexed over forecasting::ems
        Residuals)               ! Output, parameter indexed over time set

Here, the time set is a set that encompasses both the history and the horizon.

Arguments

dataValues

A one dimensional parameter containing the observations for the first \(T\) elements of the time set.

estimates

A one dimensional parameter containing the estimates for all elements in the time set.

noObservations

Specifies the number of elements that belong to the history of the time set. This parameter corresponds to \(T\) in the notation presented in Time Series Forecasting Notation.

noAveragingPeriods

Specifies the number of values used to compute a single average. This parameter corresponds to \(N\) in the mathematical notation above.

ErrorMeasures

The error measures as presented in Time Series Forecasting Notation.

Residuals

The residuals as presented in Time Series Forecasting Notation.

Note

In order to use this function, the Forecasting system library needs to be added to the application.

Example

To further understand about this procedure and library, please use the Demand Forecasting example.