Difference between revisions of "OpenIFS"

From mn/geo/geoit
Jump to: navigation, search
Line 70: Line 70:
 
To use getEIdata.py, you need to specify the retrieval dates (at least the starting date). For instance:
 
To use getEIdata.py, you need to specify the retrieval dates (at least the starting date). For instance:
 
<pre>getEIdata.py --start_date=20030103</pre>
 
<pre>getEIdata.py --start_date=20030103</pre>
 +
<br/>the above command retrieves ERA-Interim data for the 3rd January 2003 for time=00 and write them in $WORKDIR/20030103/00
  
 
+
*'''EI_shml.grb''': contains spherical harmonics&nbsp; fields on model levels
the above command retrieves ERA-Interim data for the 3rd January 2003 for time=00 and write them in $WORKDIR/20030103/00
+
*'''EI_ggml.grb''': contains model levels fields on a reduced gaussian grid
 
+
*'''EI_iniggsfc.grb''': contains surface data on a reduced gaussian grid
*EI_shml.grb: contains spherical harmonics&nbsp; fields on model levels
 
*EI_ggml.grb: contains model levels fields on a reduced gaussian grid
 
*EI_iniggsfc.grb: contains surface data on a reduced gaussian grid
 
  
  
Line 90: Line 88:
 
|-
 
|-
 
| lnsp<br/>
 
| lnsp<br/>
| <br/>
+
| '''[http://old.ecmwf.int/publications/manuals/d/gribapi/param/detail/filter=grib1/format=mars/order=paramId/order_type=asc/p=1/pid=152/table=128/ Logarithm of surface pressure]'''<br/>
 
| <br/>
 
| <br/>
 
| EI_shml.grb<br/>
 
| EI_shml.grb<br/>
 
|-
 
|-
 
| t<br/>
 
| t<br/>
| <br/>
+
| '''[http://old.ecmwf.int/publications/manuals/d/gribapi/param/detail/filter=grib1/format=mars/order=paramId/order_type=asc/p=1/pid=130/table=128/ Temperature]'''<br/>
 
| <br/>
 
| <br/>
 
| EI_shml.grb<br/>
 
| EI_shml.grb<br/>
 
|-
 
|-
 
| vo<br/>
 
| vo<br/>
| <br/>
+
| '''[http://old.ecmwf.int/publications/manuals/d/gribapi/param/detail/filter=grib1/format=mars/order=paramId/order_type=asc/p=1/pid=138/table=128/ Vorticity (relative)]'''<br/>
 
| <br/>
 
| <br/>
 
| EI_shml.grb<br/>
 
| EI_shml.grb<br/>
 
|-
 
|-
 
| d<br/>
 
| d<br/>
| <br/>
+
| '''[http://old.ecmwf.int/publications/manuals/d/gribapi/param/detail/filter=grib1/format=mars/order=paramId/order_type=asc/p=1/pid=155/table=128/ Divergence]'''<br/>
 
| <br/>
 
| <br/>
 
| EI_shml.grb<br/>
 
| EI_shml.grb<br/>
 
|-
 
|-
 
| o3<br/>
 
| o3<br/>
| <br/>
+
| '''[http://old.ecmwf.int/publications/manuals/d/gribapi/param/detail/filter=grib1/format=mars/order=paramId/order_type=asc/p=1/pid=203/table=128/ Ozone mass mixing ratio]'''<br/>
 
| <br/>
 
| <br/>
 
| EI_ggml.grb<br/>
 
| EI_ggml.grb<br/>
 
|-
 
|-
 
| clwc<br/>
 
| clwc<br/>
| <br/>
+
| '''[http://old.ecmwf.int/publications/manuals/d/gribapi/param/detail/filter=grib1/format=mars/order=paramId/order_type=asc/p=1/pid=246/table=128/ Specific cloud liquid water content]'''<br/>
 
| <br/>
 
| <br/>
 
| EI_ggml.grb<br/>
 
| EI_ggml.grb<br/>
 
|-
 
|-
 
| ciwc<br/>
 
| ciwc<br/>
| <br/>
+
| '''[http://old.ecmwf.int/publications/manuals/d/gribapi/param/detail/filter=grib1/format=mars/order=paramId/order_type=asc/p=1/pid=247/table=128/ Specific cloud ice water content]'''<br/>
 
| <br/>
 
| <br/>
 
| EI_ggml.grb<br/>
 
| EI_ggml.grb<br/>
 
|-
 
|-
 
| cc<br/>
 
| cc<br/>
| <br/>
+
| '''[http://old.ecmwf.int/publications/manuals/d/gribapi/param/detail/filter=grib1/format=mars/order=paramId/order_type=asc/p=1/pid=248/table=128/ Cloud cover]'''<br/>
 
| <br/>
 
| <br/>
 
| EI_ggml.grb<br/>
 
| EI_ggml.grb<br/>
 
|-
 
|-
 
| q<br/>
 
