Laserfiche WebLink
StateMod GUI Documentation <br />1.0 Introduction <br />The StateMod GUI is a graphical user interface for the StateMod model. The StateMod GUI simplifies <br />modeling tasks, including visualizing data, modifying data files, and executing StateMod. The StateMod <br />GUI operates on StateMod data sets described by a response file (see the StateMod model documentation <br />for more information about response files). It is assumed that if you use the StateMod GUI you are also <br />familiar with the StateMod model, including data files and model functionality. Because of the large <br />amount of data stored in StateMod files, it is not generally practical to create a data set from scratch using <br />the GUI. Instead, for example within Colorado's Decision Support Systems, DMI (data management <br />utilities) are used to create baseline data sets, which are then run and modified using the StateMod GUI. <br />For example, the TSTooI program can be used to create the StateMod time series files. The comments at <br />the top of StateMod input files indicate the program(s) that have been used to create the files. <br />The StateMod GUI does not check that all user-supplied data are reasonable. After editing data, StateMod <br />should be run in data-check mode to catch possible user errors (see Section 5.0, Run Menu). It is your <br />responsibility to read error messages generated by StateMod and react accordingly. A log file is created <br />by StateMod in the data set directory with a name matching the data set and the extension .log. This log <br />file should be reviewed to resolve problems. <br />The StateMod GUI reads most of the currently selected StateMod data set into memory at the time that a <br />data set is selected. When data are edited, the changes are made to the copy of the data within memory <br />(instead of immediately writing to the data files for each change, which would be slow). The StateMod <br />GUI will automatically detect when changes to data occur and will notify you before making a model run <br />or closing the StateMod GUI. You can then choose to save the files. The StateMod GUI will only write <br />the changes to the appropriate files when you indicate to do so by selecting File...Save Data Files. If the <br />changes are not saved to files, then the next run of the StateMod model will use the previously saved <br />version of the data files. This type of edit tracking is necessary because the StateMod GUI and StateMod <br />model are separate programs. <br />To avoid complicated displays, not all of the information for a particular model data type (e.g., diversion <br />structure) is shown in main display windows. For example, the diversion window shows the list of <br />diversions and general information for the selected diversion. To see the direct flow demands, return <br />flow, and water rights for the diversion, additional windows are provided and can be accessed by clicking <br />on the appropriate button within the diversions interface. <br />The StateMod data shown in this document are not discussed in detail. For more information about the <br />model, the data necessary to run the model, and modeling guidelines, see the StateMod model <br />documentation. <br />A typical StateMod GUI session consists of the following steps: <br />1. Run the StateMod GUI from the start menu (Start...Programs...CDSS...SMGUI or <br />Start...Programs CDSS...StateMod GUn. Immediately after starting, the StateMod GUI will run <br />statemod -version to determine the StateMod model version. This confirms that StateMod <br />can be found and identifies the StateMod version for subsequent actions. <br />2. Select a data set by selecting a StateMod response file using the File...Open menu (see Section 3.0). <br />3. View and edit data using the Data menu (see Section 4.0). <br />4. Run the model using the Run menu (see Section 5.0). <br />5. View output using the View menu (see Section 6.0). <br />6. Exit the StateMod GUI using File...Exit. <br />StateMod GUI - 2 <br />