title	author	date	output	editor_options
canClimateData	Alex Chubaty	17 February 2022	html_document df_print keep_md paged true	chunk_output_type console

Overview

Prepare Canadian historic and projected climate data for use with LandR.CS and fireSense.

Currently supports study areas in AB, BC, SK, MB, ON, QC, NT, and YT, for some CMIP6 climate scenarios (see below).

Parameters

Provide a summary of user-visible parameters.

paramName	paramClass	default	min	max	paramDesc
.plotInitialTime	numeric	NA	NA	NA	Describes the simulation time at which the first plot event should occur.
.plotInterval	numeric	NA	NA	NA	Describes the simulation time interval between plot events.
.saveInitialTime	numeric	NA	NA	NA	Describes the simulation time at which the first save event should occur.
.saveInterval	numeric	NA	NA	NA	This describes the simulation time interval between save events.
.useCache	logical	FALSE	NA	NA	Should this entire module be run with caching activated? This is generally intended for data-type modules, where stochasticity and time are not relevant
bufferDist	numeric	20000	NA	NA	Distance (m) to buffer studyArea and rasterToMatch when creating 'Large' versions.
climateGCM	character	CNRM-ESM2-1	NA	NA	Global Circulation Model to use for climate projections: currently '13GCMs_ensemble', 'CanESM5', 'CNRM-ESM2-1', or 'CCSM4'.
climateSSP	numeric	370	NA	NA	SSP emissions scenario for `climateGCM`: one of 245, 370, or 585.[If using 'climateGCM = CCSM4', climateSSP must be one of 45 or 85.]
historicalFireYears	numeric	1991, 19....	NA	NA	range of years captured by the historical climate data
projectedFireYears	numeric	2011, 20....	NA	NA	range of years captured by the projected climate data
studyAreaName	character	RIA	NA	NA	One of 'AB', 'BC', 'MB', 'NT', 'ON', 'QC', 'SK', 'YT', or 'RIA'.

Events

This module consists of a single init event that performs all the data preparation.

Data dependencies

Input data

objectName	objectClass	desc	sourceURL
rasterToMatch	RasterLayer	template raster	NA
rasterToMatchLarge	RasterLayer	template raster for larger area	NA
rasterToMatchReporting	RasterLayer	template raster for reporting area	NA
studyArea	SpatialPolygonsDataFrame	study area used for simulation (buffered to mitigate edge effects)	NA
studyAreaLarge	SpatialPolygonsDataFrame	study area used for module parameterization (buffered)	NA
studyAreaReporting	SpatialPolygonsDataFrame	study area used for reporting/post-processing	NA

Historic and projected climate data

Prerequisites

1. DEM from GEOTOPO15 product
2. Climate data using ClimateNA with projected climate scenario(s).

Available data sets

studyArea	GCM	SSP
AB	13GCMs_ensemble	245
AB	13GCMs_ensemble	370
AB	13GCMs_ensemble	585
AB	CanESM5	245
AB	CanESM5	370
AB	CanESM5	585
AB	CCSM4	45
AB	CCSM4	85
AB	CNRM-ESM2-1	245
AB	CNRM-ESM2-1	370
AB	CNRM-ESM2-1	585
BC	13GCMs_ensemble	245
BC	13GCMs_ensemble	370
BC	13GCMs_ensemble	585
BC	CanESM5	245
BC	CanESM5	370
BC	CanESM5	585
BC	CCSM4	45
BC	CCSM4	85
BC	CNRM-ESM2-1	245
BC	CNRM-ESM2-1	370
BC	CNRM-ESM2-1	585
MB	13GCMs_ensemble	245
MB	13GCMs_ensemble	370
MB	13GCMs_ensemble	585
MB	CanESM5	245
MB	CanESM5	370
MB	CanESM5	585
MB	CCSM4	45
MB	CCSM4	85
MB	CNRM-ESM2-1	245
MB	CNRM-ESM2-1	370
MB	CNRM-ESM2-1	585
NT	13GCMs_ensemble	245
NT	13GCMs_ensemble	370
NT	13GCMs_ensemble	585
NT	CanESM5	245
NT	CanESM5	370
NT	CanESM5	585
NT	CCSM4	45
NT	CCSM4	85
NT	CNRM-ESM2-1	245
NT	CNRM-ESM2-1	370
NT	CNRM-ESM2-1	585
ON	13GCMs_ensemble	245
ON	13GCMs_ensemble	370
ON	13GCMs_ensemble	585
ON	CanESM5	245
ON	CanESM5	370
ON	CanESM5	585
ON	CCSM4	45
ON	CCSM4	85
ON	CNRM-ESM2-1	245
ON	CNRM-ESM2-1	370
ON	CNRM-ESM2-1	585
QC	CanESM5	370
RIA	13GCMs_ensemble	245
RIA	13GCMs_ensemble	370
RIA	13GCMs_ensemble	585
RIA	CanESM5	245
RIA	CanESM5	370
RIA	CanESM5	585
RIA	CCSM4	45
RIA	CCSM4	85
RIA	CNRM-ESM2-1	245
RIA	CNRM-ESM2-1	370
RIA	CNRM-ESM2-1	585
SK	13GCMs_ensemble	245
SK	13GCMs_ensemble	370
SK	13GCMs_ensemble	585
SK	CanESM5	245
SK	CanESM5	370
SK	CanESM5	585
SK	CCSM4	45
SK	CCSM4	85
SK	CNRM-ESM2-1	245
SK	CNRM-ESM2-1	370
SK	CNRM-ESM2-1	585
YT	13GCMs_ensemble	245
YT	13GCMs_ensemble	370
YT	13GCMs_ensemble	585
YT	CanESM5	245
YT	CanESM5	370
YT	CanESM5	585
YT	CCSM4	45
YT	CCSM4	85
YT	CNRM-ESM2-1	245
YT	CNRM-ESM2-1	370
YT	CNRM-ESM2-1	585

Additional data sets

Other study areas and/or climate scenarios can be added by making suitable .zip archives available via Google Drive and updating the climateDataURLs.csv file accordingly.

NOTE: the following naming conventions should be used for the .zip archives:

Description	Archive.Filename
Historic normals: 1951-1980Y and 1981_2010Y	studyAreaNameLong_normals.zip
Historic monthly: 1991-2020	studyAreaNameLong.zip
Projected annual: 2011-2100	climateGCM_climateSSP_studyAreaNameLong_annual,zip
Projected monthly: 2011-2100	climateGCM_climateSSP_studyAreaNameLong,zip

Output data

Description of the module outputs.

objectName	objectClass	desc
ATAstack	RasterStack	annual projected mean annual temperature anomalies, units stored as tenth of a degree
CMIstack	RasterStack	annual projected mean climate moisture deficit
CMInormal	RasterLayer	Climate Moisture Index Normals from 1950-2010
historicalClimateRasters	list	list of a single raster stack - historical MDC calculated from ClimateNA data
projectedClimateRasters	list	list of a single raster stack - projected MDC calculated from ClimateNA data

Links to other modules

Originally developed to provide inputs to gmcsDataPrep (for use with climate-sensitive LandR Biomass projections; see Biomass_core) and the fireSense suite of modules.