| q<br/>
| <br/>
+
| '''[http://old.ecmwf.int/publications/manuals/d/gribapi/param/detail/filter=grib1/format=mars/order=paramId/order_type=asc/p=1/pid=133/table=128/ Specific humidity]'''<br/>
 
| <br/>
 
| <br/>
 
| EI_ggml.grb<br/>
 
| EI_ggml.grb<br/>
 
|-
 
|-
 
| crwc<br/>
 
| crwc<br/>
| <br/>
+
| '''[http://old.ecmwf.int/publications/manuals/d/gribapi/param/detail/filter=grib1/format=mars/order=paramId/order_type=asc/p=1/pid=75/table=128/ Specific rain water content]'''<br/>
 
| <br/>
 
| <br/>
 
| EI_ggml.grb<br/>
 
| EI_ggml.grb<br/>
 
|-
 
|-
 
| cswc<br/>
 
| cswc<br/>
| <br/>
+
| '''[http://old.ecmwf.int/publications/manuals/d/gribapi/param/detail/filter=grib1/format=mars/order=paramId/order_type=asc/p=1/pid=76/table=128/ Specific snow water content]'''<br/>
 
| <br/>
 
| <br/>
 
| EI_ggml.grb<br/>
 
| EI_ggml.grb<br/>
 
|-
 
|-
 
| swvl1<br/>
 
| swvl1<br/>
| <br/>
+
| '''[http://old.ecmwf.int/publications/manuals/d/gribapi/param/detail/filter=grib1/format=mars/order=paramId/order_type=asc/p=1/pid=39/table=128/ Volumetric soil water layer 1]'''<br/>
 
| <br/>
 
| <br/>
 
| EI_iniggsfc.grb<br/>
 
| EI_iniggsfc.grb<br/>
 
|-
 
|-
 
| swvl2<br/>
 
| swvl2<br/>
| <br/>
+
| '''[http://old.ecmwf.int/publications/manuals/d/gribapi/param/detail/filter=grib1/format=mars/order=paramId/order_type=asc/p=1/pid=40/table=128/ Volumetric soil water layer 2]'''<br/>
 
| <br/>
 
| <br/>
 
| EI_iniggsfc.grb<br/>
 
| EI_iniggsfc.grb<br/>
 
|-
 
|-
 
| swvl3<br/>
 
| swvl3<br/>
| <br/>
+
| '''[http://old.ecmwf.int/publications/manuals/d/gribapi/param/detail/filter=grib1/format=mars/order=paramId/order_type=asc/p=1/pid=41/table=128/ Volumetric soil water layer 3]'''<br/>
 
| <br/>
 
| <br/>
 
| EI_iniggsfc.grb<br/>
 
| EI_iniggsfc.grb<br/>
 
|-
 
|-
 
| swvl4<br/>
 
| swvl4<br/>
| <br/>
+
| '''[http://old.ecmwf.int/publications/manuals/d/gribapi/param/detail/filter=grib1/format=mars/order=paramId/order_type=asc/p=1/pid=42/table=128/ Volumetric soil water layer 4]'''<br/>
 
| <br/>
 
| <br/>
 
| EI_iniggsfc.grb<br/>
 
| EI_iniggsfc.grb<br/>
 
|-
 
|-
 
| stl1<br/>
 
| stl1<br/>
| <br/>
+
| '''[http://old.ecmwf.int/publications/manuals/d/gribapi/param/detail/filter=grib1/format=mars/order=paramId/order_type=asc/p=1/pid=139/table=128/ Soil temperature level 1]'''<br/>
 
| <br/>
 
| <br/>
 
| EI_iniggsfc.grb<br/>
 
| EI_iniggsfc.grb<br/>
 
|-
 
|-
 
| stl2<br/>
 
| stl2<br/>
| <br/>
+
| '''[http://old.ecmwf.int/publications/manuals/d/gribapi/param/detail/filter=grib1/format=mars/order=paramId/order_type=asc/p=1/pid=170/table=128/ Soil temperature level 2]'''<br/>
 
| <br/>
 
| <br/>
 
| EI_iniggsfc.grb<br/>
 
| EI_iniggsfc.grb<br/>
 
|-
 
|-
 
| stl3<br/>
 
| stl3<br/>
| <br/>
+
| '''[http://old.ecmwf.int/publications/manuals/d/gribapi/param/detail/filter=grib1/format=mars/order=paramId/order_type=asc/p=1/pid=183/table=128/ Soil temperature level 3]'''<br/>
 
| <br/>
 
| <br/>
 
| EI_iniggsfc.grb<br/>
 
| EI_iniggsfc.grb<br/>
 
|-
 
|-
 
| stl4<br/>
 
| stl4<br/>
| <br/>
+
| '''[http://old.ecmwf.int/publications/manuals/d/gribapi/param/detail/filter=grib1/format=mars/order=paramId/order_type=asc/p=1/pid=236/table=128/ Soil temperature level 4]'''<br/>
 
