Compute lagged or leading values — leadx-lagx • transx

Find the "previous" (lagx()) or "next" (leadx()) values in a vector. Useful for comparing values behind of or ahead of the current values.

lagx(x, n = 1L, fill = NA)

leadx(x, n = 1L, fill = NA)

Arguments

x	`[univariate vector]` Univariate vector, numeric or ts object with only one dimension.
n	`[positive integer(1): 1L]` Value indicating the number of positions to lead or lag by.
fill	`[numeric or function: NA]` Numeric value(s) or function used to fill observations.

[univariate vector]

Univariate vector, numeric or ts object with only one dimension.

[positive integer(1): 1L]

Value indicating the number of positions to lead or lag by.

fill

[numeric or function: NA]

Numeric value(s) or function used to fill observations.

Value

Returns a vector with the same class and attributes as the input vector.

Details

This functions has been taken and modified from the dplyr package, however, to reduce dependencies they are not imported.

Examples


x <- c(5,3,2,2,5)
lagx(x)
#> [1] NA  5  3  2  2
lagx(x, fill = mean)
#> [1] 3 5 3 2 2
lagx(x, fill = fill_nocb)
#> [1] 5 5 3 2 2

leadx(x)
#> [1]  3  2  2  5 NA
leadx(x, fill = fill_locf)
#> [1] 3 2 2 5 5