You are currently reviewing an older revision of this page.
Below are some modeling methods and information for WaterGems beyond what is provided in the product documentation.
The model datastore in a Jet format (as used by MS Access). It contains one model dataset and all the data for the modeling elements. It is a self-contained file that contains all the data required to make a model run. All other file types can be deleted without harming the datastore, and the model will still function.
A WaterGems Project file containing project data in an XML format. There are many components to it, however some of the more important ones are:
A WaterGems drawing file. It's primary purpose is to speed up the opening of model files inside the Stand-alone envrionment with pre-saved drawing data. It contains the last saved model element drawing display coordinates, symbology (eg. Color, Line Thickness Multipliers) and decorations (eg. Flow Arrows). In this fashion, WaterGems does not need to refresh the drawing during the opening of a model. Its contents are read directly into memory, and does not participate in the active session itself.
Saving a WaterGems file in the Stand-Alone environment triggers this file to be regenerated, and is usually the slowest part of the save process.
During a model open, if WaterGems detects that the DWH is out-of-sync with Project, or is not present at all, this will trigger WaterGems to refresh the entire drawing, and a dialog for the Synchronise Drawing process will appear during the model open.
When a WaterGems model is opened, the following actions occur:
When a WaterGems model is being edited:
When a WaterGems model is saved, the following actions occur:
Result files are treated similarly to model data files, but with some subtle differences:
Sometimes a runtime error will occur during the model save process, and the model will "appear" to not have saved, with no apparent way of saving the model. Generally these errors occur during the generation of the *.dwh file in the Project Directory. However, the copy and paste operation of the *.wtg.mdb and *.wtg files from the Working Directory to the Project Directory generally always completes, which is the only thing important in these instances.
The important files, the *.wtg.mdb, and *.wtg files have saved, although the *.dwh file is often corrupted in these instances. After a "failed" save, the user can simply close the model (choosing not to save in the 2nd instance), delete the *.dwh file from the Project Directory, and reopen the model.
For added assurance, a user can compare the timestamps between the Working Directory and Project Directory copies of the *.wtg.mdb and *.wtg files to ensure they are the same. If they are not, the user can manually copy, paste and rename the files from the Working Directory to the Project Directory.
There are two problems in these instances, one obvious, and one not obvious:
The solution can treat both symptoms. Model edits are recoverable because the Working Directory copies of the model files are updated as and when edits are made. The user can go into the Working Directory and manually copy, paste and rename the files into the Project Directory to retrieve his/her model edits.
This error indicates a lack of space of the volume (usually C:) that contains the WaterGems Working Directory. Often, this is caused by an accumulation of WaterGems abnormal application terminations. This progressively accumulates copies of models in the Working Directory, eventually causing a lack of free space.
Close any open WaterGems session, and go into the Working Directory (not the Project Directory). Clean all files out of this directory.