README                                                  June 7, 2001


                SUTRA-GUI - Version: 1.04 (2001/06/07)
       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. DISTRIBUTION FILES
                         B. INSTALLING
                         C. USING SUTRA-GUI


A. DISTRIBUTION FILES

The following distribution files (containing the software and
information files) are currently available.

   sutra-gui104.zip  - Compiled using Microsoft Visual C++ (5.0)
   sutra-gui104s.zip - Source code only

The above zip files must be unzipped using a utility that preserves long
filenames, such as PKZIP for Windows.  A shareware version of PKZIP for
Windows is available from PKWARE at this World Wide Web site:
      http://www.pkware.com/

and by File Transfer Protocol (FTP) from the following site:
      ftp.pkware.com 

Included in directory sutra-gui1.02\doc is a Portable Document Format (PDF)
version of the SUTRA-GUI documentation (sutra-gui.pdf).  A PostScript
version of this report is available from:
      https://water.usgs.gov/software/sutra-gui.html

PDF files are readable and printable on various computer platforms using
Acrobat Reader from Adobe.  The Acrobat Reader is freely available from
the following World Wide Web sites:
      http://www.adobe.com/
      http://www.shareware.com/
      
and by File Transfer Protocol (FTP) from the following site:
      ftp.adobe.com (path: /pub/adobe/acrobatreader)


B. INSTALLING

For either SUTRA-GUI distribution file that you have acquired,
sutra-gui104.zip or sutra-gui104s.zip, the directory "sutra-gui1.02" 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 SUTRA-GUI 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
SUTRA-GUI is retained, that version could be used by Argus ONE instead of
the newer SUTRA-GUI version.  Delete the directory of any
previously-installed version of SUTRA-GUI 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 SUTRA-GUI
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.

Upon successful extraction of the files contained in the distribution
file, the following directory structure will be created under the
ArgusPIE directory (the contents of each directory are shown to the
right):
 
      sutra-gui1.04       ; plug-in extensions, copy of this README file
       `-----doc          ; documentation files
       `-----src          ; source code
              `----- res  ; Visual C++ resource file

Note:  The source code is not included in the sutra-gui102.zip distribution
       file and the sutra-gui1.02s.zip file includes only the source code.

The sutra-gui1.04 directory will contain the following plug-in extension
files:

      SelectChar.exe - executable to be used by external calibration program
      WaitForMe.exe - executable to be used by external calibration program
      sutra.dll - PIE library (compiled)
      GetMyDirectory.dll - PIE library (compiled)
      OkCancel.dll - PIE library (compiled)
      Sutra_List.dll - PIE library (compiled)
      Sutra_ProgressBarPIE.dll - PIE library (compiled)
      Sutra_ReadFileValue.dll - PIE library (compiled)
      sutra.ini - display information which depends on model type
      sutra.lay - layer information
      sutra.met - export template
      sutra.val - initial values
      readme.txt - explanation of how to use SelectChar.exe and WaitForMe.exe
      sutra-gui.txt

All files except those with the extensions dll and exe are text files.

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 sutra.met file in the
ArgusPIE\sutra-gui1.02 directory must be edited using a text editor that
can save files in an ASCII format.  The pathname of the executable
version of SUTRA is given in the thirteenth line of the file.  This line
currently reads:

      Set Variable: SutraPath:= "C:\SUTRA\sutra.exe"

The pathname in quotation marks should be replaced with the full pathname
of the executable version of SUTRA.  Note that, as currently distributed
by the USGS, the executable version of SUTRA is installed  by default in
the directory sutra09.97\bin; the pathname of the executable is
sutra09.97\bin\sutra.exe by default.


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
https://water.usgs.gov/software/sutra-gui.html.