3 CBM_dataPrep_SK
This documentation is work in progress. Potential discrepancies and omissions may exist for the time being. If you find any, please contact us here.
3.1 Overview
CBM_dataPrep_SK processes study area-specific spatially explicit inputs for use in CBM_vol2biomass and CBM_core. SpaDES was designed for spatially explicit modelling and provides a wide variety of tools to support it. CBM_dataPrep_SK makes use of these tools. This module’s inputs are study area and scenario specific making CBM_dataPrep_SK the most idiosyncratic module of the spadesCBM deck, meaning that this is the module that will require users to adapt their available information for their study area. We use an example that simulates a scenario where remotely-sensed disturbances are simulated in the managed forests of Saskatchewan from 1985 to 2011, as described in Boisvenue et al. (2016) (scenario = time horizon + disturbances). We suggest that users wanting to run spadesCBM for their study-area modify this module, adapting their inputs to produce the outputs of CBM_dataPrep_SK. The module would then become CBM_dataPrep_NewStudyArea.
3.2 Inputs
| Name | Class | Description | Source |
|---|---|---|---|
| masterRaster | SpatRaster | Raster of study area | User provided, for SK: Google Drive |
| adminLocator | SpatRaster | Spatial data source of Canada’s administrative boundary names | Statistics Canada |
| ageLocator | SpatRaster | Spatial data source of stand age | for SK: 2012 CASFRI inventory |
| ageDataYear | Numeric | Year that the ages in ageLocator represent | 2012 CASFRI inventory |
| spsLocator | SpatRaster | Spatial data source of cohort species locations | 2012 CASFRI inventory |
| prodLocator | SpatRaster | Spatial data source of productivity class locations | For SK |
| userGcMeta | Data table | Growth curve metadata | User provided, for SK: Google Drive |
| userGcM3 | Data table | User provided growth curve data | Google Drive |
| disturbanceMeta | Data table | Table defining the disturbance event types | Google Drive |
3.3 Module functioning
CBM_dataPrep_SK has a single event used to read in user-provided information or provide study area specific defaults. By default, it sets the administrative boundary name, reads in and prepares default disturbance rasters for SK (Wulder and white), sets the study area by creating masterRaster, and reads in any study area specific rasters.
3.4 Outputs
| Name | Class | Description |
|---|---|---|
| masterRaster | SpatRaster | Raster of study area |
| adminLocator | Character | Spatial data source of Canada’s administrative boundary names |
| ageLocator | SpatRaster | Spatial data source of cohort ages or a single value to use for all cohorts |
| cohortLocators | List | List of values or spatial data sources |
| curveID | Character | Column(s) name(s) uniquely defining each growth curve |
| disturbanceRasters | list | Disturbance rasters for each simulation year |
| disturbanceMeta | Data table | Disturbance rasters metadata |