GFSDownload

A utility to download GFS meteo data

Project description

=======
# gfsDownload
Tools for downloading gfs meteo parameters modelling estimation on an area and on a specific time.
GFS is a product of NCEP,NOAA and provide a full range of product which are describe in
http://www.nco.ncep.noaa.gov/pmb/products/gfs/

<h2>Installation</h2>

mkdir PATH/TO/INSTALL 
cd PATH/TO/INSTALL/gfsDownload 
git clone git+git://github.com/yoannMoreau/gfsDownload.git 
sudo apt-get install grib-api
sudo apt-get install libopenjpeg
sudo apt-get install pyproj
python python/GFSDownload.py -help 

( or you cas Use pip to install gfsDownload )

<h2>Overview: What can gfsDownload do?</h2>

gfsDownload has a main function, allow download of parameters on a area in an automatic way

Four paramaters are mandatory: 
 --Code of Parameters <gfsDownload> 
A list of code which define parameters desired. Code reference can be found on : 
<a href="http://www.nco.ncep.noaa.gov/pmb/products/gfs/gfs_upgrade/gfs.t06z.pgrb2.0p25.anl.shtml">For analyse </a> 
<a href="http://www.nco.ncep.noaa.gov/pmb/products/gfs/gfs_upgrade/gfs.t06z.pgrb2.0p25.f006.shtml">For forecast </a> 
CODE PARAMETERS Exemple : 
total precipitation : APCP [m of water] 
temperature : TMP [K] 
pressure : PRES [Pa] 
dewpoint : DPT [K] 
eastward wind component UGRD [m s-1] 
northward wind component VGRD [m s-1]
 
--Interval needed : 
init date <dateStart YYYY-MM-DD>' AND end date <dateEnd YY-MM-DD>'
these parameters should be in a 14 days range from maximum date today
 
--Area needed 
shapefile <pathToShapefile> (srs is not important because it will be reprojected in WGS84)
OR
--Extend <xmin,ymax,xmax,ymin> in WGS84
 

EXAMPLES : 
--temperature on a shapefile during the first to the second of january 
python GFSDownload.py -c TMP -i 2014-01-01 -e 2014-01-02 -s PATH_TO_SHAPE' 
--pressure and dewPoint on a area during the first month of 2015 on a specific extend 
python eraInterimDownload.py -c PRES,DPT -i 2015-01-01 -e 2015-02-01 -E xmin,ymax,xmax,ymin' 
 
Five paramaters are optional: 
--Step <gfsDownload Step> (default 0)' 
The step of modeling.
The step of itarate data over the days choosen !
default is 0,6,12,18.
A list is possible for that parameter
 
python GFSDownload.py -c TMP -i 2013-11-08 -e 2013-12-09 -E xmin,ymax,xmax,ymin -p 0,6'
 
--Grid <grid spacing on °.arc> (default 0)'
 
The spacing of final raster. grid possible : 0.25/0.5/1/2.5
default is 0.25
 
python GFSDownload.py -c TMP -i 2015-04-19 -e 2015-04-19 -E xmin,ymax,xmax,ymin -g 0.5'
 
--Outfile <Path to downloaded Raster> (default /home/user/eraInterim)'
 
python GFSDownload.py -c PRES -i 2011-10-01 -e 2011-10-02 -E xmin,ymax,xmax,ymin -o PATH/TO/FILE'
All downloaded raster are tif with a VAR_LEVEL_DateInit_DateEnd.tif name
 
--proxy <proxy : True/False> (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
 
<h2>Important Notes </h2>

All downloaded and processed images are stored by default in your home directory in GFS forlder: ~/GFS
 
To Do List
 
Improve console output 
Maintain with bug error