| <br/>
 
| <br/>
 
| EI_iniggsfc.grb<br/>
 
| EI_iniggsfc.grb<br/>
 
|-
 
|-
 
| skt<br/>
 
| skt<br/>
| <br/>
+
| '''[http://old.ecmwf.int/publications/manuals/d/gribapi/param/detail/filter=grib1/format=mars/order=paramId/order_type=asc/p=1/pid=235/table=128/ Skin temperature]'''<br/>
 
| <br/>
 
| <br/>
 
| EI_iniggsfc.grb<br/>
 
| EI_iniggsfc.grb<br/>
 
|-
 
|-
 
| tsn<br/>
 
| tsn<br/>
| <br/>
+
| '''[http://old.ecmwf.int/publications/manuals/d/gribapi/param/detail/filter=grib1/format=mars/order=paramId/order_type=asc/p=1/pid=238/table=128/ Temperature of snow layer]'''<br/>
 
| <br/>
 
| <br/>
 
| EI_iniggsfc.grb<br/>
 
| EI_iniggsfc.grb<br/>
 
|-
 
|-
 
| sd<br/>
 
| sd<br/>
| <br/>
+
| '''[http://old.ecmwf.int/publications/manuals/d/gribapi/param/detail/filter=grib1/format=mars/order=paramId/order_type=asc/p=1/pid=141/table=128/ Snow depth]'''<br/>
 
| <br/>
 
| <br/>
 
| EI_iniggsfc.grb<br/>
 
| EI_iniggsfc.grb<br/>
 
|-
 
|-
 
| rsn<br/>
 
| rsn<br/>
| <br/>
+
| '''[http://old.ecmwf.int/publications/manuals/d/gribapi/param/detail/filter=grib1/format=mars/order=paramId/order_type=asc/p=1/pid=33/table=128/ Snow density]'''<br/>
 
| <br/>
 
| <br/>
 
| EI_iniggsfc.grb<br/>
 
| EI_iniggsfc.grb<br/>
 
|-
 
|-
 
| asn<br/>
 
| asn<br/>
| <br/>
+
| '''[http://old.ecmwf.int/publications/manuals/d/gribapi/param/detail/filter=grib1/format=mars/order=paramId/order_type=asc/p=1/pid=32/table=128/ Snow albedo]'''<br/>
 
| <br/>
 
| <br/>
 
| EI_iniggsfc.grb<br/>
 
| EI_iniggsfc.grb<br/>
 
|-
 
|-
 
| src<br/>
 
| src<br/>
| <br/>
+
| '''[http://old.ecmwf.int/publications/manuals/d/gribapi/param/detail/filter=grib1/format=mars/order=paramId/order_type=asc/p=1/pid=198/table=128/ Skin reservoir content]'''<br/>
 
| <br/>
 
| <br/>
 
| EI_iniggsfc.grb<br/>
 
| EI_iniggsfc.grb<br/>
 
|-
 
|-
 
| ci<br/>
 
| ci<br/>
| <br/>
+
| '''[http://old.ecmwf.int/publications/manuals/d/gribapi/param/detail/filter=grib1/format=mars/order=paramId/order_type=asc/p=1/pid=31/table=128/ Sea-ice cover]'''<br/>
 
| <br/>
 
| <br/>
 
| EI_iniggsfc.grb<br/>
 
| EI_iniggsfc.grb<br/>
 
|-
 
|-
 
| sst<br/>
 
| sst<br/>
| <br/>
+
| '''[http://old.ecmwf.int/publications/manuals/d/gribapi/param/detail/filter=grib1/format=mars/order=paramId/order_type=asc/p=1/pid=34/table=128/ Sea surface temperature]'''<br/>
 
| <br/>
 
| <br/>
 
| EI_iniggsfc.grb<br/>
 
| EI_iniggsfc.grb<br/>
 
|-
 
|-
 
| istl1<br/>
 
| istl1<br/>
| <br/>
+
| '''[http://old.ecmwf.int/publications/manuals/d/gribapi/param/detail/filter=grib1/format=mars/order=paramId/order_type=asc/p=1/pid=35/table=128/ Ice temperature layer 1]'''<br/>
 
| <br/>
 
| <br/>
 
| EI_iniggsfc.grb<br/>
 
| EI_iniggsfc.grb<br/>
 
|-
 
|-
 
| istl2<br/>
 
| istl2<br/>
| <br/>
+
| '''[http://old.ecmwf.int/publications/manuals/d/gribapi/param/detail/filter=grib1/format=mars/order=paramId/order_type=asc/p=1/pid=36/table=128/ Ice temperature layer 2]'''<br/>
 
| <br/>
 
| <br/>
 
| EI_iniggsfc.grb<br/>
 
| EI_iniggsfc.grb<br/>
 
|-
 
|-
 
| istl3<br/>
 
