natgeo-wong / era5reanalysis.jl

Dealing with ERA5 Reanalysis datasets

ERA5Reanalysis.jl

Created By: Nathanael Wong ([email protected])

Introduction

ERA5Reanalysis.jl is a Julia package that aims to streamline the following processes:

• downloads of ERA5 Datasets from the Climate Data Store (does not include MARS requests)
• basic analysis of said datasets
• perform all the above operations innately over a given geographical region using the GeoRegion functionality of GeoRegions.jl (v2 and above)

ERA5Reanalysis.jl has not been officially registered as a Julia package yet. To install it, add it directly using the GitHub link as follows:

julia> ]
(@v1.6) pkg> add https://github.com/natgeo-wong/ERA5Reanalysis.jl.git

Required Installation

In order to download data from the Climate Data Store (CDS), you need to register with Copernicus first, and then follow the instructions here such that the information can be retrieved from the ~/.cdsapirc file

Usage

Please refer to the documentation for instructions and examples. A working knowledge of the GeoRegion supertypes used in GeoRegions.jl v2 is also needed.

Tip: Both the GeoRegions.jl and Dates dependencies are reexported by ERA5Reanalysis.jl, and therefore there is no need to call either GeoRegions.jl or Dates separately when using the ERA5Reanalysis.jl package.

Supported Datasets

The following ERA5 datasets available on CDS are supported:

• Hourly Data, 0.25º resolution, from 1979-present
  • Early and Late runs of Half-Hourly and Daily Data
  • Ensemble data, mean and std not yet supported, addition is possible depending on demand
• Monthly Data, 0.25º resolution, from 1979-present
  • Both monthly reanalysis, and monthly-by-hour are supported
  • Ensemble data not yet supported, addition is possible depending on demand
• Support for the back-extension (1950-1978) for all datasets coming soon
• Support for ERA5-Land reanalysis will eventually be included. How fast depends on demand

Only the calibrated precipitation data is downloaded, with units of rate in log2(mm/s).

If there is demand, I can try to add other datasets available on the Climate Data Store to the mix as well. Please open an issue if you want me to do so.

era5reanalysis.jl's Issues

Set option to download pressure-level data in batches

Instead of downloading pressure-level data level by level, download all levels in the same request

• Checks for validity
• Function to split downloaded data into their respective levels and resave
• Create download functions for native julia implementation

Extra:

• Create download functions for Python CDSAPI implementation

In this way, we can probably save time on the requesting, downloading and queueing, at the cost of a bit of precision

TagBot trigger issue

This issue is used to trigger TagBot; feel free to unsubscribe.

If you haven't already, you should update your TagBot.yml to include issue comment triggers.
Please see this post on Discourse for instructions and more details.

If you'd like for me to do this for you, comment TagBot fix on this issue.
I'll open a PR within a few hours, please be patient!

Unable to push [compat] of NCDatasets.jl to 0.12

As per Alexander-Barth/NCDatasets.jl#182 and Alexander-Barth/NCDatasets.jl#150 (comment), wait until Julia 1.8 comes out before updating [compat] of NCDatasets.jl to 0.12