greybox (version 2.0.2)

ME: Error measures

Description

Functions allow to calculate different types of errors for point and interval predictions:

1. ME - Mean Error,

2. MAE - Mean Absolute Error,

3. MSE - Mean Squared Error,

4. MRE - Mean Root Error (Kourentzes, 2014),

5. MIS - Mean Interval Score (Gneiting & Raftery, 2007),

6. MPE - Mean Percentage Error,

7. MAPE - Mean Absolute Percentage Error (See Svetunkov, 2017 for the critique),

8. MASE - Mean Absolute Scaled Error (Hyndman & Koehler, 2006),

9. RMSSE - Root Mean Squared Scaled Error (used in M5 Competition),

10. rMAE - Relative Mean Absolute Error (Davydenko & Fildes, 2013),

11. rRMSE - Relative Root Mean Squared Error,

12. rAME - Relative Absolute Mean Error,

13. rMIS - Relative Mean Interval Score,

14. sMSE - Scaled Mean Squared Error (Petropoulos & Kourentzes, 2015),

15. sPIS- Scaled Periods-In-Stock (Wallstrom & Segerstedt, 2010),

16. sCE - Scaled Cumulative Error,

17. sMIS - Scaled Mean Interval Score,

18. GMRAE - Geometric Mean Relative Absolute Error.

Usage

ME(holdout, forecast, na.rm = TRUE)
MAE(holdout, forecast, na.rm = TRUE)
MSE(holdout, forecast, na.rm = TRUE)
MRE(holdout, forecast, na.rm = TRUE)
MIS(holdout, lower, upper, level = 0.95, na.rm = TRUE)
MPE(holdout, forecast, na.rm = TRUE)
MAPE(holdout, forecast, na.rm = TRUE)
MASE(holdout, forecast, scale, na.rm = TRUE)
RMSSE(holdout, forecast, scale, na.rm = TRUE)
rMAE(holdout, forecast, benchmark, na.rm = TRUE)
rRMSE(holdout, forecast, benchmark, na.rm = TRUE)
rAME(holdout, forecast, benchmark, na.rm = TRUE)
rMIS(holdout, lower, upper, benchmarkLower, benchmarkUpper, level = 0.95,
  na.rm = TRUE)
sMSE(holdout, forecast, scale, na.rm = TRUE)
sPIS(holdout, forecast, scale, na.rm = TRUE)
sCE(holdout, forecast, scale, na.rm = TRUE)
sMIS(holdout, lower, upper, scale, level = 0.95, na.rm = TRUE)
GMRAE(holdout, forecast, benchmark, na.rm = TRUE)

Value

All the functions return the scalar value.

Arguments

holdout

The vector or matrix of holdout values.

forecast

The vector or matrix of forecasts values.

na.rm

Logical, defining whether to remove the NAs from the provided data or not.

lower

The lower bound of the prediction interval.

upper

The upper bound of the prediction interval.

level

The confidence level of the constructed interval.

scale

The value that should be used in the denominator of MASE. Can be anything but advised values are: mean absolute deviation of in-sample one step ahead Naive error or mean absolute value of the in-sample actuals.

benchmark

The vector or matrix of the forecasts of the benchmark model.

benchmarkLower

The lower bound of the prediction interval of the benchmark model.

benchmarkUpper

The upper bound of the prediction interval of the benchmark model.

Author

Ivan Svetunkov,

Details

In case of sMSE, scale needs to be a squared value. Typical one -- squared mean value of in-sample actuals.

If all the measures are needed, then measures function can help.

There are several other measures, see details of pinball and hm.

References

• Kourentzes N. (2014). The Bias Coefficient: a new metric for forecast bias https://kourentzes.com/forecasting/2014/12/17/the-bias-coefficient-a-new-metric-for-forecast-bias/

• Svetunkov, I. (2017). Naughty APEs and the quest for the holy grail. https://openforecast.org/2017/07/29/naughty-apes-and-the-quest-for-the-holy-grail/

• Fildes R. (1992). The evaluation of extrapolative forecasting methods. International Journal of Forecasting, 8, pp.81-98.

• Hyndman R.J., Koehler A.B. (2006). Another look at measures of forecast accuracy. International Journal of Forecasting, 22, pp.679-688.

• Petropoulos F., Kourentzes N. (2015). Forecast combinations for intermittent demand. Journal of the Operational Research Society, 66, pp.914-924.

• Wallstrom P., Segerstedt A. (2010). Evaluation of forecasting error measurements and techniques for intermittent demand. International Journal of Production Economics, 128, pp.625-636.

• Davydenko, A., Fildes, R. (2013). Measuring Forecasting Accuracy: The Case Of Judgmental Adjustments To Sku-Level Demand Forecasts. International Journal of Forecasting, 29(3), 510-522. tools:::Rd_expr_doi("10.1016/j.ijforecast.2012.09.002")

• Gneiting, T., & Raftery, A. E. (2007). Strictly proper scoring rules, prediction, and estimation. Journal of the American Statistical Association, 102(477), 359–378. tools:::Rd_expr_doi("10.1198/016214506000001437")

See Also

pinball, hm, measures

Examples

y <- rnorm(100,10,2)
testForecast <- rep(mean(y[1:90]),10)

MAE(y[91:100],testForecast)
MSE(y[91:100],testForecast)

MPE(y[91:100],testForecast)
MAPE(y[91:100],testForecast)

# Measures from Petropoulos & Kourentzes (2015)
MASE(y[91:100],testForecast,mean(abs(y[1:90])))
sMSE(y[91:100],testForecast,mean(abs(y[1:90]))^2)
sPIS(y[91:100],testForecast,mean(abs(y[1:90])))
sCE(y[91:100],testForecast,mean(abs(y[1:90])))

# Original MASE from Hyndman & Koehler (2006)
MASE(y[91:100],testForecast,mean(abs(diff(y[1:90]))))

testForecast2 <- rep(y[91],10)
# Relative measures, from and inspired by Davydenko & Fildes (2013)
rMAE(y[91:100],testForecast2,testForecast)
rRMSE(y[91:100],testForecast2,testForecast)
rAME(y[91:100],testForecast2,testForecast)
GMRAE(y[91:100],testForecast2,testForecast)

#### Measures for the prediction intervals
# An example with mtcars data
ourModel <- alm(mpg~., mtcars[1:30,], distribution="dnorm")
ourBenchmark <- alm(mpg~1, mtcars[1:30,], distribution="dnorm")

# Produce predictions with the interval
ourForecast <- predict(ourModel, mtcars[-c(1:30),], interval="p")
ourBenchmarkForecast <- predict(ourBenchmark, mtcars[-c(1:30),], interval="p")

MIS(mtcars$mpg[-c(1:30)],ourForecast$lower,ourForecast$upper,0.95)
sMIS(mtcars$mpg[-c(1:30)],ourForecast$lower,ourForecast$upper,mean(mtcars$mpg[1:30]),0.95)
rMIS(mtcars$mpg[-c(1:30)],ourForecast$lower,ourForecast$upper,
       ourBenchmarkForecast$lower,ourBenchmarkForecast$upper,0.95)

### Also, see pinball function for other measures for the intervals