spadesCBM Overview
spadesCBM is a modular, transparent, and spatially explicit implementation of the logic, pools structure, equations, and default assumptions of the Carbon Budget Model of the Canadian Forest Sector (CBM). It applies the science presented in Kurz et al. (2009) in a similar way to the simulations in Boisvenue et al. (2016) and Boisvenue et al. (2022) but calls Python functions for annual processes (see libcbm_py/examples/cbm_exn). These functions and spadesCBM are, like much of modelling-based science, continuously under development.
The collection of SpaDES modules in spadesCBM was developed to enable R&D input to the Canadian Forest Service (CFS) forest carbon reporting system, NFCMARS, the National Forest Carbon Monitoring, Accounting, and Reporting system. The CFS provides science backing for Canadian policies on national forest issues. spadesCBM is a nimble tool in which new science, data and algorithms can be tested and explored to serve policy purposes. spadesCBM development follows the PERFICT approach of McIntire et al. (2022) for ecological modelling systems, an approach that helps solve many of the complex issues in ecological modelling, supports continuous workflows, and nimble, enter operable modelling systems. The SpaDES platform is the toolkit that enables this implementation of the PERFICT principle.
In-depth information on the functioning, structure, and science behind spadesCBM can be found in its manual. Similar to this website, it is a living document that is continually updated as the model evolves.
Modules
A standard run of spadesCBM requires five modules to run. However, only three of those are required to run LandRCBM, as study area processing and biomass growth increments are dealt with on the LandR side of the model. Here is a brief introduction to the three spadesCBM modules required to run LandRCBM.
CBM_defaults
This module provides R-based access to all defaults CBM parameters for the managed forests of Canada, akin to the Archive Index in the CBM-CFS3 documentation. Defaults for the managed forests of Canada include disturbance data such as different disturbance types and their IDs, spinup parameters, pool names, fire return intervals for each ecozone and more. By default, this module uses parameters that were created for use in CBM-CFS3 as described in Kurz et al. (2009). More information on this module can be found in its manual chapter.
CBM_dataPrep
This module processes spatially explicit inputs for use in CBM_core. It has several events each serving a specific data preparation task. These allow for study area spatial inputs to be processes into tables needed to run CBM_core, matches species and disturbance information to CBM-specific IDs, and reads in disturbance events for each simulation year. In-depth information on this module’s background and functioning can be found in its module chapter.
CBM_core
This is the central module of spadesCBM. This is where all the carbon transfers are calculated at every time step, where disturbances are applied, and stocks are tracked. This is the only module where Python functions are called. In this module the cohort and stand data is prepared and passed through a spinup function to initialize the carbon pools structure across the landscape. Disturbance and cohort data is then read it and prepared for carbon dynamics processing, where all carbon transfers are applied for each simulation year. This module also where spadesCBM plots and saves its results. More information on how the module functions and the science behind how carbon transfers are performed and calculated can be found in its module chapter.