2 LandRCBM_split3pools

This documentation is work in progress. Potential discrepancies and omissions may exist for the time being. If you find any, please contact us here.

2.1 Overview

The objective of this module is to make data coming from the LandR ecosystem compatible with the spadesCBM. The module provides the yearly increments for the three above ground biomass pools: merchantable, foliage, and other. It does so for the yield tables useful for the spinup event of spadesCBM, and for the yearly cohort data which is used for the annual event of spadesCBM. The module can also translate disturbances provided by disturbance modules into the format that is expected in spadesCBM.

2.2 Inputs

The inputs of LandRCBM_split3pools are a combination expected outputs from LandR, data to convert total above ground biomass into above merchantable, foliage and other biomass, and data that are expected as input in spadesCBM.

The default inputs are for the RIA study area. Most inputs are expected to be provided by other modules (CBMdefault, Biomass_core, Biomass_yieldTables, Biomass_borealDataPrep, etc.).

Name | Class | Description | Source |

2.3 Parameters

2.4 Module functioning

2.4.1 Events

There are 7 events:

  1. init: Splits the total above ground biomass in yield tables into biomass of each of the three above ground carbon pools.
  2. plotYC: Plots the yield tables split in above ground carbon pools and the resulting increments.
  3. annualIncrements: Each time step, compares the cohortData with previous year, calculates the difference in biomass for each cohort, and convert this difference into increments of the three above ground carbon pools.
  4. annualDisturbances: If specified, translates yearly disturbances simulated in other modules into a data.table that can be digested by CBM_core.
  5. summarizeAGBPools: Each time step, summarizes the above ground biomass in each above ground carbon pools for each species across the landscape.
  6. plotMaps: At a regular interval, maps the above ground biomass and increments of each above carbon pools.
  7. plotSummaries: At the end of the simulation, plots the evolution of the above ground biomass of each pools for each species and for the entire landscape.

2.4.2 Plotting

There are 3 types of plots that are created.

First, the modules plots figures related to the yield tables. The module returns a figure for the yield curves of total above ground biomass for a number (controlled by the parameter numPixGroupPlots) yield table ids. For the same yield table ids, the module also plots the yield tables divided into above ground carbon pools and the resulting increments.

Second, at a regular interval, controlled by the parameter .plotInterval, the modules returns maps of the biomass and increments of merchantable, foliage, and other carbon pools.

Third, at the end of the simulation, the modules returns figures of the evolution of the above ground biomass divided into pools across the landscape for each species.

2.4.3 Outputs

Name | Class | Description |