Access allometric models used in forest resource analysis, such as volume equations, taper equations, biomass models, among many others. Users are able to efficiently find and select allometric models suitable for their project area and use them in analysis. Additionally, 'allometric' provides a structured framework for adding new models to an open-source models repository.
allometric is an R package for predicting tree attributes with allometric models. Thousands of allometric models exist in the scientific and technical forestry literature, and allometric is a platform for archiving and using this vast array of models in a robust and structured format. Get started by going to the Installation section or the documentation website.
allometric also provides a structured language for adding models to the package. If you are interested in helping the developer in this process please refer to the Contributing a Model vignette.
In total allometric contains 2118 models across 64 publications, refer to the Current Status for a more complete view of available models.
Installation
Currently allometric can be installed via CRAN:
install.packages("allometric")
For the latest release version, please install directly from GitHub using devtools:
devtools::install_github("allometric/allometric")
Before beginning, make sure to install the models locally by running
library(allometric)
install_models()
This installs all available models from the public models repository.
Finally, load the models using the load_models() function into a variable:
allometric_models is a tibble dataframe. Each row represents one allometric model with various attributes. Users interact with this table the way they would with any other tibble.
For example, we can use dplyr to filter this table to find models for analysis. Let’s say I am interested in finding stem volume models for Tsuga heterophylla. First, let us filter the model_type to include only stem volume models
This example is very basic, and more complex search examples can be found in the load_models() documentation. Models can be searched not only by their taxonomic information, but also the types of measurements the models require, their geographic region, and other attributes. We highly encourage users review the linked examples for production use of allometric.
Using the Model
tsuga_poudel now represents an allometric model that can be used for prediction. We must next figure out how to use the model.
Using the standard output of tsuga_poudel we obtain a summary of the model form, the response variable, the needed covariates and their units, a summary of the model descriptors (i.e., what makes the model unique within the publication), and estimates of the parameters.
tsuga_poudel
#> Model Call:
#> vsia = f(dsob, hst)
#>
#> vsia [m3]: volume of the entire stem inside bark, including top and stump
#> dsob [cm]: diameter of the stem, outside bark at breast height
#> hst [m]: total height of the stem
#>
#> Parameter Estimates:
#> # A tibble: 1 × 3
#> a b c
#> <dbl> <dbl> <dbl>
#> 1 -9.98 1.96 0.925
#>
#> Model Descriptors:
#> # A tibble: 1 × 3
#> country region taxa
#> <list> <list> <list>
#> 1 <chr [2]> <chr [10]> <Taxa>
We can see from the Model Call section that tsuga_poudel will require two covariates called dsob, which refers to diameter outside bark at breast height, and hst, the height of the main stem. allometric uses a variable naming system to determine the names of response variables and covariates (refer to the Variable Naming System vignette).
Using the predict() method we can easily use the function as defined by providing values of these two covariates.
predict(tsuga_poudel, 12, 65)
#> 0.2868491 [m^3]
or we can use the prediction function with a data frame of values
The above example is a very basic use case for allometric. Please refer to the Common Inventory Use Cases vignette for more complex examples.
Current Status
In total allometric contains 2118 models across 64 publications.
category
AS
EU
NA
AF
OC
SA
biomass component
26
136
446
0
0
0
crown diameter
0
12
36
0
0
0
crown height
0
12
0
0
0
0
shrub biomass
0
19
0
0
0
0
shrub biomass increment
0
28
0
0
0
0
shrub diameter
0
39
0
0
0
0
shrub height
0
28
0
0
0
0
site index
0
0
55
0
0
0
stem height
7
0
346
12
2
17
stem volume
4
0
575
0
0
20
stump volume
0
0
64
0
0
0
taper
2
0
18
0
0
0
tree biomass
2
36
94
0
21
16
other
0
0
168
0
0
0
How Can I Help?
allometric is a monumental undertaking, and already several people have come forward and added hundreds of models. There are several ways to help out. The following list is ranked from the least to most difficult tasks.
Add missing publications as an Issue. We always need help finding publications to add. If you know of a publication that is missing, feel free to add it as an Issue and we will eventually install the models contained inside.
Find source material for a publication. Some publications are missing their original source material. Usually these are very old legacy publications. If you know where a publication might be found, or who to contact, leave a note on any of these issues.
Help us digitize publications. We always need help digitizing legacy reports, at this link you will find a list of reports that need manual digitization. These can be handled by anyone with Excel and a cup of coffee.
Learn how to install and write models. Motivated users can learn how to install models directly using the package functions and git pull requests. Users comfortable with R and git can handle this task.
