resample_agb: Resample _allodb_ equations to calibrate new allometries

Description Usage Arguments Value See Also Examples

View source: R/resample_agb.R

Description

After attributing a weight to each equation in allodb using the weight_allom() function, equations are then resampled within their original DBH range using resample_agb(): the number of resampled values for each equation is proportional to its weight. It creates S3 objects of class "numeric".

Usage

1
2
3
4
5
6
7
8
9
resample_agb(
  genus,
  coords,
  species = NULL,
  new_eqtable = NULL,
  wna = 0.1,
  w95 = 500,
  nres = 10000
)

Arguments

genus

a character value, containing the genus (e.g. "Quercus") of the tree.

coords

a numeric vector of length 2 with longitude and latitude.

species

a character value, containing the species (e.g. "rubra") of the tree. Default is "NULL", when no species identification is available.

new_eqtable

Optional. An equation table created with the new_equations() function. Default is the original allodb equation table.

wna

a numeric vector, this parameter is used in the weight_allom() function to determine the dbh-related and sample-size related weights attributed to equations without a specified dbh range or sample size, respectively. Default is 0.1.

w95

a numeric vector, this parameter is used in the weight_allom() function to determine the value at which the sample-size-related weight reaches 95% of its maximum value (max=1). Default is 500.

nres

number of resampled values. Default is "1e4".

Value

An object of class "data.frame" of resampled DBHs and associated AGB from the equation table; the number of resampled DBHs is proportional to the weight provided by the weight_allom() function.

See Also

weight_allom(), new_equations().

Examples

1
2
3
4
5
resample_agb(
  genus = "Quercus",
  species = "rubra",
  coords = c(-78.2, 38.9)
)

forestgeo/allodb documentation built on Oct. 25, 2021, 9:33 p.m.