NOTES:
======
-To enable real time operational forecasts with GEM model
 the only thing needed is the operational 00 or 12 UTC
 CMC analysis.

- Recall the test_run/CASES directory looked like:
./CASES
  ----> clim_gef_400_mars96                                       (Climatology)
  ----> geophy_400 or gengeoout_global_6km.fst_0000001-0000001    (geophysical flds)
  ----> 20010920.120000                                           (analysis data)
- The Climatology , geophysical fields are the same as those used
  for the test_run.

- The analysis data is the only thing to be fetched from the web.
  After the data is downloaded, it needs to be converted to grib1
  format followed by a conversion to the FST format.

  All these steps are performed by a bash script fetch_cmcanalysis_convert_grib2fst.sh
  provided in this directory.

Usage: 
======
Set the environment variables:
export CMCDICT=/d1/badri/model/launch/GEM/run_realtime 
export CMCGRIB=/d1/badri/model/ICLBC/cmcgrib_cvt-3.4.1

for 00 UTC 
----------
chmod u+x fetch_cmcanalysis_convert_grib2fst.sh (if needed)
./fetch_cmcanalysis_convert_grib2fst.sh --analysis_hour=00  

for 12 UTC
----------
chmod u+x fetch_cmcanalysis_convert_grib2fst.sh (if needed)
./fetch_cmcanalysis_convert_grib2fst.sh --analysis_hour=12

- CMC provides the data set in Lat-Lon (Regular or grtyp='L') system.
  The GEM preprocessor handles this input dataset.
- CMC may also provide data set in rotated Lat-Lon (grtyp=E) system.
  Again the GEM preprocessor can handle this input dataset.
- The input fields (2-D and 3-D) needed by the model are described
  here: http://collaboration.cmc.ec.gc.ca/science/rpn.comm/wiki1/doku.php?id=gem:input_fields_list

Dictionary files 
================
The following files are used by the bash script in order to convert the grib1 format to
FST format:

dictionary.grib.all_except_i7_i9.tmp
------------------------------------
This file is used for all the fields except for fields I7 (Sea ice temperature)
and I9 (Glacier Temperature).

dictionary.grib.only_i7_1197 & -dictionary.grib.only_i7_1199_1198
-----------------------------------------------------------------
The sea ice temperature field consists of 3 levels: surface, layer 1 and layer
2 (deep soil) temperature. The surface and layer 1 temperature is a copy
of I0 (surface and soil temperature) given by the analyses while the layer 2
temperature is set to [I0(soil or 1198 level) - 271.2]/2.

dictionary.grib.only_i9
-----------------------
The glacier temperature (surface and deep soil) are copies of I0.

NOTE: A more fancy way of doing this would be to use CMC's tool geophy.Abs.
      In order to reduce too many moving parts in the entire operational system
      we have taken this approach of performing these steps using the dictionary
      file.


RUN SETUP
=========
Please use steps 1-5 from ../run_test/README.TESTRUNGEMDM.