Skip to content

Create a GRM Analysis Specification

Construct a GRMAnalysis object for use with eval_handler(). GRM analysis is a specification meant to support the estimation of growth, removals, and mortality (GRM) attributes. In contrast, status_analysis() is a specification meant to support the estimation of the current status of, particularly, tree- and condition-oriented attributes. Most GRM population parameters can be estimated under this specification. Generally users should seek to employ evaluations ending with 03, indicating an evaluation engineered for GRM analysis.

Internally, this constructor validates the requested tree and land bases, builds component rules for those bases, and stores them in a GRMAnalysis S4 object. When an evaluation handler uses the object, its methods build lazy dplyr queries for current and prior plot, condition, and tree records, along with GRM begin, midpoint, and component tables. These queries are joined into a tree-history query, with required component columns selected according to the configured tree basis. Aggregation methods parse tree, condition, or tree-history attributes and return lazy aggregate queries.

grm_analysis(tree_basis = "all_live", land_basis = "forest_land")
  • tree_basis: Tree basis preset. One of all_live, growing_stock, or sawtimber.
  • land_basis: Land basis preset. One of forest_land or timberland.

A GRMAnalysis object.

handler <- eval_handler(con, 501103, spec = grm_analysis())