README June 17, 2008
SUTRA-GUI - Version: 2.1.0.0 (2008/06/17)
Preprocessor and postprocessor graphical-user interface for
preparing SUTRA input data and for viewing model output for use within
Argus Open Numerical Environments (Argus ONE)
For assistance, enhancement requests, or bug reports contact the
Hydrologic Analysis Software Support Program via e-mail sent to
h2osoft@usgs.gov. See the file doc\sutra-gui.txt for descriptions,
references, and additional information on this software. Instructions
for installation and execution of this software are provided below.
SUTRA-GUI is implemented as a plug-in extension (PIE) for use with
Argus ONE version 4. Although Argus ONE runs on a variety of computing
platforms, the PIE for SUTRA is only available for systems running
Microsoft Windows 9x or NT.
References to commercial vendors of software products or services is for
informational purposes only and does not imply endorsement by the U.S.
Government.
TABLE OF CONTENTS
A. COMPILING
B. INSTALLING
C. USING SUTRA-GUI
a. COMPILING
SUTRA-GUI may be compiled with Borland Delphi Professional 5.0. However, it uses a number of components that are not distributed with Borland Delphi 5. These include
TArgusDataEntry by Richard B. Winston,
TRBWZoomBox by Richard B. Winston,
TASLink copyright Andrey Abakumov,
TVersionInfo Copyright WinWright Consulting.
TDataGrid 2.0 copyright EC Software, and
Except for TRBWZoomBox the source code for these components is distributed, with permission of the copyright owners, along with the source code for the MODFLOW GUI. These components must be installed before attempting to open or compile
SUTRA-GUI. The source code for TRBWZoomBox is in the Compenents/ZOOMBOX directory of the source directory.
B. INSTALLING
For whichever distribution file that you have acquired,
the directory "SutraGUI" is
created when the files are extracted from the distribution file. Any
directory that exists from a previous SUTRA-GUI installation must be
deleted first.
It is important that no prior version of SutraGUI remain installed
because Argus ONE searches for and loads all PIEs found in the ArgusPIE
directory of the Argus ONE installation. If an older version of
SutraGUI is retained, that version could be used by Argus ONE instead of
the newer SutraGUI version. Delete the directory of any
previously-installed version of SutraGUI found in the ArgusPIE
directory.
Using a utility program that recognizes the zip compressed format and
that preserves long filenames, extract the files from the SutraGUI
distribution file into the ArgusPIE directory of the existing
installation of Argus ONE, e.g.,
C:\Program Files\Argus Interware\ArgusPIE, being sure to set any options
necessary to restore the directory structure stored in the distribution
file.
SutraGUI directory will contain the following plug-in extension
files:
Sutra3DGUI.dll - PIE library
(compiled)
sutrareader.dll -
library to read SUTRA input files (compiled)
sutra.met - export template; sutra.met is a text file.
Sutra GUI.hlp - Help file
Sutra GUI.cnt - Help contents file
CheckMatchBC.exe
The executable version of SUTRA (sutra.exe) is assumed to be located in a directory with the pathname C:\sutra; the full pathname of the executable for SUTRA is assumed to be C:\sutra\sutra.exe. If the executable version of SUTRA is located in another directory, the correct path may be entered on the Configuration tab while running the program.
Several other accessory PIEs are used by SUTRA GUI. These include Sutra_JoinFiles.dll, GetMyDirectory.dll, Sutra_List.dll, OkCancel.dll, Sutra_ProgressBarPIE.dll, and Sutra_ReadFileValue.dll
C. USING SUTRA-GUI
After SUTRA-GUI is properly installed (see INSTALLING, above), the
plug-in extensions will be automatically loaded when Argus ONE is
launched.
The preprocessor is utilized by selecting the "New SUTRA Project..."
menu item from the PIEs menu.
The postprocessor is utilized by selecting the "SUTRA Post Proc..."
menu item from the PIEs menu.
Full instructions are given in the SUTRA-GUI documentation; see
http://water.usgs.gov/software/sutra-gui.html.