|
||
---|---|---|
.gitignore | ||
Dockerfile | ||
LICENSE | ||
Readme.md | ||
aeflow.py | ||
config.yaml | ||
get_data.py | ||
requirements.txt |
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:
- black_carbon_aerosol_optical_depth_550nm
- dust_aerosol_optical_depth_550nm
- organic_matter_aerosol_optical_depth_550nm
- sea_salt_aerosol_optical_depth_550nm
- sulphate_aerosol_optical_depth_550nm
- total_aerosol_optical_depth_469nm
- total_aerosol_optical_depth_550nm
- total_aerosol_optical_depth_670nm
- total_aerosol_optical_depth_865nm
- 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/