| istl3<br/>
| <br/>
+
| '''[http://old.ecmwf.int/publications/manuals/d/gribapi/param/detail/filter=grib1/format=mars/order=paramId/order_type=asc/p=1/pid=37/table=128/ Ice temperature layer 3]'''<br/>
 
| <br/>
 
| <br/>
 
| EI_iniggsfc.grb<br/>
 
| EI_iniggsfc.grb<br/>
 
|-
 
|-
 
| istl4<br/>
 
| istl4<br/>
| <br/>
+
| '''[http://old.ecmwf.int/publications/manuals/d/gribapi/param/detail/filter=grib1/format=mars/order=paramId/order_type=asc/p=1/pid=38/table=128/ Ice temperature layer 4]'''<br/>
 
| <br/>
 
| <br/>
 
| EI_iniggsfc.grb<br/>
 
| EI_iniggsfc.grb<br/>
 
|-
 
|-
 
| anor<br/>
 
| anor<br/>
| <br/>
+
| '''[http://old.ecmwf.int/publications/manuals/d/gribapi/param/detail/filter=grib1/format=mars/order=paramId/order_type=asc/p=1/pid=162/table=128/ Angle of sub-gridscale orography]'''<br/>
 
| <br/>
 
| <br/>
 
| EI_iniggsfc.grb<br/>
 
| EI_iniggsfc.grb<br/>
 
|-
 
|-
 
| isor<br/>
 
| isor<br/>
| <br/>
+
| '''[http://old.ecmwf.int/publications/manuals/d/gribapi/param/detail/filter=grib1/format=mars/order=paramId/order_type=asc/p=1/pid=161/table=128/ Anisotropy of sub-gridscale orography]'''<br/>
 
| <br/>
 
| <br/>
 
| EI_iniggsfc.grb<br/>
 
| EI_iniggsfc.grb<br/>
 
|-
 
|-
 
| slor<br/>
 
| slor<br/>
| <br/>
+
| '''[http://old.ecmwf.int/publications/manuals/d/gribapi/param/detail/filter=grib1/format=mars/order=paramId/order_type=asc/p=1/pid=163/table=128/ Slope of sub-gridscale orography]'''<br/>
 
| <br/>
 
| <br/>
 
| EI_iniggsfc.grb<br/>
 
| EI_iniggsfc.grb<br/>
 
|-
 
|-
 
| sdor<br/>
 
| sdor<br/>
| <br/>
+
| '''[http://old.ecmwf.int/publications/manuals/d/gribapi/param/detail/filter=grib1/format=mars/order=paramId/order_type=asc/p=1/pid=160/table=128/ Standard deviation of orography]'''<br/>
 
| <br/>
 
| <br/>
 
| EI_iniggsfc.grb<br/>
 
| EI_iniggsfc.grb<br/>
 
|-
 
|-
 
| sr<br/>
 
| sr<br/>
| <br/>
+
| '''[http://old.ecmwf.int/publications/manuals/d/gribapi/param/detail/filter=grib1/format=mars/order=paramId/order_type=asc/p=1/pid=173/table=128/ Surface roughness]'''<br/>
 
| <br/>
 
| <br/>
 
| EI_iniggsfc.grb<br/>
 
| EI_iniggsfc.grb<br/>
 
|-
 
|-
 
| lsrh<br/>
 
| lsrh<br/>
| <br/>
+
| '''[http://old.ecmwf.int/publications/manuals/d/gribapi/param/detail/filter=grib1/format=mars/order=paramId/order_type=asc/p=1/pid=234/table=128/ Logarithm of surface roughness length for heat]'''<br/>
 
| <br/>
 
| <br/>
 
| EI_iniggsfc.grb<br/>
 
| EI_iniggsfc.grb<br/>
 
|-
 
|-
 
| cvh<br/>
 
| cvh<br/>
| <br/>
+
| '''[http://old.ecmwf.int/publications/manuals/d/gribapi/param/detail/filter=grib1/format=mars/order=paramId/order_type=asc/p=1/pid=28/table=128/ High vegetation cover]'''<br/>
 
| <br/>
 
| <br/>
 
| EI_iniggsfc.grb<br/>
 
| EI_iniggsfc.grb<br/>
 
|-
 
|-
 
| cvl<br/>
 
| cvl<br/>
| <br/>
+
| '''[http://old.ecmwf.int/publications/manuals/d/gribapi/param/detail/filter=grib1/format=mars/order=paramId/order_type=asc/p=1/pid=27/table=128/ Low vegetation cover]'''<br/>
 
| <br/>
 
| <br/>
 
| EI_iniggsfc.grb<br/>
 
| EI_iniggsfc.grb<br/>
 
|-
 
|-
 
| tvh<br/>
 
| tvh<br/>
| <br/>
+
| '''[http://old.ecmwf.int/publications/manuals/d/gribapi/param/detail/filter=grib1/format=mars/order=paramId/order_type=asc/p=1/pid=30/table=128/ Type of high vegetation]'''<br/>
 
