Call Fetch Met

When you are satisfied with the subdivision of your temporal domain into one 
or more met segments, the next step is to gather together the raw data.
The procedure that searches the file system for the appropriate met data 
files and copies them into the case/run/prep directory is called Fetching.

The OMEGA system has several different fetch programs.  Most are csh shell
scripts and they all generally work the same way.  In the discussion that 
follows they will be referred to collectively as Fetch.  Since the fetch 
programs are independent of XOMEGA they need to be called in a controlled
way.  The mechanism for doing this is to use an intermediate program called 
omega.  omega is the text based user interface to the OMEGA System.  Nearly 
all the functionality of using the OMEGA System may be controlled by omega.  
Please see the omega documentation for more information.  XOMEGA first calls 
omega, which then calls one or more fetch programs.  This chain of command
allows for cleaner file manipulations, better error control and a 
non-graphical backup redundant capability.

At the completion of the Set Meteorology Data stage, XOMEGA writes out a file
called "met.inp" in the "case/run/prep" directory.  This file contains a 
summary of the met segment parameters.  The omega program reads this file, 
and for each segments calls one or more fetch programs.  To keep the individual 
met segments separate each segment is processed in a its own subdirectory.  
These directories are below the prep directory.  For example 
"case/run/prep/seg1" will hold all the raw data specified in Segment 1.  

When you click on "Call Fetch Met" a small dialog box pops up.  This 
dialog consists of two sections: Status Message and a row of Action 
Buttons.

Note that if the Meteorology Data has not been filled the 
Call Fetch Met dialog will not pop up.  Instead an error message will
pop up informing you of the error.  When you acknowledge the error by
clicking the "OK" button the Set Meteorology Data dialog will pop up.


Status Message

This is a simple line of text with the current status of the external program.


Action Buttons

Pause - This button will pause the currently running external process.
        When clicked the label will change to resume, the blinking icon
        will stop, and the Status Message will show that the process is 
        paused.  The continue the process click on Resume.

Cancel - When the external process is running this button will be inactive.  
         When the process is paused this button will be active.  Clicking on 
         Cancel will cancel the operation, and close the Grid Generator dialog.

Help - When the external process is running this button will be inactive.  
       When the process is paused this button will be active.  This button 
       will open the Help dialog and load this section.


Fetch Meteorology Warning 

This dialog box is popped up when you try to Call Fetch Met and a valid set 
(or partial set) of met data already exists for the case.  The top part of 
the dialog contains the warning message.  The bottom part has a row of three 
action buttons:

Overwrite - This button will Start the Fetch process.  All existing 
            information in the "prep/seg*" sub-directories will be overwritten 
            as the new set of data is gathered. 

Proceed - This button will accept the existing set of met data.  All existing
          met data is left untouched and the Fetch Meteorology operation 
          is completed.
          The Fetch Meteorology Warning dialog will be dismissed.

Cancel - This button will decline the existing set of met data.  All existing
         met data is left untouched and the Fetch Meteorology operation 
         is NOT completed.
         The Fetch Meteorology Warning dialog will be dismissed.

END Call Fetch Met