IISD Final Phase 1

This release contains the code + configuration files used to generate all files delivered for project Phase 1.
See bash script download_iisd.sh (linux version only).

indicator, asset and simulation sets

This new release is a major update compared to v1.0.
Note syntax has changed, and new download.py script.

• custom variable with unit correction
• bias-correction monthly or yearly
• grouping by asset class
• simulation sets (model, ensemble, ...)

Download to csv

Implemented Features:

• Download any ERA5 and CMIP5 variable directly to csv file, for any lon/lat location
• The raw CDS API files are downloaded under download, and timeseries are extracted as csv file under csv.
• Favourite locations can be defined in locations.yml and called with --location parameter, to avoid having to indicate --lon, --lat each time.
• ERA5 is downloaded for the 2000-2019 period, CMIP5 for 2006-2100.
• Default CMIP5 scenario is rcp_8_5 (RCP 8.5) and default CMIP5 model is ipsl_cm5a_mr.
• Any other model or and any other future scenario can be specified via --model and --scenario parameters.
• CMIP5 data are downloaded for the whole globe (in zipped format), about 70Mb per variable and per model for the 2006-2100 period
• ERA5 data are downloaded in predefined "tiles" (rectangles) of 5 degrees latitude and 10 degrees longitude, for easier re-use in nearby locations (no need to download the full file again)
• Visualize results via --view-timeseries, --view-region or --view-area parameters (experimental).
• Possibility to specify a different region via --width (experimental, with issues)

Planned features:

Main features:

• Aggregate variables per asset class.
• Bias-correction option by combining CMIP5 and ERA5 (monthly, single level)
• Possibly add more datasets to match assets requirement (daily and hourly data for instance)

In details:

• Most additional planned features will involve post-processing of downloaded csv files, saved under an assets folder.
• E.g. --asset energy parameter to download a predefined set of variables, and save these to CSV file(s) under assets/energy.csv or assets/energy/<variable>.csv, depending on the level of harmonization across variables.
• more metadata to csv files (like units)
• technical: harmonize downloaded netCDF files (e.g. dimensions are now named lon in CMIP5 and longitude in ERA5. Having one name will make simpler code and fix the longitude issue below)

Known issues:

• Problems for longitudes outside the [0, 180] range: will be solved in a future release.
• Plotting areas for large regions that cross the longitude range above cause problems, for the reason outlined above.