mcera5

A package to download and process ERA5 data ready for use in microclimate modelling. Corresponding paper describing the package here in Methods in Ecology and Evolution.

Install

You can install the package from this GitHub repository via the follow line:
remotes::install_github("dklinges9/mcera5")

News

8 Oct 2024: modularity to handle ERA5-reanalysis and ERA5-land files downloaded from BOTH the old (legacy) CDS and the new (beta) CDS has been provided in mcera5. In addition, users must specify if they want extracted climate data to be formatted for a specific microclimate R package: microclima, NicheMapR, microclimc, microclimf, or micropoint (microclimc is the default). The branch "new_cds_time_edits" has been merged into master and will soon be deleted.

25 Sept 2024: ERA5-reanalysis and ERA5-land files downloaded from the beta CDS have a different structure to their time dimension. To extract climate data from these files (e.g. using extract_clim()), please see the developer branch "new_cds_time_edits". You can install this branch directly via:

remotes::install_github("dklinges9/mcera5", ref = "new_cds_time_edits")

Sept 2024: This package is going through a lot of development to keep up with changes as ECMWF migrates to the new beta Climate Data Store. These changes include lower API limits, different variable names/netCDF file structures, and different credentials (see below for details). If you are facing unexplainable errors, please bring them to my attention (see Questions, Concerns, Issues below).

Tutorial

The vignette can then be accessed via:
vignette("mcera5_vignette")

Alternatively you can navigate to the vignette manually here on the GitHub repository.

Setup

ERA5 climate data can be downloaded from the ECMWF climate data store (CDS). Note that in July 2024 the CDS migrated to a new platform, and the old platform was deprecated in Sept 2024. The following describes how to access the data using R:

Register for an ECMWF account here. Upon registering you will need to accept all of the Terms and Conditions listed at the bottom of the form.
Then, navigate to the CDS site here and login using the button in the top right. Once logged in, hover your mouse over your name in the top right, and click on the option "Your profile" that appears (this should bring you to this page. Here you will find your User ID (UID) and Personal Access Token, both which are required for you to remotely download data from the CDS. Make a note of these.
Each CDS dataset has its own unique Terms of Use. You will need to accept these Terms for ERA5-reanalysis at this page (scroll down to "Terms of use" and accept). This same set of terms also applies for other Copernicus products, including ERA5-land.

Questions, Concerns, Issues

Before emailing about a concern, please submit a reproducible example as an issue on this Github repository. To do so, navigate to the main page of this repository and click on the "Issues" tab, and then "New Issue." If you do not have a GitHub account or are otherwise unable to submit an issue, then contact David Klinges at [email protected].