eraInterimDownload
Tools for downloading era Interim physical parameters on an area. Era Interim is a product of ECMWF and provide a full range of product which are describe in http://old.ecmwf.int/publications/library/ecpublications/_pdf/era/era_report_series/RS_1_v2.pdf
Installation
mkdir PATH/TO/INSTALL
cd PATH/TO/INSTALL/eraInterimDownload
git clone git+git://github.com/yoannMoreau/eraInterimDownload.git
sudo pip install https://software.ecmwf.int/wiki/download/attachments/23694554/ecmwf-api-client-python.tgz
python python/landsat_theia.py -help
( or you cas Use pip to install eraInterimDownload )
Overview: What can eraInterimDownload do?
eraInterimDownload has a main function, allow download of parameters on a area in an automatic way
Four paramaters are mandatory:
--Code of Parameters
A list of code which define parameters desired. Code reference can be found on http://old.ecmwf.int/publications/library/ecpublications/_pdf/era/era_report_series/RS_1_v2.pdf
CODE PARAMETERS Exemple :
total precipitation : 228 [m of water]
2 meters temperature : 167 [K]
maximum 2m temperature since last post-processing step : 201 [K]
minimum 2m temperature since last post-processing step : 202 [K]
surface pressure : 134 [Pa]
2 meters dewpoint : 168 [K]
10 meters eastward wind component X X 165 [m s-1]
10 meters northward wind component X X 166 [m s-1]
--Interval needed :
init date ' AND end date '
--Area needed
shapefile (srs is not important because it will be reprojected in WGS84)
OR
--Extend in WGS84
EXAMPLES :
--temperature on a shapefile during the first to the second of january
python eraInterimDownload.py -c 167 -i 2014-01-01 -e 2014-01-02 -s PATH_TO_SHAPE'
--pressure on a area during the first month of 2015 on a specific extend
python eraInterimDownload.py -c 134 -i 2015-01-01 -e 2015-02-01 -E xmin,ymax,xmax,ymin'
Five paramaters are optional:
--Time (default 00)'
The time for starting modelisation. It could be 00h 06h,12h or 18h (selection in 00,06,12,18).
Default is 0.
A list is possible for that parameter
python eraInterimDownload.py -c 168 -i 2013-11-08 -e 2013-12-09 -E xmin,ymax,xmax,ymin -t 00,06,12,18'
--Step (default 0)'
The step of modeling.
If step 0 is chosen, then only analysed fields, which are produced for 0000, 0600, 1200 and 1800 UTC, are available.
If step 3, 6, 9 or 12 is selected then only forecast fields which are produced from forecasts beginning at 0000 and 1200 UTC, are available.
Some parameters are not possible within some of the possibilities.
Check the documentation for more information.
default is 0.
A list is possible for that parameter
python eraInterimDownload.py -c 168 -i 2013-11-08 -e 2013-12-09 -E xmin,ymax,xmax,ymin -p 0,6'
--Grid (default 0)'
The spacing of final raster. grid possible : 0.125/0.25/0.5/0.75/1.125/1.5/2/2.5/3
default is 0.75
python eraInterimDownload.py -c 168 -i 2011-10-01 -e 2011-10-02 -E xmin,ymax,xmax,ymin -g 0,125'
--Outfile (default /home/user/eraInterim)'
python eraInterimDownload.py -c 168 -i 2011-10-01 -e 2011-10-02 -E xmin,ymax,xmax,ymin -o PATH/TO/FILE'
All downloaded raster are netcdf with a code_DateInit_DateEnd.nc name
--proxy (default False)
Sometimes a proxy definition is needed for downloading from external network.
When this option is activated, a proxy user/key/site could be defined to overpass it
Important Notes
All downloaded and processed images are stored by default in your home directory in eraInterim forlder: ~/eraInterim
To Do List
Improve console output
Allow grid download
Maintain with bug error