| <br/>
 
| <br/>
 
| EI_iniggsfc.grb<br/>
 
| EI_iniggsfc.grb<br/>
 
|-
 
|-
 
| al<br/>
 
| al<br/>
| <br/>
+
| '''[http://old.ecmwf.int/publications/manuals/d/gribapi/param/detail/filter=grib1/format=mars/order=paramId/order_type=asc/p=1/pid=174/table=128/ Albedo]'''<br/>
 
| <br/>
 
| <br/>
 
| EI_iniggsfc.grb<br/>
 
| EI_iniggsfc.grb<br/>
 
|-
 
|-
 
| aluvp<br/>
 
| aluvp<br/>
| <br/>
+
| '''[http://old.ecmwf.int/publications/manuals/d/gribapi/param/detail/filter=grib1/format=mars/order=paramId/order_type=asc/p=1/pid=15/table=128/ UV visible albedo for direct radiation]'''<br/>
 
| <br/>
 
| <br/>
 
| EI_iniggsfc.grb<br/>
 
| EI_iniggsfc.grb<br/>
 
|-
 
|-
 
| aluvd<br/>
 
| aluvd<br/>
| <br/>
+
| '''[http://old.ecmwf.int/publications/manuals/d/gribapi/param/detail/filter=grib1/format=mars/order=paramId/order_type=asc/p=1/pid=16/table=128/ UV visible albedo for diffuse radiation]'''<br/>
 
| <br/>
 
| <br/>
 
| EI_iniggsfc.grb<br/>
 
| EI_iniggsfc.grb<br/>
 
|-
 
|-
 
| alnip<br/>
 
| alnip<br/>
| <br/>
+
| '''[http://old.ecmwf.int/publications/manuals/d/gribapi/param/detail/filter=grib1/format=mars/order=paramId/order_type=asc/p=1/pid=17/table=128/ Near IR albedo for direct radiation]'''<br/>
 
| <br/>
 
| <br/>
 
| EI_iniggsfc.grb<br/>
 
| EI_iniggsfc.grb<br/>
 
|-
 
|-
 
| alnid<br/>
 
| alnid<br/>
| <br/>
+
| '''[http://old.ecmwf.int/publications/manuals/d/gribapi/param/detail/filter=grib1/format=mars/order=paramId/order_type=asc/p=1/pid=18/table=128/ Near IR albedo for diffuse radiation]'''<br/>
 
| <br/>
 
| <br/>
 
| EI_iniggsfc.grb<br/>
 
| EI_iniggsfc.grb<br/>
 
|-
 
|-
 
| lai_lv<br/>
 
| lai_lv<br/>
| <br/>
+
| '''[http://old.ecmwf.int/publications/manuals/d/gribapi/param/detail/filter=grib1/format=mars/order=paramId/order_type=asc/p=1/pid=66/table=128/ Leaf area index, low vegetation]'''<br/>
 
| <br/>
 
| <br/>
 
| EI_iniggsfc.grb<br/>
 
| EI_iniggsfc.grb<br/>
 
|-
 
|-
 
| lai_hv<br/>
 
| lai_hv<br/>
| <br/>
+
| '''[http://old.ecmwf.int/publications/manuals/d/gribapi/param/detail/filter=grib1/format=mars/order=paramId/order_type=asc/p=1/pid=67/table=128/ Leaf area index, high vegetation]'''<br/>
 
| <br/>
 
| <br/>
 
| EI_iniggsfc.grb<br/>
 
| EI_iniggsfc.grb<br/>
 
|-
 
|-
 
| sdfor<br/>
 
| sdfor<br/>
| <br/>
+
| '''[http://old.ecmwf.int/publications/manuals/d/gribapi/param/detail/filter=grib1/format=mars/order=paramId/order_type=asc/p=1/pid=74/table=128/ Standard deviation of filtered subgrid orography]'''<br/>
 
| <br/>
 
| <br/>
 
| EI_iniggsfc.grb<br/>
 
| EI_iniggsfc.grb<br/>
 
|-
 
|-
 
| lsm<br/>
 
| lsm<br/>
| <br/>
+
| '''[http://old.ecmwf.int/publications/manuals/d/gribapi/param/detail/filter=grib1/format=mars/order=paramId/order_type=asc/p=1/pid=172/table=128/ Land-sea mask]'''<br/>
 
| <br/>
 
| <br/>
 
| EI_iniggsfc.grb<br/>
 
| EI_iniggsfc.grb<br/>
 
|-
 
|-
 
| z<br/>
 
| z<br/>
| <br/>
+
| '''[http://old.ecmwf.int/publications/manuals/d/gribapi/param/detail/filter=grib1/format=mars/order=paramId/order_type=asc/p=1/pid=129/table=128/ Geopotential]'''<br/>
 
| <br/>
 
| <br/>
 
| EI_iniggsfc.grb<br/>
 
