npdc-era5 1.0.1

Interactive CLI to discover, download, and quality-check ERA5 reanalysis data from the Copernicus Climate Data Store.

ERA5 CLI

Interactive command-line tool to discover, download, and quality-check ERA5 reanalysis data from the Copernicus Climate Data Store.

Developed at the National Polar Data Center (NPDC), National Centre for Polar and Ocean Research (NCPOR), Ministry of Earth Sciences, Government of India.

Installation

pip install era5-cli

Prerequisites

Register at cds.climate.copernicus.eu and create ~/.cdsapirc:

url: https://cds.climate.copernicus.eu/api
key: YOUR_UID:YOUR_API_KEY

Usage

era5

The tool will interactively walk you through:

1. Dataset selection — dynamically fetched from the CDS catalogue (8 core ERA5 datasets)
2. Variable selection — full list pulled live from the API (e.g., 262 variables for single-levels)
3. Spatial coverage — global or custom bounding box
4. Temporal range — start/end dates
5. Time of day — noon, all 24 hours, or custom
6. Output — choose directory and filename

After download, automatic quality control checks for:

• Missing data (NaN values)
• Physical bounds (temperature, pressure, wind speed)

Features

• Dynamic discovery — datasets and variables are fetched live from the CDS API
• 7-day local cache — subsequent launches are instant (~/.era5_cli_cache.json)
• Hardcoded fallback — works offline with a built-in variable list + warning
• Search & range selection — type search wind or 1-5,10,15 when picking variables
• Quality control — automatic physical-bounds checking on downloaded NetCDF files
• File summary — prints min/max per variable after download

Available Datasets

Dataset	Variables
ERA5-Land hourly	60
ERA5-Land monthly means	60
ERA5-Land hourly time-series	19
ERA5 pressure levels hourly	16
ERA5 pressure levels monthly means	16
ERA5 single levels hourly	262
ERA5 single levels monthly means	260
ERA5 single levels hourly time-series	21

License

MIT — see LICENSE.