GCLAS

              Graphical Constituent Loading Analysis System

                     GCLAS - Version 1.05e 2007/01/22


Instructions for installation and execution are provided below.
After installation, see the gclas.txt file in the doc subdirectory of
the GCLAS installation directory for summary information on GCLAS.

For assistance, enhancement requests, or to report bugs, send e-mail to
h2osoft@usgs.gov.


                          TABLE OF CONTENTS

                          A. SYSTEM REQUIREMENTS
                          B. DISTRIBUTION FILE
                          C. DOCUMENTATION
                          D. INSTALLING
                              o Installing GCLAS
                              o GCLAS directory structure
                          E. RUNNING THE SOFTWARE
                              o Out of environment space error
                          F. CONTACTS


A. SYSTEM REQUIREMENTS

The Java Runtime Environment (JRE) Version 1.5.X or higher is required
to run GCLAS.  The latest version for Solaris, Linux, and Microsoft
Windows platforms can be downloaded from http://java.sun.com.

To install and run GCLAS, the following are necessary (minimally):

  - Pentium-class PC
  - Windows 9x, NT 4.0, Windows 2000, or Windows XP
  - Processor running at 200 megahertz or faster
  - at least 128 megabytes RAM
  - up to 16.3 megabytes of free disk space
  - display resolution of 1024x768 or higher
  - display color of 16 bit or higher
 

B. DISTRIBUTION FILE

The following distribution package (containing the software and
information files) is currently available for Windows systems:
  
  gclas_install1_05e.jar - For platforms with JRE 1.5.X or higher installed


C. DOCUMENTATION

An on-line help manual can be displayed by selecting Help Topics
from the GCLAS Help menu. A user's manual can be is available on the
Web at http://pubs.usgs.gov/tm/2006/tm4C1/.


D. INSTALLING

Installing GCLAS
----------------

Prior to installation, it is recommended that you remove (or rename the directory
of) any previously-installed version of GCLAS.

To install the software, double-click gclas_install1_05e.jar to execute
the installation program and follow the directions on the screen. If the
installation program does not start when double-clicked, open a command 
window in the directory that contains gclas_install1_05e.jar and then type:

java -jar gclas_install1_05e.jar

Follow the installer's instructions to complete the installation. It is possible
to install GCLAS without Administrator rights. The installer does write to
the registry.

By default, the software is installed in the directory
C:\Program Files\USGS\gclas1.05.  This is the recommended installation 
directory, but you may use other directories or disk drives.


GCLAS directory structure
-------------------------

The following directory structure will be created (the contents of each
directory are shown to the right):

   gclas1.05                        files NOTICE.TXT and this README.TXT
     `-----bin                      batch file to run GCLAS
     `-----data                     example input data
     `-----doc                      documentation files
     `-----help                     file containing on-line help text
     `-----lib                      class files and software libraries
     `-----lib_data                 constituent library files
     `-----user                     working directory used by GCLAS shortcuts

E. RUNNING THE SOFTWARE

Select the GCLAS shortcut from the Start menu to execute GCLAS.  The 
Start menu shortcut is found under Programs, in the Program Folder 
specified during installation (default: USGS).

See the GETTING STARTED text in the upper right-hand panel of the
GCLAS window and the on-line help for assistance with using GCLAS.

Users with multiple installations of JRE should note that the batch
file executed by the GCLAS shortcuts will execute the first java version
found by the operating system.  To execute a different java version,
uncomment and modify as appropriate the lines containing the jrehome
variable in the batch file that executes GCLAS.


Out of environment space error
------------------------------

This error can occur when running GCLAS.  The error occurs when there
is insufficient space to hold a new environment variable definition.

You can avoid this error by initiating a new command shell and specifying
how much environment space you need.  For example, in an MS-DOS Command
Prompt window, typing

  command /e:1024

will initiate a new command shell with 1024 bytes of environment space.
Environment space can be between 256 and 32768 bytes.

The above command will increase the environment space for only the
current Command Prompt window.  To permanently increase your environment
space, on Windows 95 and 98 machines, click the MS-DOS icon in the
upper-left corner of the Command Prompt window and select Properties.
Select the Memory tab and increase the value in the Initial
environment field.  On Windows NT machines, add the above command to
C:\winnt\system32\config.nt and initiate and use a new MS-DOS Command
Prompt window.


F. CONTACTS

Inquiries about this software distribution should be directed to:

  U.S.Geological Survey
  Office of Surface Water
  415 National Center
  Reston, VA 20192 



  e-mail:  h2osoft@usgs.gov