Go to file
Alfredo Oliviero be9f7dfe19 readme 2025-02-04 11:53:40 +01:00
.gitignore Upload errors fix 2024-12-29 18:11:44 +01:00
Dockerfile Dockerfile mod 2024-12-30 21:43:42 +01:00
LICENSE Initial commit 2024-12-29 17:46:33 +01:00
Readme.md readme 2025-02-04 11:53:40 +01:00
aeflow.py modified aeflow for ccp 2025-02-04 11:45:21 +01:00
config.yaml Add all files 2024-12-29 18:06:42 +01:00
get_data.py Add all files 2024-12-29 18:06:42 +01:00
requirements.txt Add all files 2024-12-29 18:06:42 +01:00

Readme.md

COPERNICUS Climate data mapping utility

This utility uses Copernicus Climate data to generate animations of aerosol evolution of a physical variable on a specific area. It is possible to plot a map for Italy [1], Europe [2] and EuAfAm [3] area.

In the file config.yaml you can find physical variables to plot, the number [1,2...10] correspond to --target parameter:

  1. black_carbon_aerosol_optical_depth_550nm
  2. dust_aerosol_optical_depth_550nm
  3. organic_matter_aerosol_optical_depth_550nm
  4. sea_salt_aerosol_optical_depth_550nm
  5. sulphate_aerosol_optical_depth_550nm
  6. total_aerosol_optical_depth_469nm
  7. total_aerosol_optical_depth_550nm
  8. total_aerosol_optical_depth_670nm
  9. total_aerosol_optical_depth_865nm
  10. total_aerosol_optical_depth_1240nm

For --startdate and --enddate always use the YYYY-mm-dd formate, like 2000-01-01.

For the --geoarea parameter you can choose between three options: italy, europe, and euafam (always lowercase)

Copernicus Climate data will be download in data directory, while animations will be generated in graphs directory.

Basic use as Python script

install a venv and install requirements:

python3 -m venv venv
. ./venv/bin/activate
pip install -r requirements.txt

crete a data folder where to store the output data:

mkdir data

From your local installation you can run from terminal:

python3 aeflow.py --target 1 --startdate 2022-12-01 --enddate 2022-12-20 --geoarea europe --cdsapikey 00000000-0000-0000-0000-000000000000

(remember to set your own API key)

Docker

The code has also been Dockerized, you can run:

docker build -t aeflow .

And run for a test example:

docker run -v aeflow --target 1 --startdate 2022-12-01 --enddate 2022-12-03 --geoarea europe --cdsapikey 00000000-0000-0000-0000-000000000000

(remember to set your own API key)

For --cdsapikey parameter you must obtain your own Copernicus Climate CDS API key.

You can register and get your personal key here: https://cds.climate.copernicus.eu/