| EI_iniggsfc.grb<br/>
 
|-
 
|-
 
| slt<br/>
 
| slt<br/>
| <br/>
+
| '''[http://old.ecmwf.int/publications/manuals/d/gribapi/param/detail/filter=grib1/format=mars/order=paramId/order_type=asc/p=1/pid=43/table=128/ Soil type]'''<br/>
 
| <br/>
 
| <br/>
 
| EI_iniggsfc.grb<br/>
 
| EI_iniggsfc.grb<br/>
Line 351: Line 349:
 
<u>TIPS</u>: to get the usage of these python scripts, use -h or --help. For instance:
 
<u>TIPS</u>: to get the usage of these python scripts, use -h or --help. For instance:
  
&nbsp;getEIdata.py -h<br/>Usage: getEIdata.py --start_date=YYYYMMDD [--end_date=YYYYMMDD] [--times=tt1/tt2/tt3]<br/>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; [--grid_type=gtype] [--levels=nlevels]<br/>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; [--sfc=sfc.grb] [--ggml=ggml.grb] [--shml=shml.grb]<br/>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; [--inputdir=input_directory] [--outputdir=output_directory]<br/><br/>Options:<br/>&nbsp; -h, --help&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; show this help message and exit<br/>&nbsp; -s start_date, --start_date=start_date<br/>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; start date YYYYMMDD<br/>&nbsp; -e end_date, --end_date=end_date<br/>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; end_date YYYYMMDD<br/>&nbsp; -t times, --times=times<br/>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; times such as 00/12<br/>&nbsp; -l levels, --levels=levels<br/>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; number of levels i.e. 60<br/>&nbsp; --sfc=sfc&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; output filename where surface data will be stored<br/>&nbsp; --ggml=ggml&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; output filename where upper data on reduced gaussion<br/>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; grid will be stored<br/>&nbsp; --shml=shml&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; output filename where shperical harmonic upper data<br/>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; will be stored<br/>&nbsp; --inputdir=inputdir&nbsp;&nbsp; root directory for reading input files (valid when<br/>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; retrieve=no)<br/>&nbsp; --outputdir=outputdir<br/>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; root directory for storing output files<br/>&nbsp; --grid_type=grid_type<br/>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; grid type default is l_2<br/>
+
&nbsp;getEIdata.py -h<br/>Usage: getEIdata.py --start_date=YYYYMMDD [--end_date=YYYYMMDD] [--times=tt1/tt2/tt3]<br/>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; [--grid_type=gtype] [--levels=nlevels]<br/>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; [--sfc=sfc.grb] [--ggml=ggml.grb] [--shml=shml.grb]<br/>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; [--inputdir=input_directory] [--outputdir=output_directory]<br/><br/>Options:<br/>&nbsp; -h, --help&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; show this help message and exit<br/>&nbsp; -s start_date, --start_date=start_date<br/>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; start date YYYYMMDD<br/>&nbsp; -e end_date, --end_date=end_date<br/>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; end_date YYYYMMDD<br/>&nbsp; -t times, --times=times<br/>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; times such as 00/12<br/>&nbsp; -l levels, --levels=levels<br/>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; number of levels i.e. 60<br/>&nbsp; --sfc=sfc&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; output filename where surface data will be stored<br/>&nbsp; --ggml=ggml&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; output filename where upper data on reduced gaussion<br/>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; grid will be stored<br/>&nbsp; --shml=shml&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; output filename where shperical harmonic upper data<br/>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; will be stored<br/>&nbsp; --inputdir=inputdir&nbsp;&nbsp; root directory for reading input files (valid when<br/>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; retrieve=no)<br/>&nbsp; --outputdir=outputdir<br/>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; root directory for storing output files<br/>&nbsp; --grid_type=grid_type<br/>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; grid type default is l_2
  
 
<span style="color:#ff0000">'''For each of these python scripts, some arguments are optionals and indicated in squared brackets such as end_date.'''</span>
 
<span style="color:#ff0000">'''For each of these python scripts, some arguments are optionals and indicated in squared brackets such as end_date.'''</span>
  
<span style="color:#ff0000"</span>
+
&lt;span style="color:#ff0000"</span&gt;
  
 
==== Step-2: interpolate input fields to the chosen horizontal and vertical resolution ====
 
==== Step-2: interpolate input fields to the chosen horizontal and vertical resolution ====

Revision as of 10:49, 2 December 2014

OpenIFS - Open Integrated Forecasting System

OpenIFS provides academic and research institutions with an easy-to-use version of the ECMWF IFS (Integrated Forecasting System). OpenIFS provides the forecast capability of IFS (no data assimilation), supporting software and documentation. OpenIFS has a support team at ECMWF for technical assistance but limited resources for detailed scientific assistance.

About OpenIFS provides more information about the model.


First check openifs availability on your platform. Currently openIFS is available on UIO HPC (abel.uio.no) only.

module avail openifs

