ClimateERA.jl

Created By: Nathanael Wong (nathanaelwong@fas.harvard.edu)

Developer To-Do for v1.0:

• Testing of analysis functions
• Comprehensive documentation and Jupyter notebook examples
• eraquery function series development

Introduction

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

• downloading of ECMWF reanalysis data (ERA-Interim and ERA5)
• basic analysis (mean, maximum, minimum, standard deviation, etc.) of downloaded data
• extraction of data for a given GeoRegion (see GeoRegions.jl for more information)

ClimateERA.jl can be installed via

] add ClimateERA

Requirements

There are some non-Julia functionalities required in order to download reanalysis data using ClimateERA.jl:

• A working Python installation
• For ERA-Interim, please follow the instructions here to install the ECMWF API
• For ERA5, please follow the instructions here to install the CDS API

ECMWF Reanalysis

Both ERA-Interim and ERA5 are produced by the European Centre for Medium-Range Weather Forecasts. For more information regarding the ERA-Interim and ERA5 reanalysis models, please refer to the following:

• ERA-Interim [Documentation] [Paper]
• ERA5 [Documentation]

Workflow

Startup and Initialization

Setup

Directories

By default, ClimateERA.jl saves all data into a datadir repository that is user-specified, or else it will otherwise default to

datadir="~/research/ecmwf/"

Regions

ClimateERA.jl utlizes GeoRegions.jl to specify domains from which data is to be extracted. If the option is not specified, then ClimateERA.jl will assume that the user wishes to process global data (which may not be wise especially for GPM due to the large file sizes involved and memory required).

For more information, please see the repository for GeoRegions.jl here.

Downloads

ClimateERA.jl does not directly download reanalysis data from ECMWF/CDS. Instead, it generates a Python script according to the user's choice of parameters that the user will run with Python to download the data required.