Call Prep Met

After all raw met data has been gathered for the met segments, the 
next step is to process this data into initial conditions (ICs) and boundary 
conditions (BCs).  There are several programs that work on the data and 
collectively they are known as the OMEGA Preprocessor.  A single sh script, 
"runprep" binds the other more specialized programs together.

Since the preprocessor 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 the runprep program.
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 runprep.  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 processed data specified in Segment 1.  In general segment
1 will be the only segment with an initial conditions file.  Within each 
segment BC files will be made.  After all the segments are processed omega 
will rename the BC files to form a sequence and copy them up to the case 
directory.

When you click on "Call Prep 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 Spatial Domain Data, or the Meteorology Data have not been 
filled in, or if the Fetch Meteorology operation has not been completed, 
then the Call Prep 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 appropriate 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.



Call Prep Met Warning 

This dialog box is popped up when you try to Call Prep Met and a valid 
set of initial and boundary conditions already exists.  The top part of the 
dialog contains the warning message.  The bottom part has a row of three 
action buttons:

Overwrite - This button will Call the Prep Met process.  All existing 
            preprocessor information in the "prep/seg*" sub-directories will 
            be overwritten as the new files are made.  
            The Call Prep Met Warning dialog will be dismissed.

Proceed - This button will accept the existing files.  The Call Prep Met
          operation is completed.
          The Call Prep Met Warning dialog will be dismissed.

Cancel - This button will decline the existing files.  The Call Prep Met 
         operation is NOT completed.
         The Call Prep Met Warning dialog will be dismissed.

END Call Prep Met