relerr_sf {scoringfunctions}R Documentation

Relative error scoring function (MAE-PROP scoring function)

Description

The function relerr_sf computes the relative error scoring function when yy materializes and xx is the predictive med(1)(F)\textnormal{med}^{(1)}(F) functional.

The relative error scoring function is defined in Table 1 in Gneiting (2011).

The relative error scoring function is referred to as MAE-PROP scoring function in eq. (13) in Patton (2011).

Usage

relerr_sf(x, y)

Arguments

x

Predictive med(1)(F)\textnormal{med}^{(1)}(F) functional (prediction). It can be a vector of length nn (must have the same length as yy).

y

Realization (true value) of process. It can be a vector of length nn (must have the same length as xx).

Details

The relative error scoring function is defined by:

S(x,y):=(xy)/xS(x, y) := |(x - y)/x|

Domain of function:

x>0x > 0

y>0y > 0

Range of function:

S(x,y)0,x,y>0S(x, y) \geq 0, \forall x, y > 0

Value

Vector of relative errors.

Note

For details on the relative error scoring function, see Gneiting (2011).

The β\beta-median functional, med(β)(F)\textnormal{med}^{(\beta)}(F) is the median of a probability distribution whose density is proportional to yβf(y)y^\beta f(y), where ff is the density of the probability distribution FF of yy (Gneiting 2011).

The relative error scoring function is negatively oriented (i.e. the smaller, the better).

The relative error scoring function is strictly consistent for the med(1)(F)\textnormal{med}^{(1)}(F) functional relative to the family F\mathbb{F} of potential probability distributions (whose densities are proportional to yf(y)y f(y), where ff is the density of the probability distribution FF for the future yy) (see Theorems 5 and 9 in Gneiting 2011).

References

Gneiting T (2011) Making and evaluating point forecasts. Journal of the American Statistical Association 106(494):746–762. doi:10.1198/jasa.2011.r10138.

Patton AJ (2011) Volatility forecast comparison using imperfect volatility proxies. Journal of Econometrics 160(1):246–256. doi:10.1016/j.jeconom.2010.03.034.

Examples

# Compute the relative error scoring function.

df <- data.frame(
    y = rep(x = 2, times = 3),
    x = 1:3
)

df$relative_error <- relerr_sf(x = df$x, y = df$y)

print(df)

[Package scoringfunctions version 0.0.6 Index]