//
// 
// 
// Date   98.07.23 - 99.05.02   File   nohrsc.hlp
// Author Peter Moarefi & Anders Nilsson
// 
// Version 1.0     Jan 14, 1999
// Version 1.01    Feb  4, 1999
// Version 1.02    Jun 25, 1999
// Version 1.03    May 02, 2001
// Version 1.04    Feb 21, 2002
// Version 1.05    Sep 17, 2003
//

/ONE NOHRSC Launcher Overview
NOHRSC Launcher Overview

This is an Application Launch Program providing:

1 - A consistant user interface,
2 - Allowing color resources be shared by the
    applications launched from nohrsc.

Command line options:

The user may run this program from any directory,
provided several things:

    1) The exported variable IHABBS set in the .profile
       points to the <BIN> directory.
    2) The config file to be used is either in the
       current directory or the <BIN> directory. Note that
       the current directory will be checked first.
    3) The user has write-permission to wherever this
       config file is located. The NOHRSC launcher
       writes temporary color table files for use by
       the launched applications. These are designated
       with the *.cat suffix. The files are deleted   
       when the NOHRSC launcher quits.
    4) If user wants to keep several config files in 
       one directory, the user can copy the nohrsc.cfg
       file and change the suffix. The user can use   
       these files by running the launcher with -c**
       option. Example:

           The user changes nohrsc.cfg to nohrsc.ma, 
           then types "nohrsc -cma" to run the launcher
           with the changed config file. Any applications
           run from this use of the launcher will use
           the "nohrsc.ma" config file.
             


/ONE Menu Options
Menu Options

 File
         
    Save Configurations      - This option is currently disabled.
    
    Database Administration  - This button launches another toolbar
    		which allows the user to perform maintenance on the
    		GIS layers. They can be renamed, removed, archived
    		for storage, shared for use with another database, 
    		or restored. The Share and Restore options are
    		useful as they allow the user to ship GIS layers
    		with ease.
    Export GIS Layers        - This will launch a viewer application
    		that enables the user to browse through GIS layers
    		and export them into other file formats. 
    Exit 		     - Closes the nohrsc tool bar and quits.
    		Note that launched applications such as Export and
                Unit Hydrograph have to be closed prior to this.
    		The NOHRSC launcher will also remove any temporary
                created color table files.

 Run
 
    IHABBS                   - Currently disabled, this button will
    			       launch the new version of Ihabbs when
    			       it comes out.
    Unit Hydrograph	     - This launches the Unit Hydrograph 
    			       application.
    ThreshR		     - Currently disabled.
    
 Options
         System Colors...    - Changes the background color and/or
         		       highlight color of subsequently 
         		       launched applications. 
         		       (The changes will not be apparent until
         		       after you open a new application.)
         System Parameters...- Changes the number of grayscale colors
         		       available to subsequently launched
         		       programs.
  Help
         Help
         About...

/ONE Sharing and Restoring GIS Layers
Sharing and Restoring GIS Layers 

Shipping GISRS layers is easy using the Data Administration
functions. 

 To "share" a layer:

    1. Select File->Data Administration from the NOHRSC launcher.
    2. From there, select Files->Archive/Share GIS layers.
    3. A dialog will appear, with two selection boxes. The top 
       one, GIS Layer Groups, groups the layers into different types,
       like flow direction grids, IHABBS basins, common vectors, etc.
       Select the Group of the layer you want to share, and then 
       select the layer in the lower box. 
    4. Click "Share". ( Clicking "Archive" will do the same, but will
       also remove the layer from the database. ) This will create
       the "shared" layer as a datestamped directory in the 
       <GISRS_ARCHIVE> directory. The cursor will turn back to an 
       arrow when it is finished.
    5. Click "Dismissed" when finished. 

  To "restore" a layer:

    1. Select File->Data Administration from the NOHRSC launcher.
    2. From there, select Files->Restore GIS layer.
    3. A dialog will appear, enabling the user to navigate through
       their file system. It will start in the directory specfied
       by the environment variable <GISRS_ARCHIVE>.
    4. Click the directory corresponding to the layer to be restored.
       Inside that directory, select the file named "product". The 
       fields beneath the selection box should automatically fill.
    5. Click "Restore". The GIS layer will be inserted into the 
       database. 



