eraInterimDownload

A utility to download ERA INTERIM meteo data


License
Other
Install
pip install eraInterimDownload==0.0.6

Documentation

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