
Ensemble projections of range shifts
geo-shift-ensemble.RdClimate projections differ between climate models (GCMs), emission scenarios (SSPs) and, on mountains, the lapse rate used to bring coarse climate down to the terrain. A single projection hides this uncertainty. These functions run a range-shift model over every member of an ensemble and report the results as probabilities:
geo_climate_scenarios()builds the ensemble of climates on a fine DEM: for each GCM, SSP and lapse rate, the baseline CHELSA climate is downscaled withgeo_downscale_lapse()and the change projected by the GCM (future minus baseline, the delta method) is added, so every member shares the observed baseline.geo_shift_ensemble()predicts suitability for the present and every member with a niche model (such assdm_integrated()), simulates colonisation and extinction withgeo_shift_simulate(), and also reports the unlimited-dispersal range (all habitat with suitability at or above the starting threshold) for comparison.summary()gives, per scenario and dispersal assumption, the median and range of the change in range area across members, and the probability that the range shrinks by more than set thresholds.
Usage
geo_climate_scenarios(
area,
dem,
variables = "bio1",
period = "2071-2100",
gcm = c("mpi-esm1-2-hr", "ukesm1-0-ll"),
ssp = c("ssp126", "ssp585"),
lapse_rates = 5,
temperature = grep("^bio([1-9]|1[01])$", variables, value = TRUE),
reader = geo_chelsa_area
)
geo_shift_ensemble(
model,
scenarios,
initial = 0.5,
dispersal_mean,
steps = 10,
nsim = 50,
seed = NULL,
elevation = NULL,
rescale = TRUE,
...
)
# S3 method for class 'tmr_shift_ensemble'
summary(object, loss = c(30, 50, 80), ...)Arguments
- area, dem
Area to read and fine elevation
SpatRaster(metres).- variables
CHELSA temperature variables to downscale (e.g.
"bio1","bio5"); others (e.g."bio12") are only resampled.- period
Future period (see
geo_chelsa_area()).- gcm, ssp
GCMs and scenarios.
- lapse_rates
Lapse rates (degrees C per km) to try.
- temperature
Which of
variablesare temperatures (downscaled with the lapse rate); default bio1 to bio11 (the temperature variables).- reader
Function used to read CHELSA (for testing).
- model
A niche model with a
predict()method returning the probability of presence for aSpatRasterof covariates (such assdm_integrated()), or a function taking aSpatRasterand returning one of suitability (0 to 1).- scenarios
Result of
geo_climate_scenarios(), or a list withcurrent(oneSpatRaster, or one per lapse rate) andmembers(a named list ofSpatRasters) and optionallydesign.- initial
Initial occupancy, as in
geo_shift_simulate(); by default the present suitability above 0.5.- dispersal_mean, steps, nsim, seed, ...
Passed to
geo_shift_simulate();stepsis the number of dispersal generations between the present and the future period.- elevation
Optional elevation
SpatRasterfor range edges.- rescale
Divide suitability by its maximum under the present climate (of that lapse rate), so the best present habitat is 1? Niche models give the probability of presence in a plot of some size, which is rarely close to 1; the simulation treats suitability as the per-generation persistence, so unscaled probabilities make most populations die out. Default
TRUE.- object
A
geo_shift_ensemble()result.- loss
Range-loss thresholds (%) for the probabilities.
Value
geo_climate_scenarios(): a named list with current (a
SpatRaster per lapse rate, in list current) and members, a named
list of SpatRasters, one per GCM x SSP x lapse rate, with layers
named after variables; and a tibble design of the members.
geo_shift_ensemble(): an object of class tmr_shift_ensemble
with results, a tibble with one row per member and dispersal
assumption ("limited", "unlimited"): member, gcm, ssp,
lapse_rate, dispersal, area_now, area_future, change (%) and,
with elevation, the shift of the lower edge, median and upper edge
(m); and occupancy, the future occupancy (or suitability) rasters.
summary(): a tibble per ssp (if known) and dispersal:
number of members, median, minimum and maximum change (%), and
p_loss_<x>, the share of members losing more than x% of the range.