/ONE Glossary
Glossary

GIS    : Geographic Information System. Software for 
         managing geographically distributed data.
IHABBS : Integrated Hydrologic Automated Basin 
         Boundaries System
NOHRSC : The National Operational Hydrologic Remote 
         Sensing Center
NWS    : The National Weather Service 
raster : A matrix of digital values which, when 
         displayed, forms a continuous tone image.
RF1    : Reach File version 1. USGS DGL rivers and 
         streams data set modified by the EPA to 
         accurately characterize the nation's
         hydrography. Our RF1 was modified to
         correctly represent hydrographic topology
         and to register with the DEM.
USGS   : The United States Geological Survey
vector : An array of values which, when displayed,
         forms a map image of points, lines, and
         areas.

/ONE Configuration File
Configuration File

Changes made to the configuration file take effect
only upon reentering nohrsc. 

'nohrsc.cfg' has the following entries pertaining
to this executable:

      ** Program Parameters **
DATABASE      = Informix database name 
                (main database for attributes)
                Required - e.g. 'gisrs'
HELPFILE      = this help file 
                Optional - default is 'nohrsc.hlp'
GRAYCOLORS    = Initial number of gray colors to be 
                grabbed from the system color resources.
                The range is from 4 to 48.

         ** System Colors **
BGCOLOR       = The RGB Color definition of the default 
		background color. This color will be passed
		to applications launched from the titlebar.
		This color may also be used in other places,
		for example, the color of older hydrographs
		viewed using the Superimpose feature in 
		Unit Hydrograph.
		R G B    
		eg. 140 230 105

HICOLOR       = The RGB Color definition of the default
		highlight color. This color will be passed
		to applications launched from the titlebar.
		In IHABBS, this defines the outlet point
		color. In Unit Hydrograph, these values
		define the hydrograph line color. 
		R G B
		eg. 240 240 185

      ** Raster Theme Colors **
THEME01       = Number of colors used by thematic raster
                colors passed to the application as
                theme 1. Typically 20.

THEME02       = Number of colors used by thematic raster
                colors passed to the application as
                theme 2. Typically 20.

THEME03       = Number of colors used by thematic raster
                colors passed to the application as
                theme 3. Typically 20.

THEME04       = Number of colors used by thematic raster
                colors passed to the application as
                theme 4. Typically 20.

      ** Vector Layer Colors **/
VCOLOR01      = First element of RGB Color table 
                for vector colors
                R G B NAME 
                eg.  0  0  0  "Black"
VCOLOR02
........
VCOLOR13
VCOLOR14      = last  element of RGB Color table 
                for vector colors
                R G B NAME
                eg. 165  50  30  "Brown"

Only lines starting with these keywords are 
processed.  All other lines are considered comments.

/ONE NOHRSC Toolbar History
NOHRSC Toolbar History

Version 0.5
-----------
Date    : Dec 1998
Features:

        * First non-beta release.
        * Able to change background color and highlight color
             passed to launched applications.
        * Export functionality added.

Version 1.0
-----------
Date    : Jan 1999
Features:

        * Can be executed outside of the <BIN>
          directory as long as that directory 
          is included in the "path", and IHABBS is
          an exported pathname to that directory.
        * Can use local configuration files.
        * Removes created *.cat files upon exit.

Version 1.01
------------
Date    : Feb 1999
Features:

        * Can now use config files with other suffixes
          with the -c option on the command line. 
        * Launched applications will also use the
          specified config file.


Version 1.02
------------
Date    : May 1999
Features:

        *  Fixes a bug where the distributed thematic
           raster colors are not read properly.

Version 1.03
------------
Date    : May 2001
Features:

        * Terminal errors now more verbose
        * Quits if database not present
        * Sets working directory correctly
          (looks in local directory first)

Version 1.04
------------
Date    : Feb. 2002
Features:

        * linux version
        * Support for read only/24 bit color

Version 1.05
------------
Date    : Sep. 2003
Features:

        * Removed limit on number of spawned children apps
        * Handles color allocation for spawned children apps
        * Attempts to compensate when out of colors in 8 bit color mode

           
// End of nohrsc.hlp //
//
