Case Run Manager

The OMEGA case is an encapsulation that holds all the information relevant 
to the simulation.  Within a case are one or more runs.  A run is a 
particular simulation of the weather over the area defined by a case.

After choosing a case id, a sequence of directories are created that will hold 
all the files associated with the case.  First, the case directory itself is 
made, then two sub-directories are created.  The grid directory will hold 
input and output files used in generating the case grid. The prep directory 
will hold files used in processing meteorology into initial and boundary 
conditions. A few log files will also be started at this point. The log files 
record the various steps taken by the system as it builds the simulation. In 
addition some system configuration files are copied into the case directory, 
and a few even more specific environment variables are set.  All of the 
directory and file creation described in this section is done by XOMEGA 
and omega.  

The Case and Run Manager dialog can be used to test OMEGA simulations for 
completeness.  When a case and run are selected, the buttons in the OMEGA 
Settings column will turn gold if a particular Setting is complete for
that case and run.  For Settings that have not been made the button will
remain grey.  By selecting cases and runs in the Loaded ... list widgets and 
observing which buttons change you can quickly asses the status of all
the cases and runs that are loaded.

The Case Run Manager has three sections: Case Controls, Run Controls and 
a Action Buttons.


Case Controls Section

This section has some simple instructions, two buttons and a list widget.

Create a New Case - This button will bring up a Create New Case dialog box.

Create New Case Dialog Box

This dialog box is a variant of the file selection dialog that allows you to 
navigate among directories and files.  The default location is within the 
current working directory.  The Filter Line, Directories List and Files List 
allow you to change the default location.  There are some simple instructions 
and guidelines on case names.  The Enter line is where you enter the id of 
your case.

Create - When this button is pressed the new case is created on disk.

Filter - This button refreshes the contents of the Directories and Files 
         lists based on the data in the Filter line.

Cancel - Cancel the Create New Case operation.


Search for Existing Cases - This button will bring up the Search for 
                            Existing Cases Dialog Box.

Search for Existing Cases Dialog Box

This is a standard file selection box.  Use the Filter Line, Directories 
and Files Lists to navigate among directories.

Search - Click on this button to initiate the search.  Any valid OMEGA Cases
         that exist will be transfered to the Loaded Cases list on 
         the Case Run Manager dialog.

Filter - This button refreshes the contents of the Directories and Files 
         lists based on the data in the Filter line.

Cancel - Cancel the Search for Existing Case operation.



Loaded Cases - This list widget will present all the currently loaded
               cases.  Each case is shown as the full path name 
               of the case directory.   Selecting a case will highlight it.

By clicking once on a case in the list, those case settings will be loaded 
into XOMEGA.  If the case data contains errors, then an error dialog box and 
the corresponding Settings dialog box will be popped up.  If there are no 
errors the corresponding button in the OMEGA Settings Column will be colored 
gold, to indicate completion of that operation.

By clicking twice on a case you will get a quick summary of the case in
an information dialog box.



Run Controls Section

Create a New Run - This button will bring up a Create New Run dialog box.

Create New Run Dialog Box

This simple dialog box allows you to enter the name of the run.  The default 
run id is the current date and 00 hour in the ISO 8601 format (YYYYMMDDhh00).

Create - When this button is pressed the new run is created on disk.

Cancel - Cancel the Create New Case operation.



Loaded Runs - This list widget will present all the currently loaded
              runs for the selected case.  Each run is shown as the full 
              path name of the run directory.

By clicking once on a run in the list, that run's settings will be loaded
into XOMEGA.  If the run data contains errors, then an error dialog box and
the corresponding Settings dialog box will be popped up.  If there are no
errors the corresponding button in the OMEGA Settings Column will be colored
gold, to indicate completion of that operation.

By clicking twice on a run you will get a quick summary of the case in
an information dialog box.



Action Buttons Section

Clear Form - This button will reset the list widgets to blanks. 

Default -  This button will reset the list widgets to their default values.

OK - This button will accept the selected Case and Run choices from the list 
     widgets and cause XOMEGA to build the directory hierarchy on the disk.

Cancel - This button will decline all Case and Run info and reset XOMEGA
         to the default state.  It will also close the dialog box.
         There is no confirmation process.

Help - This button will open the Help dialog and load this section.


END Case Run Manager