-------------------------------------------------------------------------------- /cluster/etc/modulefiles ---------------------------------------------------------------------------------
openifs/38r1v04(default)


If nothing is returned, it is likely openifs is not available. If you think it should, then contact us (drift@uio.no).

To load a given  openifs version:

module load openifs/38r1v04

We suggest you specify the version you wish to use to avoid any problems if we install a new default version (as it is important to stick to the very same version for your  simulations).


When loading openifs the following environment variables are defined:

  • OIFS_CYCLE: ECMWF cycle such as 38r1 (version 38, revision 1)
  • OIFS_HOME: directory where openIFS has been installed; this can be used to check openIFS sources
  • OIFS_DATA: contains openIFS static input data. Even if you use your own compiled version of openIFS, it is NOT necessary to download these files again.
  • OIFS_EXAMPLES: directory where all openIFS examples are stored. If you wish to run one of these examples see our dedicated section on running tutorials.
  • OIFS_COMP: compilers used to create openIFS executables. We currently use intel compilers.
  • OIFS_BUILD: type of build. It triggers a set of compiler options when building openIFS. Currently set to "opt"
  • OIFS_GRIB_API_DIR: GRIB-API version used by openIFS to encode/decode GRIB files
  • MARS_LSM_PATH: land sea mask used
  • EMOS_VERSION: EMOS version (compiled with GRIB-API support). EMOS is used for interpolation routines.
  • EMOS_HOME: directory where EMOS has been installed.
  • BUFR_TABLES: bufrtables used for decoding/encoding BUFR (not used in the forecast model)
  • CREX_TABLES: crex tables used for encoding/decoding CREX data.


For building openIFS, we use intel compilers:

module list
Currently Loaded Modulefiles:
  1) use.own                3) openmpi.intel/1.6.1    5) hdf5/1.8.9_intel       7) grib_api/1.12.3        9) udunits/2.2.16        11) intelmpi.intel/4.1.3
  2) intel/2011.10          4) python2/2.7.3          6) netcdf.intel/4.2.1.1   8) perlmodules/5.10_2    10) intel/2013.sp1.1      12) openifs/38r1v04


Running openIFS:

The main openIFS program (forecast model) is called master.exe but as for most models, several steps have to be done before the first call to master.exe!

The main steps are:

- get meteorological input fields (see examples on how to get ECMWF reanalysis data with ecmwfapi).

- interpolate input fields to the chosen horizontal and vertical resolution

- run forecast model to generate output fields


To perform these steps, some python scripts have been developed:

Step-1: get meteorological input fields

  • getEIdata.py 


This script retrieves the  ERA-Interim data required to run openIFS from ECMWF Meteorological archive (MARS). You need to make sure ecmwfapi is properly set-up for your user account. See here how to get ECMWF API keys.  If you have any problem contact drift@geo.uio.no

To use getEIdata.py, you need to specify the retrieval dates (at least the starting date). For instance:

getEIdata.py --start_date=20030103


the above command retrieves ERA-Interim data for the 3rd January 2003 for time=00 and write them in $WORKDIR/20030103/00

  • EI_shml.grb: contains spherical harmonics  fields on model levels
  • EI_ggml.grb: contains model levels fields on a reduced gaussian grid
  • EI_iniggsfc.grb: contains surface data on a reduced gaussian grid


The table below gives a short description of the parameters contained in these 3 files:

Shortname
Description
Retrieved/Computed/Climate
 File
lnsp
Logarithm of surface pressure

EI_shml.grb
t
Temperature

EI_shml.grb
vo
Vorticity (relative)

EI_shml.grb
d
Divergence

EI_shml.grb
o3
Ozone mass mixing ratio

EI_ggml.grb
clwc
Specific cloud liquid water content

EI_ggml.grb
ciwc
Specific cloud ice water content

EI_ggml.grb
cc
Cloud cover

EI_ggml.grb
q
Specific humidity

EI_ggml.grb
crwc
Specific rain water content

EI_ggml.grb
cswc
Specific snow water content

EI_ggml.grb
swvl1
Volumetric soil water layer 1

EI_iniggsfc.grb
swvl2
Volumetric soil water layer 2

EI_iniggsfc.grb
swvl3
Volumetric soil water layer 3

EI_iniggsfc.grb
swvl4
Volumetric soil water layer 4

EI_iniggsfc.grb
stl1
Soil temperature level 1

EI_iniggsfc.grb
stl2
Soil temperature level 2

EI_iniggsfc.grb
stl3
Soil temperature level 3

EI_iniggsfc.grb
stl4
Soil temperature level 4

EI_iniggsfc.grb
skt
Skin temperature

EI_iniggsfc.grb
tsn
Temperature of snow layer

EI_iniggsfc.grb
sd
Snow depth

EI_iniggsfc.grb
rsn
Snow density

EI_iniggsfc.grb
asn
Snow albedo

EI_iniggsfc.grb
src
Skin reservoir content

