Skip to contents

This function modifies the original equation table to be used in other functions of the package including: subset the original equation table, add new equations, and choose whether to include equations with a height allometry.


  subset_taxa = "all",
  subset_climate = "all",
  subset_region = "all",
  subset_ids = "all",
  subset_output = c("Total aboveground biomass", "Whole tree (above stump)"),
  new_taxa = NULL,
  new_allometry = NULL,
  new_coords = NULL,
  new_min_dbh = NULL,
  new_max_dbh = NULL,
  new_sample_size = NULL,
  new_unit_dbh = "cm",
  new_unit_output = "kg",
  new_input_var = "DBH",
  new_output_var = "Total aboveground biomass",
  use_height_allom = TRUE



character vector with taxa to be kept. Default is "all", in which case all taxa are kept.


character vector with Koppen climate classification to be kept. Default is "all", in which case all climates are kept.


character vector with name of location(s) or country(ies) or broader region(s) (eg. "Europe", "North America") to be kept. Default is "all", in which case all regions/countries are kept.


character vector with equation IDs to be kept. Default is "all", in which case all equations are kept.


What dependent variable(s) should be provided in the output? Default is "Total aboveground biomass" and "Whole tree (above stump)", other possible values are: "Bark biomass", "Branches (dead)", "Branches (live)", "Branches total (live, dead)", "Foliage total", "Height", "Leaves", "Stem (wood only)", "Stem biomass", "Stem biomass (with bark)", "Stem biomass (without bark)", "Whole tree (above and belowground)". Be aware that currently only a few equations represent those other variables, so estimated values might not be very accurate.


character string or vector specifying the taxon (or taxa) for which the allometry has been calibrated.


a character string with the allometric equation.


a vector or matrix of coordinates (longitude, latitude) of the calibration data.


numerical value, minimum DBH for which the equation is valid (in cm). Default is NULL (nothing is added).


numerical value, maximum DBH for which the equation is valid (in cm). Default is NULL (nothing is added).


number of measurements with which the allometry was calibrated. Default is NULL (nothing is added).


character string with unit of DBH in the equation (either cm, mm or inch). Default is "cm".


character string with unit of equation output (either "g", "kg", "Mg" or "lbs" if the output is a mass, or "m" if the output is a height).


independent variable(s) needed in the allometry. Default is "DBH", other option is "DBH, H".


dependent variable estimated by the allometry. Default is "Total aboveground biomass".


a logical value. In allodb we use Bohn et al. (2014) for European sites. User need to provide height allometry when needed to calculate AGB. Default is TRUE.


An object of class "data.frame" of new equations.


  new_taxa = "Faga",
  new_allometry = "exp(-2+log(dbh)*2.5)",
  new_coords = c(-0.07, 46.11),
  new_min_dbh = 5,
  new_max_dbh = 50,
  new_sample_size = 50
#> # A tibble: 478 × 15
#>    equation_id equation_taxa           equation_allometry   independent_variable
#>    <chr>       <chr>                   <chr>                <chr>               
#>  1 726f1d      Larix laricina          10^(2.648+0.715*(lo… DBH                 
#>  2 a4d879      Acer saccharum          10^(1.2315+1.6376*(… DBH                 
#>  3 b9ebe4      Alnus rubra             exp(5.13118+2.15046… DBH                 
#>  4 5e2dea      Viburnum lantanoides    29.615*((1.488+1.19… DBH                 
#>  5 21800b      Pinus strobus           exp(5.2831+2.0369*l… DBH                 
#>  6 1257b1      Abies                   exp(3.1689+2.6825*l… DBH                 
#>  7 9e2124      Populus davidiana       10^(1.826+2.558*(lo… DBH                 
#>  8 74d0ce      Ostrya virginiana       exp(4.89+2.3*log(db… DBH                 
#>  9 94f593      Liriodendron tulipifera 10^(0.8306+1.527*(l… DBH                 
#> 10 8c94e8      Nyssa sylvatica         10^(1.1468+1.4806*(… DBH                 
#> # ℹ 468 more rows
#> # ℹ 11 more variables: dependent_variable <chr>, long <chr>, lat <chr>,
#> #   koppen <chr>, dbh_min_cm <dbl>, dbh_max_cm <dbl>, sample_size <dbl>,
#> #   dbh_units_original <chr>, dbh_unit_cf <dbl>, output_units_original <chr>,
#> #   output_units_cf <dbl>