R: Last Observation Carried Forward

na.locf {zoo}

R Documentation

Last Observation Carried Forward

Description

Generic function for replacing each NA with the most recent non-NA prior to it.

Usage

na.locf(object, na.rm = TRUE, ...)
## Default S3 method:
na.locf(object, na.rm = TRUE, rev = FALSE, ...)

Arguments

`object`	an object.
`na.rm`	logical. Should leading `NA`s be removed?
`rev`	logical. Should the observations be reversed before applying LOCF? This corresponds to NOCB (next observation carried backward).
`...`	further arguments passed to methods.

Value

An object in which each NA in the input object is replaced by the most recent non-NA prior to it. If there are no earlier non-NAs then the NA is omitted (if na.rm = TRUE) or it is not replaced (if na.rm = FALSE).

Examples

az <- zoo(1:6)

bz <- zoo(c(2,NA,1,4,5,2))
na.locf(bz)
na.locf(bz, rev = TRUE)

cz <- zoo(c(NA,9,3,2,3,2))
na.locf(cz)