EI_iniggsfc.grb
ci
Sea-ice cover

EI_iniggsfc.grb
sst
Sea surface temperature

EI_iniggsfc.grb
istl1
Ice temperature layer 1

EI_iniggsfc.grb
istl2
Ice temperature layer 2

EI_iniggsfc.grb
istl3
Ice temperature layer 3

EI_iniggsfc.grb
istl4
Ice temperature layer 4

EI_iniggsfc.grb
anor
Angle of sub-gridscale orography

EI_iniggsfc.grb
isor
Anisotropy of sub-gridscale orography

EI_iniggsfc.grb
slor
Slope of sub-gridscale orography

EI_iniggsfc.grb
sdor
Standard deviation of orography

EI_iniggsfc.grb
sr
Surface roughness

EI_iniggsfc.grb
lsrh
Logarithm of surface roughness length for heat

EI_iniggsfc.grb
cvh
High vegetation cover

EI_iniggsfc.grb
cvl
Low vegetation cover

EI_iniggsfc.grb
tvh
Type of high vegetation

EI_iniggsfc.grb
al
Albedo

EI_iniggsfc.grb
aluvp
UV visible albedo for direct radiation

EI_iniggsfc.grb
aluvd
UV visible albedo for diffuse radiation

EI_iniggsfc.grb
alnip
Near IR albedo for direct radiation

EI_iniggsfc.grb
alnid
Near IR albedo for diffuse radiation

EI_iniggsfc.grb
lai_lv
Leaf area index, low vegetation

EI_iniggsfc.grb
lai_hv
Leaf area index, high vegetation

EI_iniggsfc.grb
sdfor
Standard deviation of filtered subgrid orography

EI_iniggsfc.grb
lsm
Land-sea mask

EI_iniggsfc.grb
z
Geopotential

EI_iniggsfc.grb
slt
Soil type

EI_iniggsfc.grb

CheckECMWF parameter database to get a more extensive description of all available parameters.


TIPS: to get the usage of these python scripts, use -h or --help. For instance:

 getEIdata.py -h
Usage: getEIdata.py --start_date=YYYYMMDD [--end_date=YYYYMMDD] [--times=tt1/tt2/tt3]
                                                  [--grid_type=gtype] [--levels=nlevels]
                                                  [--sfc=sfc.grb] [--ggml=ggml.grb] [--shml=shml.grb]
                                                  [--inputdir=input_directory] [--outputdir=output_directory]

Options:
  -h, --help            show this help message and exit
  -s start_date, --start_date=start_date
                        start date YYYYMMDD
  -e end_date, --end_date=end_date
                        end_date YYYYMMDD
  -t times, --times=times
                        times such as 00/12
  -l levels, --levels=levels
                        number of levels i.e. 60
  --sfc=sfc             output filename where surface data will be stored
  --ggml=ggml           output filename where upper data on reduced gaussion
                        grid will be stored
  --shml=shml           output filename where shperical harmonic upper data
                        will be stored
  --inputdir=inputdir   root directory for reading input files (valid when
                        retrieve=no)
  --outputdir=outputdir
                        root directory for storing output files
  --grid_type=grid_type
                        grid type default is l_2

For each of these python scripts, some arguments are optionals and indicated in squared brackets such as end_date.

<span style="color:#ff0000"</span>

Step-2: interpolate input fields to the chosen horizontal and vertical resolution

  • prepareInterpolationEIdata.py
  • runInterpolation.py 
  • postInterpolationEIdata.py  

Step-3: run oenIFS forecast model

  • prepareOpenifsRun.py
  • runOpenIFS.py 



openIFS examples:

There are 3 examples currently available:

cd $OIFS_EXAMPLES

ls

ei     osloctm         t21test


T21 simple test:

Choose a directory of your choice and copy this simple test:

mkdir -p $HOME/openifs/examples

cd $HOME/openifs/examples

cp -R $OIFS_EXAMPLES/t21test .

cd t21test

ls

fort.4  ICMGGepc8  ICMGGepc8INIT  ICMGGepc8INIUA  ICMSHepc8  ICMSHepc8INIT  ifsdata  job  namelists  README  ref_021_0144

./job_uio


This is a very short and simple example and it can be run interactively (./job_uio).

All the input fields are already available and by executing job_uio, you run  ECMWF openIFS forecast model. 


Output fields generated by openIFS are:

ICMSHepc8+000000

ICMGGepc8+000000


SH means Spherical harmonics and GG Gaussian grid. These files are in  GRIB-2 format.

You may convert these GRIB files to netCDF using cdo; for instance on sverdrup:

module load cdo/1.6.5.1

cdo -t ecmwf -f nc copy ICMSHepc8+000000 ICMSHepc8+000000.nc


For more information, see ECMWF How to convert OpenIFS outputs to netCDF.


T319 with ERA-Interim input fields:

T42 with ERA-Interim input fields for OsloCTM model: