This R library is designed to provide an easy way to
extract and manipulate palaeoclimate reconstructions for ecological and
anthropological analyses. It is also able to handle time series of
future reconstructions.
The functionalities of pastclim are described in Leonardi et al. (2023).
Please cite it if you use pastclim in your research.
| ## CHELSA paths have changed |
The paths to the CHELSA datasets have
changed. Until we get the fix to CRAN, you will need to use the
dev version of pastclim to access the new
paths. The dev version is available from the
r-universe repository of the Evolutionary Ecology Group.
You can install it with: |
install.packages("pastclim", repos = c("https://evolecolgroup.r-universe.dev") |
| ## Install the library |
pastclim is on CRAN, and the
easiest way to install it is with: |
install.packages("pastclim") |
The version on CRAN is recommended for
every day use. New features and bug fixes appear first on the
dev branch on GitHub, before they make their way to CRAN.
If you need to have early access to these new features, you can install
the development version of pastclim directly from GitHub,
using devtools, or more simply get a compiled version from
r-universe. Also, note that the dev version of
pastclim tracks changes in the dev version of
terra, so you will need to upgrade both libraries
with: |
install.packages('terra', repos='https://rspatial.r-universe.dev') install.packages("pastclim", repos = c("https://evolecolgroup.r-universe.dev") |
| ## Overview of functionality |
On its dedicated website, you can
find Articles giving you a step-by-step overview
of the package, and a cheatsheet.
There is also a dev version of
the site updated for the dev branch of
pastclim (on the top left of the dev website, the version
number is in red and in the format x.x.x.9xxx, indicating it is a
development version). |
pastclim currently includes
data from Beyer et al 2020 (a reconstruction of climate based on the
HadCM3 model for the last 120k years), Krapp et al 2021 (which covers
the last 800k years with a statistical emulator of HadCM3), Barreto et
al 2023 (covering the last 5M years using the PALEO-PGEM emulator),
PaleoClim (providing a few time steps from different palaeoclimate
models downscaled to higher resolution), CHELSA-Trace21K (a transient
reconstruction of the last 21k years, downscaled to 1km resolution), the
HYDE3.3 database of land use reconstructions for the last 10k years, and
the WorldClim and CHELSA data (present, and future projections with a
number of models and emission scenarios). More details on each of these
datasets can be found here.
There are also instructions on how to build and use custom
datasets. |
There are two places to get help with pastclim:
If you are unsure how to do something, go to StackOverflow and, after checking
that a similar question has not been asked yet, tag your question with
terra and r (there is no pastclim
tag yet, as there aren’t enough questions), and make sure
pastclim is in the title. This will ensure that the
developers see your question and can help you. If you have not received
an answer after a couple of days, feel free to drop us an email in case
we missed your post.
If you have found a bug, or have a feature request, please open
an issue on our [GitHub
repository]((https://github.com/EvolEcolGroup/pastclim/issues). Before
doing so, please make sure that you have installed the latest
development version of pastclim (as the
bug might have already been fixed), as well as updating all other
packages on your system. If the problem persists, and there is no issue
already opened that deals with your bug, file a new issue
providing a reproducible example for the
developers to investigate the problem. A small reproducible
example is crucial in allowing us to understand the problem and
fix it, so please do your best to come up with the shortest big of code
needed to show the bug.