add_wood_density: Add wood density.

In forestgeo/fgeo.biomass: Calculate Biomass with the Best Available Allometries

Description

This function wraps some features of BIOMASS::getWoodDensity(), which you may see for more details and options. It estimates the wood density of the trees from their taxonomy or from their congeners using the global wood density database (Chave et al. 2009, Zanne et al. 2009) or any additional dataset. The resulting values of wood density can either be attributed to an individual at the level of a species, genus, or family.

Usage

add_wood_density(data, species, family = TRUE, region = "World")

Arguments

data	A ForestGEO-like census-dataframe.
species	A ForestGEO-like species-dataframe.
family	(optional) Vector of families. If set, the missing wood densities at the genus level will be attributed at family level if available.
region	Region (or vector of region) of interest of your sample. By default, Region is set to 'World', but you can restrict the WD estimates to a single region : AfricaExtraTrop: Africa (extra tropical) AfricaTrop: Africa (tropical) Australia: Australia AustraliaTrop: Australia (tropical) CentralAmericaTrop: Central America (tropical) China: China Europe: Europe India: India Madagascar: Madagascar Mexico: Mexico NorthAmerica: North America Oceania: Oceania SouthEastAsia: South-East Asia SouthEastAsiaTrop: South-East Asia (tropical) SouthAmericaExtraTrop: South America (extra tropical) SouthAmericaTrop: South America (tropical) World: World

Details

This function assigns to each taxon a species- or genus- level average if at least one wood density value at the genus level is available for that taxon in the reference database. If not, the mean wood density of the family (if family = TRUE).

As an estimate of the error associated with the wood density estimate, this function also provides the mean standard deviation value at the appropriate taxonomic level.

Value

A dataframe as that passed to data, but with additional columns giving taxonomic information, and the following wood density information (oven dry mass/fresh volume in g/cm^3):

• wd_mean: Mean wood density.

• wd_sd: Standard deviation of the wood density that can be used in error propagation (see sd_10 and AGBmonteCarlo()).

• wd_level: Level at which wood density has been calculated. Can be species, genus, family, dataset (mean of the entire dataset) or, if stand is set, the name of the stand (mean of the current stand).

References

Rejou-Mechain M, Tanguy A, Piponiot C, Chave J, Herault B (2017). “BIOMASS : an R package for estimating above-ground biomass and its uncertainty in tropical forests.” Methods in Ecology and Evolution, 8(9). ISSN 2041210X, doi: 10.1111/2041-210X.12753 (URL: http://doi.org/10.1111/2041-210X.12753), <URL: http://doi.wiley.com/10.1111/2041-210X.12753>.

See Also

BIOMASS::getWoodDensity

Examples

tree <- fgeo.biomass::scbi_stem_tiny_tree
species <- fgeo.biomass::scbi_species
add_wood_density(tree, species)

forestgeo/fgeo.biomass documentation built on June 8, 2019, 10:47 p.m.