region_series: Extract a time series of climate variables for a region
In EvolEcolGroup/pastclim: Manipulate Time Series of Palaeoclimate Reconstructions

region_series

R Documentation

Extract a time series of climate variables for a region

Description

This function extracts a time series of one or more climate variables for a given dataset covering a region (or the whole world). The function returns a terra::SpatRasterDataset object, with each variable as a sub-dataset.

Usage

region_series(
  time_bp = NULL,
  time_ce = NULL,
  bio_variables,
  dataset,
  path_to_nc = NULL,
  ext = NULL,
  crop = NULL
)

Arguments

`time_bp`	time slices in years before present (negative values represent time before present, positive values time in the future). This parameter can be a vector of times (the slices need to exist in the dataset), a list with a min and max element setting the range of values, or left to NULL to retrieve all time steps. To check which slices are available, you can use `get_time_bp_steps()`.
`time_ce`	time slices in years CE (see `time_bp` for options). For available time slices in years CE, use `get_time_ce_steps()`. Only one of `time_bp` or `time_ce` should be used.
`bio_variables`	vector of names of variables to be extracted
`dataset`	string defining the dataset to use. If set to "custom", then a single nc file is used from "path_to_nc"
`path_to_nc`	the path to the custom nc file containing the palaeoclimate reconstructions. All the variables of interest need to be included in this file.
`ext`	an extent, coded as numeric vector (length=4; order= xmin, xmax, ymin, ymax) or a terra::SpatExtent object. If NULL, the full extent of the reconstruction is given.
`crop`	a polygon used to crop the reconstructions (e.g. the outline of a continental mass). A `sf::sfg` or a terra::SpatVector object is used to define the polygon.