rFIA (version 0.1.1)

findEVALID: Find EVALIDs used in the FIADB

Description

Lookup Evaluation IDs (EVALIDs) associated with reporting years and evaluation types used in the Forest Inventory and Analysis Database. NOT required to run other rFIA functions. Only use if you are interested in subsetting an FIA.Database object for a specific reporting year or evaluation type using clipFIA.

Usage

findEVALID(db, mostRecent = FALSE, state = NULL, year = NULL, type = NULL)

Arguments

db

list; FIA Database object produced from readFIA.

mostRecent

logical; if TRUE, returns EVALIDs associated with most recent inventory.

state

character vector containing full names of states of interest (e.g. c('Michigan', 'Minnesota', 'Wisconsin'))

year

numeric vector containing years of interest (e.g. c(2015, 2016, 2017))

type

character ('ALL', 'CURR', 'VOL', 'GROW', 'MORT', 'REMV', 'CHANGE', 'DWM', 'REGEN'). See Reference Population Evaluation Table Description Type Table in FIADB P2 User Guide (References) for descriptions of evaluation types.

Value

A numeric vector containing the EVALIDs associated with states, years, or evaluation types specified.

Details

EVALIDs in the FIA Database are used to reference data points associated with particular inventory years and evaluation types within a state (e.g. 2017 Current Volume in Michigan). They are often extraordinarily confusing for those not familiar for the FIA Database. With this in mind, rFIA has been designed to eliminate users dependence on identifying and specifying appropriate EVALIDs to produce desired estimates, and we therefore do not recommend users attempt to identify EVALIDs independently.

Any state or year specified must be present in db to return associated EVALIDS.

References

FIA Database User Guide: https://www.fia.fs.fed.us/library/database-documentation/

See Also

clipFIA

Examples

# NOT RUN {
## Lookup all EVALIDs in an FIA.Database object
findEVALID(fiaRI)

## Find the most recent EVALIDs
findEVALID(fiaRI, mostRecent = FALSE)

# }