//
// This help file was created on July 7, 1997
// Principal author - Andy Rost
// Version 2.2  - modified by Peter  Sep. 19, 1997
// Version 2.51 - modified by Peter  Nov. 20, 1997 
// Version 2.52 - modified by Peter  Dec. 02, 1997 
// Version 2.53 - modified by Peter  Jan. 13, 1998 
// Version 2.54 - modified by Peter  Jan. 27, 1998 
// Version 2.60 - modified by Peter  Apr. 30, 1998 
// Version 2.61 - modified by Peter  Aug. 05, 1998 
// Version 2.62 - modified by Anders Dec. 04, 1998 
// Version 3.0  - modified by Anders Apr. 09, 1999
// Version 3.01 - modified by Anders Jun. 25, 1999
// Version 3.02 - modified by Anders Jul. 16, 1999
// Version 3.03 - modified by Anders Jul. 22, 1999
// Version 3.04 - modified by Anders Jan. 06, 2000
// Version 3.05 - modified by Anders Mar. 08, 2000
// Version 3.07 - modified by Anders Aug. 22, 2000
// Version 3.08 - modified by Anders Nov. 08, 2000
// Version 3.10 - modified by Anders May  02, 2001
// Version 3.11 - modified by Anders Aug. 10, 2001
// Version 3.12 - modified by Anders Feb. 21, 2002
// Version 3.13 - modified by Anders Mar. 20, 2002
// Version 3.14 - modified by Anders May  03, 2004
// Version 3.15 - modified by Anders Jun. 14, 2004
// Version 3.16 - modified by Anders Jul. 15, 2004
// Version 3.17 - modified by Anders Nov. 14, 2004
// Version 3.18 - modified by Anders Jun. 29, 2005
// Version 3.19 - modified by Anders Oct. 23, 2006
// Version 3.20 - modified by Anders Feb. 23, 2007
// Version 3.21 - modified by Anders Mar. 19, 2008
// Version 3.22 - modified by Anders May  05, 2010
 
/ONE IHABBS Overview
IHABBS Overview

Integrated Hydrologic Automated Basin Boundary System
                         or
                       IHABBS

IHABBS was developed to provide the National Weather 
Service an objective tool for defining hydrologic
basin boundaries.  The aim of this system is to
provide the user with tools for automatically
delineating, editing, displaying, querying, and
managing basin boundaries.

IHABBS defines basins physiographically. The software
is delivered with several GIS data sets which guide
the delineation process.  The most important data set
is the drainage controlled flow direction grid. This
grid is constructed as follows:

1) Ingest, resample, and mosaic, USGS 1 degree DEM
   data sets to a 15 arc second grid using a
   smoothing convolution filter,
2) Fill spurious depressions in the DEM,
3) Generate a raw flow direction grid using the
   classic D8 algorithm,
4) Route lake and reservoirs to their outlets defined
   either by rivers and streams or by the lowest
   water edge elevation flowing away from the lake or
   reservoir,
5) Route rivers and streams from their headwaters to
   their tail waters. Route cells immediately 
   adjacent to rivers and streams into the rivers
   and streams,
6) Route flat areas to intersecting streams or the
   nearest routed cell, and
7) Generate an upstream flow accumulation grid from
   the flow direction grid.

In addition to the flow direction and flow
accumulation grid, IHABBS is delivered with slope and
aspect grids and several vector layers, the most
important of which is the rivers and streams layer.
The rivers and streams layer is derived from the EPA
RF1 file which has been tested and corrected for
hydrographic integrity and edited to register with
the DEM.

There are several avenues available to the user for
delineating basins using IHABBS. However, IHABBS was
designed to be a highly interactive GIS application.
The following steps are suggested for the beginner:

1) Open a new basin layer,
2) Modify your view by selecting GIS layers to be
   displayed and zooming in on a work area, 
3) Delineate a basin by defining its outlet point
   using the mouse,
4) Enter the basin's attributes,
5) Edit the basin delineation if necessary,
6) Repeat steps 3-5 for successive basins, then 
7) SaveAs the basin layer you have just created.

Of course there are many, many variations on this
basic work flow. And there are several tools to help
you along the way. We encourage you to experiment
with the system before embarking upon a serious basin
delineation project.

If you want a simple no hands on delineation of your
entire RFC we suggest that you explore the use of
batch delineation on the delineate menu. Batch
delineation will read discharge points from an
appropriately formatted ASCII file and perform a
series of basin delineations with no additional 
user input.

It is our hope that you find IHABBS to be a fairly
intuitive system. However we've included several help
items to answer most if not all of your questions.
The help items are entitled in parallel with IHABBS'
menu system. The only difference being that the menu
bar items were alphabetized in the help file.

Each help item is intended to describe the purpose 
of a particular menu selection, how to use it, its
relationship to other menu selections, usage hints,
operational details (where appropriate), and errors.

We suggest that you review the help items while
experimenting with IHABBS before starting your first
real project. If you encounter any difficulties, the
IHABBS development staff can be contacted at the
location described in the About IHABBS dialog. 
 
Good Luck ...

The NOHRSC

Hint

Since IHABBS processes a lot of spatial data we
suggest that you ensure that the disks containing
the data sets are hosted by the computer on which
IHABBS is executed. Moving the large files used by
IHABBS over a network slows down the basin 
delineation processes significantly.

/ONE - Delineating a basin 
Delineating basin in IHABBS

1. To create a new basin layer, select File->New
   from the menubar. If you are going do be
   defining non-contributing areas (and thus, 
   modifying the flow direction grid), select
   "New Basin GIS Layer with Flow Directions." 
   Otherwise, you need only select "New Basin GIS
   Layer only." A flow direction layer will 
   determine what the basins will look like, so 
   you'll need to select one from the small dialog
   that appears. 
2. Meanwhile, if you are opening the flow 
   direction grid also, IHABBS will copy the
   entire flow direction layer into a tempfile, so
   that any changes that occur to the flow grid do
   not affect the original (unless saved). IHABBS
   also initializes the basin layer. If you had
   opened an already existing basin layer, 
   IHABBS would have also made a tempfile for
   basin layer.
3. Click on View->Features, and select the Rivers
   layer. This will give you some idea of where
   to set basin drainage points. Showing the 
   elevation raster might help too, but that is 
   up to you.
4. Select Delineate->Delineate by Mouse, and the
   cursor will change into a small crosshairs.
   You may then select the drainage point, the 
   "base" of the hydrologic basin. 
5. After clicking on the drainage point, a larger
   dialog will appear, asking for basin attributes.
   The mandatory fields are SHEF ID and CWA ID, and
   the rest you may fill out at your discretion. 
   Proceed and click Delineate.
6. IHABBS will proceed to automatically generate a
   a basin for that point, described by the flow
   direction grid. This process may take some time,
   depending on how large the basin is. 
   (i.e delineating the Mississippi drainage would
    take a bit longer than that of a small brook. )
7. After IHABBS finishes, the basin should appear
   in the viewer, and you should then be able to 
   save your work.    

/ONE - Basin Attributes
Basin Attributes

IHABBS requires parameters in order to successfully
delineate and record a hydrologic basin. Here is a
summary of those that the user can enter:

Discharge Point : i.e. the point that determines
        the upstream basin size and location. This
        can be specified manually, or by clicking
        on the map with the mouse. (Required.)

SHEF ID : The abbreviated "name" of the basin.
        This is what IHABBS will use when 
        referencing the basin. It can be up to eight
        letters long. (Required.)
        
Coms Handbook 5 ID: Often abbreviated in IHABBS as
         COMS5 ID, this designation can be up to 
         five letters long. (Required.)
         
CWA ID  : the county warning area id, this field is
         typically the three letter designation of 
         the CWA that the basin is located in.
         (Optional.)

Forecast Group : This field is the name of the 
         forecast group that the basin is located
         in. This name may be up to thirty-two 
         letters long. (Optional.)  

Point Type : Whether the discharge point is a 
         forecast point or or a data point. This
         does not affect how IHABBS calculates the
         basin.

Include NonContributing Area : This flag determines 
         whether or not "noncontributing areas" 
         affect the basin's geometry. Those that do
         not include this area will place any NCA, 
         and any area that flows into that area,
         outside the basin.

Rain on Reservoir Basin : This option allows the 
         user to create a subbasin whose boundaries 
         are set at a given elevation within the larger
         delineated basin. This smaller basin is 
         representative of of the surface of a lake, 
         with the outline corresponding roughly to the 
         lake's perimeter. In addition to supplying the
         ROR basin elevation, the user will also need 
         to supply a SHEF ID and COMS5 ID for the 
         subbasin.
         
Description : A lengthier field to describe the basin.
         This can be up to eighty letters in length.

User Attribute : An additional text field for 
         miscellaneous use. It can be up to forty 
         letters in length.
                 
Elevation Zones : Basins can be broken up into subareas,
         classified by elevation. Known as elevation 
         zones, these regions are not graphically viewed
         in IHABBS, but are used in other applications. 
         The user can specify the lower margin of each 
         zone, with the upper boundary being either the 
         lower edge of the zone immediately above. In 
         the case of the uppermost elevation zone, this
         cap is the maximum elevation in the basin. Note
         that there is also a Zone 0, which extends from
         the discharge elevation to the margin of Zone 1.
         (Thus, this Zone 1 margin should not equal the 
         discharge elevation.) If these zone are ordered
         incorrectly or fall outside the basin, IHABBS
         will notify the user when it tries to update.

/ONE IHABBS and Unit Hydrograph
IHABBS and Unit Hydrograph
 
    IHABBS is important to the Unit Hydrograph program 
in that it creates the basin boundaries that latter 
program uses. Unit Hydrograph takes the geometry created
by IHABBS and constructs a unit hydrograph by routing 
water over the surface of the basin. 
    However, the resulting hydrograph is rendered inaccurate
if the basin geometry is changed after the hydrograph is 
generated. Deleting the basin has a similar effect. If the 
user makes changes to the basin layer that impacts generated
hydrographs, IHABBS 3.0 will flash a warning screen before 
the layer can be saved. This dialog will show the altered 
basins and the hydrographs that will be affected. It is then
up to the user to recalculate those hydrographs in the Unit
Hydrograph program. 

/ONE Menu Options
Menu Options

File - New - New Basin GIS Layer Only :
     This option initializes an empty basin layer. Note
     that since the flow direction layer is not opened
     into a temporary file as well, the user will unable
     to edit non-contributing areas during this session.

File - New - New Basin GIS Layer with Flow Directions :
     This option loads a selected flow direction layer
     and initializes an empty basin layer. Note that
     IHABBS first copies the flow direction grid into
     a tempfile before starting.
     
File - Open - Open Basin Layer Only :
     This opens the selected basin layer. The user may 
     then proceed to delineate and edit basins. Note
     that since the flow direction layer is not opened
     into a temporary file as well, the user will unable
     to edit non-contributing areas during this session.

File - Open - Open Basin Layer with Flow Directions :
     This opens the selected basin layer as well as the
     corresponding flow direction layer. The user may
     then proceed to delineate and edit basins. Note that
     IHABBS copies these layers into tempfiles before
     proceeding.                                                                
     
File - Open - Open Flow Direction Layer
     This opens the selected flow direction layer for
     viewing or for defining "Non-Contributing Area."
     Note that IHABBS copies this layer into a tempfile
     before proceeding further.
     
File - Close
     Closes the opened layers and discards changes.
     
File - Save
     Saves layers under their current names.

File - SaveAs - SaveAs Basin Layer
     Saves the opened basin layer under a new name.
     
File - SaveAs - SaveAs Flow Direction Layer
     Saves the opened flow direction layer under a new
     name.
     
File - Exit:
    Free all resources, and exit the application.

Delineate - Add Outlet Point - Locate Using Mouse
    Determining the discharge point is the first
    step in the basin delineation process. Here, the
    user can select the latitude/longitude position
    by moving the crosshairs over the map and clicking.
    After choosing a discharge point, the user is prompted
    by IHABBS for additional basin information. 

Delineate - Add Outlet Point - Define Coordinates
    Determining the discharge point is the first
    step in the basin delineation process. Here, the
    user can enter in the latitude/longitude coordinates
    manually. After choosing a discharge point, the user
    is prompted by IHABBS for additional basin information. 

Delineate - Remove Basin - Select Using Mouse
    This option turns the mouse pointer into a set
    of crosshairs, where the user may delete a basin
    by clicking inside of it.

Delineate - Remove Basin - Select From List
    This dialog lists the basin names (SHEF IDs) and 
    enables the user to delete any of them.

Delineate - Batch Delineation
    By creating a file that contains delineation 
    information for multiple basins, the user can
    let IHABBS process basins on its own. The format
    for this file is listed at the bottom of the help
    file.

Edit - Modify Basin Boundary
    The user can tweak the basin boundaries using 
    this tool (perhaps due to some issue beyond IHABBS'
    capabilities). The mouse point will turn into a
    pen, and the user can draw a polygon by clicking
    the vertices with the lefthand button, and finishing
    by clicking the center button. In order to modify
    the basin boundaries, IHABBS uses boolean logic, 
    where areas within this drawn polygon can be moved 
    from one basin to another (or to no basin at all).

Edit - Update Basin Attributes - Select Using Mouse
    This dialog enables the user to change some of the
    basin attributes. You can select the basin to be
    updated by clicking inside it. Once you have finished
    with your modifications, click "Update" to apply them.

Edit - Update Basin Attributes - Select From List
    This dialog enables the user to change some of the
    basin attributes. You can select the basin to be
    updated by selecting its name (SHEF ID) from a list.
    Once you have finished with your modifications, click
    "Update" to apply them.

Edit - Remove Basin - Select Using Mouse
    This option turns the mouse pointer into a set
    of crosshairs, where the user may delete a basin
    by clicking inside of it.

Edit - Remove Basin - Select From List
    This dialog lists the basin names (SHEF IDs) and 
    enables the user to delete any of them.

Edit - Define Non-Contributing Areas
    This option enables the user to define "noncontributing
    area" on the flow direction grid. Noncontributing area
    can be thought of as sinks, where water flows in but 
    does not flow out. If a basin is setup to include NCA,
    this effect will not change the basin outline. However,
    if the basin is not set to include this, the NCA and all
    upstream area from the NCA will be moved outside of the
    delineated basin. Note that this process redelineates a
    basin, so any basin boundary modifications should be done
    after noncontributing area is defined. If the flow 
    direction grid was not opened to be modified with the
    basin layer, this option will not be available.

Edit - Undefine Non-Contributing Areas
    This option resets the selected area back to the normal
    flow direction grid. Both defining and undefining NCA can
    be done without the basin layer having to be open. If the
    flow direction grid was not opened to be modified with
    the basin layer, this option will not be available.

Options - Delineate Options
    These two toggles influence the delineation process.
    The user can choose whether or not the discharge 
    point is snapped to the nearest river reach vector,
    or if the point is moved to a nearby point with a much 
    greater flow accumulation. The goal of these options is
    to make sure that the discharge point is located along
    a route of water flow.
    
Options - Display Options
    This dialog allows the user to select some basic
    display preferences: whether or not the distance and
    area units are metric or english, whether or not the
    degrees are listed in decimal or in minutes and 
    seconds, whether or not raster layer colors are scaled
    based on the viewed minimum and maximum values, and
    whether the legend should be shown or not.
    
Options - Parameters
    This dialog allows the user to set miscellaneous options.
    The accumulation ratio is the ratio of a nearby pixel's
    accumulation versus that of the selected discharge point.
    If the ratio is equal or greater than this threshold, the
    discharge point will be moved to this point of higher
    accumulation ( if that delineation option is toggled). The
    major river length is used if a MAJORRIVERS layer is not
    specified in the configuration file. It will try to use
    the current river layer and filter out all reaches that
    have an total upstream length of less than this value.
    Unfortunately, this filtering process is calculation
    intensive and usually quite slow.

Query - Query Opened Basin Layer
    This dialog allows the user to find information
    concerning the opened basin layer. To find information
    on a specific basin in the basin layer, click "Query,"
    and then click inside the basin on the map. This tool
    displays the ID properties as defined and calculated 
    by IHABBS, as well as listing the connecting basins
    immediately upstream and downstream. The center button
    at the bottom of the dialog triggers back and forth from 
    the traditional view to an expanded list of attributes
    which include elevation zone boundaries.

Query - Query Raster Layers:
    This dialog allows the user to query all the raster
    values at a specific point. To find raster information
    at point, click "Query," and then click on that point 
    on the map. Layers not available will be grayed out,
    or in a worse case, an error message may appear stating 
    that the program is having problems accessing a layer.
    In this case, please consult user support.

View - Features:
    This dialog turns on and off the features displayed
    in the viewer. One raster can be shown at a time
    (or otherwise none), while multiple vector layers
    can be shown at a time. Layers that are not available
    will be grayed out. IHABBS starts up with only the 
    RFC and states layers shown.

View - Colors 
    Set Vector Colors
    Set Point Colors
    Set Background Color
    
    These three dialogs allow the user to customize the
    colors shown in Unit Hydrograph. Set Vector colors 
    allows the user to assign one of fourteen colors 
    defined in the configuration file to shown vector
    layers. Set Background color changes the color 
    (from the default system color) to any hue as 
    defined by scrollbars of red, green, and blue.
    
       
/ONE - File 
File

Purpose 

To manage files used by IHABBS. 

Usage

Select an item from the File cascading menu to 
select the type of file management you wish to 
perform.

Details

Basin delineations are performed on flow direction
grids. When a basin is delineated we store both a
vector and a raster representation of the 
delineation. The raster representation is maintained
to provide a record of changes made to a basin. This
record allow us to maintain changes you've made to 
basins in the basin editor when new basins are added
or subtracted from the basin topology.

We also allow you to make changes to flow direction
grids by defining non-contributing areas. Since
non-contributing areas effect the shape of basins it
is important that we keep track of the flow direction
grid used to delineate a basin layer. This is 
important because future use of these basins may
require some knowledge of the flow directions within
the basins. A good example is unit hydrograph 
calculation.

Therefore you will notice that IHABBS may 
occasionally ask you to save changes made to the
flow direction grid before you save your basin
delineations. IHABBS does this to make sure that
changes to basins aren't saved without also having
saved changes made to the accompanying flow
direction grid.

We do not allow you to save changes made to the
flow direction grid delivered with IHABBS. Such 
changes must be saved to a new GIS layer using the
save as flow direction GIS layer feature. That we
you can be assured that you will always have the
same IHABBS starting point in the event that you've
made a mistake and have to start over from scratch.

See Also

Delineate
Edit

/ONE - File->New
File - New

Purpose 

To open a new basin GIS layer to which new basin 
delineations may be added.
 
Usage

Simply select the File - New menu selection. If a
flow direction GIS layer is not currently open a
list box dialog appears from which you must select
a flow direction GIS layer. You may choose the flow
direction GIS layer delivered with IHABBS or a layer
which you have edited and saved.

If a flow direction GIS layer is already open, the 
new basin GIS feature will use the flow direction
GIS layer that is already open.

Relationships

New basin GIS layers must be saved as rather than
saved. If you open a new layer and attempt a save 
rather than a save as you will automatically be put 
into the save as basin GIS layer IHABBS feature. 

If changes were made to the flow direction grid as
well they must be saved or saved as before saving 
the basin GIS layer. If the flow direction grid
changed and you selected the direction layer 
delivered with the IHABBS installation it can only
be saved as.

When a new basin GIS layer is saved as it is still
open but is no longer considered new. Subsequent 
changes can then be both saved as or saved.

Hints

If you want to open a new basin GIS layer yet not
use the currently open flow direction GIS layer
go to File - Close first to close all open layers.
Then when you go to new you will be prompted for the
the flow direction GIS layer.

See Also

File
File - Open - Open Basin GIS Layer
File - Open - Open Flow Direction GIS Layer
File - Close 
File - Save
File - SaveAs - SaveAs Basin GIS Layer
File - SaveAs - SaveAs Flow Direction GIS Layer

/ONE - File->Open->Open Basin GIS Layer
File - Open - Open Basin GIS Layer

Purpose 

To open an existing basin GIS layer to which new 
basin delineations may be added and existing 
basin delineations may be edited.
 
Usage

Select the name of the basin GIS layer you wish to
open from the Basin GIS Layers list box.

Relationships

When opening an existing basin GIS layer IHABBS
automatically opens the accompanying flow direction
GIS layer for you. If you make changes to that flow
direction layer you must save those changes before
saving changes made to the basin layer.

If a basin GIS layer was opened and changed when you
entered the open basin GIS layer feature IHABBS will
inform you of that fact and give you the opportunity
to close or save that layer first.

See Also

File
File - New
File - Open - Open Flow Direction GIS Layer

/ONE - File->Open->Open Flow Direction GIS Layer
File - Open - Open Flow Direction GIS Layer

Purpose 

To open an existing flow direction GIS layer with 
which new basin delineations may be added, existing 
basin delineations may be edited, and within which
non-contributing areas can be defined.
 
Usage

Select the name of the flow direction GIS layer you 
wish to open from the Flow Direction GIS Layers list
box.

Relationships

When opening an existing basin GIS layer IHABBS
automatically opens the accompanying flow direction
GIS layer for you. Therefore if a basin GIS layer
is already open a flow direction GIS layer is also
already open. Changes made to either the basin or the
flow direction layer are managed for you by IHABBS. 

If a flow direction GIS layer was opened and changed
when you entered the open flow direction GIS layer 
feature IHABBS will inform you of that fact and give
you the opportunity to close or save that layer 
first. 

If anything was open yet had not beed changed, IHABBS
simply closes the open GIS layers before opening the
newly selected flow direction GIS layer.

See Also

File
File - New
File - Open - Open Basin GIS Layer

/ONE - File->Close
File - Close

Purpose 

To close the currently open basin and flow direction
GIS layers. 

Usage

Simply select the File - Close menu selection.

Relationships

If a basin GIS layer or a flow direction GIS layer
was opened and changed you will be informed of the
fact and asked whether its OK to close. If you say
that its OK to close your changes will be discarded.
Depressing the Cancel button will terminate the close
procedure allowing you the opportunity to save your
changes.

See Also

File
File - Save 
File - SaveAs - SaveAs Basin GIS Layer
File - SaveAs - SaveAs Flow Direction GIS Layer

/ONE  - File->Save
File - Save

Purpose 

To save the currently open basin and flow direction
GIS layers to their original GIS layers. 

Usage

Simply select the File - Save menu selection.

Relationships

You may not save changes to the flow direction grid
delivered with the IHABBS installation. This will
ensure that you will always have the same IHABBS
starting point in the event that you inadvertently
made an error in judgement while editing the flow
direction grid. Changes to the delivered flow
direction grid must be saved as before before 
attempting to save the opened basin GIS layer.

If you select save but are working with a new basin
GIS layer the save feature will automatically revert
to the save as basin GIS layer IHABBS feature.

See Also

File
File - New
File - SaveAs - SaveAs Basin GIS Layer
File - SaveAs - SaveAs Flow Direction GIS Layer

/ONE - File->SaveAs->SaveAs Basin GIS Layer 
File - SaveAs - SaveAs Basin GIS Layer

Purpose 

To save the currently open basin GIS layer to a new
basin GIS layer.

Usage

Enter the name of the new basin file header file 
name. The name you enter will be appended with an 
extension for the GIS layer's vector file header file
name, object header file name, string file name, 
raster header file name, and data file name. The name
should contain no blanks.

Enter the name of the new basin GIS layer name. The 
name may contain blanks.

Enter OK to save as or Cancel to abort the save as
basin IHABBS feature.

The saved as basin GIS layer becomes the currently 
open basin GIS layer and is eligible for the save 
basin IHABBS feature.

Relationships

Changes to the flow direction GIS layer must be 
saved before changes to the basin GIS layer can be 
saved. That way we can track the flow directions that
were used to generate basin delineations. This will
become significant in future applications such as
synthetic unit hydrograph calculations.

Hints

You can make a copy of a basin GIS layer by opening
the layer then performing a save as on that layer.

See Also

File
File - Open - Open Basin GIS Layer
File - Save

/ONE - File->SaveAs->SaveAs Flow Direction GIS Layer 
File - SaveAs - SaveAs Flow Direction GIS Layer

Purpose 

To save the currently open flow direction GIS layer
to a new flow direction GIS layer.

Usage

Enter the name of the new flow direction file header
file name. The name you enter will be appended with
an extension for the GIS layer's raster file header
file name and data file name. The name should contain
no blanks.

Enter the name of the new flow direction GIS layer 
name. The name may contain blanks.

Enter OK to save as or Cancel to abort the save as
flow direction IHABBS feature.

The saved as flow direction GIS layer becomes the
currently open flow direction GIS layer and is 
eligible for the save flow direction IHABBS feature.

Relationships

Changes to the flow direction GIS layer must be 
saved before changes to the basin GIS layer can be 
saved. That way we can track the flow directions that
were used to generate basin delineations. This will
become significant in future applications such as
synthetic unit hydrograph calculations.

Hints

You can make a copy of a flow direction GIS layer by
opening the layer then performing a save as on that 
layer.

See Also

File
File - Open - Open Flow Direction GIS Layer
File - Save

/ONE - File->Exit
File - Exit

Purpose 

To exit IHABBS.

Relationships

If a basin GIS layer or a flow direction GIS layer
was opened and changed you will be informed of the
fact and asked whether its OK to exit. If you say
that its OK to exit your changes will be discarded.
Depressing the Cancel button will terminate the exit
IHABBS procedure allowing you the opportunity to save
your changes.

See Also

File


/ONE - Delineate
Delineate

Purpose

To delineate basins.

Usage

Select an item from the Delineate cascading menu to 
select the type of delineate activity you wish to 
perform.

Relationships

Edited basin boundaries are maintained by IHABBS.
As basins are added or removed from the basin 
topology the changes made to existing/remaining 
basins are taken into consideration. Every attempt is
made to carry through the efforts of your basin 
boundary modifications. The only exception is when 
you modify non-contributing areas within existing 
basins. In that case all boundary modifications for 
that basin are discarded.

Hints

Basin delineation can be a computationally intensive
activity. If a river reach structure will support
multiple basins you can significantly reduce the
amount of time you'll spend processing basin 
boundary delineations by proceeding from the head
water basins to the tail water basins. This way 
IHABBS will not have to spend a lot of time 
breaking up larger basins into smaller sub-basins. 

See that dotted line at the top of Delineate's pull
down menu? If you click on it the Delineate menu is
torn away from the IHABBS menu bar. This is a handy
feature if you plan to delineate several basins
during an IHABBS session.

Details

The following are the basic steps that follow
delineating a basin. Further details are described in
Delineate - Add Outlet Point - Locate Using Mouse.

1) Adjust and quality control the user provided 
   discharge point coordinates;
2) Determine if the discharge point is inside an 
   existing basin;  
3) Delineate the new basin by identifying all flow
   direction cells which route to to the discharge
   point and which do not belong to another upstream
   basin;
4) Vectorize the new basin;
5) Compute the attributes of the new basin;
6) If the new discharge point was inside an existing
   basin revectorize what remains of that basin; and
7) If the new discharge point was inside an existing
   basin recompute the attributes of what remains of
   that basin.

See Also 

Delineate - Add Outlet Point - Locate Using Mouse
Edit

/ONE - Delineate->Add Outlet Point - Locate Using Mouse 
Delineate - Add Outlet Point - Locate Using Mouse

Purpose 

To delineate a basin by entering the discharge point
coordinates using the mouse.

Usage

Position the cursor at the location of the discharge
point. Discharge points may only be located on rivers
and streams. After the discharge point was selected a
dialog is displayed in which you enter basin 
attributes. If the basin you're delineating contains
a rain-on-reservoir basin a second page of basin
attributes is made available to you for its attributes.

Press OK to delineate the basin after all attributes
were entered.

Relationships

Dangling streams, more often than not, behave as
non-contributing areas. Their area can be added to
a basin by using the modify basin boundary feature.

Non-contributing areas may not be within nor adjacent
to rain-on-reservoir basins.

When delineating a basin within basin and the 
within basin was edited there are several cases
deserving your attention:

1) The new basin never exceeds the boundaries of the
   within basin. If the within basin was made smaller
   with one of the editing features the new basin
   can also be smaller than the flow direction grid
   alone may indicate.
2) The new basin is always defined by available flow
   direction information. Any area added to the 
   within basin with an edit feature that does not
   flow to the new basin discharge point is ignored.
   You may want to convert some of the within basin
   edited area to the new basin using modify basin
   boundary.
3) IHABBS makes every attempt to convert edited area
   to non-edited area when possible when delineating
   a basin within a basin. If an edited portion of
   the within basin flows to the new basin it will
   be recorded as a non-edited area of the new basin.

Hints

Basin delineation can be a computationally intensive
activity. If a river reach structure will support
multiple basins you can significantly reduce the
amount of time you'll spend processing basin 
boundary delineations by proceeding from the head
water basins to the tail water basins. This way 
IHABBS will not have to spend a lot of time 
breaking up larger basins into smaller sub-basins. 

Since basins delineated within edited basins can't
take into account areas added to the edited within 
basin it may be wise to wait until the within basin
has been delineated before modifying basin 
boundaries.

Since adding non-contributing areas to existing 
basins destroys all edits made to that basin, its
a good idea to define non-contributing areas before
basins are delineated if at all possible.
  
Details

The following describes the delineation process :

1) Snap the discharge point to the nearest stream.
2) Quality control the snapped discharge point:
   a) Make sure that the point is within the RFC,
   b) Make sure that the point is not within a 
      flat area, and
   c) Make sure that the point is not in a non-
      contributing area
3) Shift the snapped discharge point to the most
   logical local coordinate by:
   a) Identifying the grid cell to which the snapped
      discharge point flows, and
   b) Identifying the flow accumulation of that cell,
   c) Computing the inverse ratio between the snapped
      to discharge point flow accumulation with flow
      accumulation of the cell to which it flows, and
   d) Shifting the discharge point if the inverse
      ratio exceeds the ACCUMRATIO value in the 
      IHABBS configuration file.
4) Determine if the snapped/shifted discharge point
   is within another basin.
5) Make sure that the snapped/shifted discharge point
   does not flow into a non-contributing area.
6) Assigns the flow direction grid at the discharge
   point to the new basin.
7) Recursively identifies all cells flowing to the
   discharge point and assigns them to the new
   basin. Any of those cells belonging to another
   basin (other that the within basin mentioned in
   [4] above) are ignored. If delineating within
   a basin (see [4] above) the limits of the new
   basin are constrained by the limits of the within
   basin.
8) Flow direction cells marked as non-contributing 
   area are ignored if the basin is not attributed
   as including non-contributing area. As a 
   consequence, any cell flowing into the non-
   contributing area are also ignored.
9) If a rain-on-reservoir basin is defined for the
   new discharge point, any flow direction cell:
   a) at or less than the rain-on-reservoir basin
      elevation flowing directly to the discharge
      point through already defined rain-on-
      reservoir cells are assigned to the rain-on-
      reservoir basin or
   b) at or less than the rain-on-reservoir basin
      elevation adjacent to already defined rain-on-
      reservoir cells. 
   Note : The basin in which the rain-on-reservoir
          is located is referred to as the parent
          basin. The requested elevation of the 
          rain-on- reservoir may not exceed the 
          elevation of the parent basin.
10)If edited areas are encountered in the within
   basin and they flow to the new basin they are
   assigned to the new basin as non-edited areas. 
11)Vectorize the new basin by tracing the flow
   direction cells assigned to the new basin. The
   first vertex of the basin is located at its
   discharge point. Basins are vectorized in a 
   clockwise direction.
12)Compute basin attributes.
13)Smooth vector basin boundaries by creating 45
   degree polygon segments where the raster basin
   delineation indicates the existence of corners.
14)If the new basin is defined within an existing
   basin the remainder of the existing basin is
   revectorized WITHOUT reperforming steps 1-10.
15)Recompute attributes for the within basin.
16)Smooth vector basin boundaries.

See Also

Delineate
Delineate - Add Outlet Point - Define Coordinates
Delineate - Remove Basin - Select Using Mouse
Delineate - Remove Basin - Select From List
Edit
Edit - Update Basin Attributes - Select Using Mouse
Edit - Update Basin Attributes - Select From List
Edit - Define Non-Contributing Areas
Edit - Undefine Non-Contributing Areas
Edit - Define Non-Contributing Areas
Edit - Undefine Non-Contributing Areas
Files
Configuration File

/ONE - Delineate->Add Outlet Point - Define Coordinates
Delineate - Add Outlet Point - Define Coordinates

Purpose 

To delineate a basin by entering the discharge point
coordinates from the keyboard.

Usage

Enter the discharge point coordinates in the
coordinate text boxes.

See the help section on 
Delineate - Add Outlet Point - Locate Using Mouse.

See Also

Delineate
Delineate - Add Outlet Point - Locate Using Mouse
Delineate - Remove Basin - Select Using Mouse
Delineate - Remove Basin - Select From List
Edit
Edit - Define Non-Contributing Areas
Edit - Undefine Non-Contributing Areas
Edit - Update Basin Attributes - Select Using Mouse
Edit - Update Basin Attributes - Select From List
Edit - Define Non-Contributing Areas
Edit - Undefine Non-Contributing Areas
Files

IHABBS Interface

/ONE - Delineate->Remove Basin - Select Using Mouse 
Delineate - Remove Basin - Select Using Mouse

Purpose 

To remove a basin from the open basin GIS layer
by selecting it from the map display with the mouse.

Usage

Position your cursor on the basin to be deleted and 
depress a mouse button. 

Relationships

If the basin you've deleted is not a tail water basin
the basin immediately below it will be redelineated.
The redelineated basin will contain all of the area
of the basin you've deleted.

If the basin you've deleted was edited by adding
area from an adjacent basin you will notice a void
between the two basins if you try to redelineate the
deleted basin. This is a result of the fact that
the deletion removes all record of the fact that
the deleted basin had been edited. The redelineation
proceeds exclusively from flow direction analysis. 

When deleting a basin within another basin IHABBS 
will try to clean up edited portions of the within
basin. Areas in the within basin that were assigned
to the deleted basin by the modify basin boundary
feature will revert back to being non-edited. The
only exception being those areas of the within basin
that were assigned to not included non-contributing
area within the deleted basin.

See Also

Delineate
Delineate - Remove Basin - Select From List

/ONE - Delineate->Remove Basin - Select From List 
Delineate - Remove Basin - Select From List

Purpose 

To remove a basin from the open basin GIS layer
by selecting its name from the basin name list box.

Usage

Select the name of the basin to be removed from the 
basin name list dialog.
 
See the help section on 
Delineate - Remove Basin - Select Using Mouse.

Relationships

The basin list box is used by several IHABBS features
requiring basin selection by name. Upon selection of
Remove Basin - Select From List, or any other feature
requiring the selection of a basin by name, a list
box dialog will be displayed if not already
displayed. The list box dialog will remain displayed
and will be managed throughout the entire IHABBS
session unless dismissed by the user. All IHABBS
features requiring selection of a basin by name will
share this list box dialog.

See Also

Delineate
Delineate - Remove Basin - Select Using Mouse
IHABBS Interface

/ONE - Delineate->Batch Delineation 
Delineate - Batch Delineation

Purpose 

To automatically delineate several basins from a
properly formatted basins attributes ASCII file.

Usage

When selecting batch delineation from the IHABBS
menu you will be presented with a standard X-Motif
file selection dialog. Double click on any item in
the Directories list box to navigate the directory
tree structure. Selecting path/.. moves you back.
Selecting path/name moves you forward. Double click
on any item in the Files list box to select the
ASCII file containing your basin attributes. Double
clicking on the file will initiate batch delineation.
Batch delineation is also initiated by the OK button.

Hints

The Filter text box can be used to reduce the number
of files displayed in the Files list box. For example
if you enter path/*.dat in the Filter text box only
those files with the .dat extension will be displayed
in the Files list box.

To observe the progress of the automatic delineation
turn on the vector open basins in the View - Features
IHABBS feature. Every time 10 new basins have been
delineated IHABBS will refresh the basins display. 

Details

You'll notice that basins are delineated in an order
that may not match the order that they appear in in
your basin attributes file. We've ordered your basins
by elevation from highest to lowest to speed up the
delineation process. Sorting in this order reduces
the number of basin within basin delineations and
minimizes the number of large intermediate basin
delineations.

See Also

Delineate
Delineate - Add Outlet Point - Locate Using Mouse
Delineate - Add Outlet Point - Define Coordinates
View - Features
Batch Delineate Input File Format

/ONE - Edit 
Edit

Purpose 

To edit basin and flow direction GIS layers. 

Usage

Select an item from the Edit cascading menu to 
select the type of editing activity you wish to 
perform.

Relationships

Edited basin boundaries are maintained by IHABBS.
As basins are added or removed from the basin 
topology the changes made to existing/remaining 
basins are taken into consideration. Every attempt is
made to carry through the efforts of your basin 
boundary modifications. The only exception is when 
you modify non-contributing areas within existing 
basins.  In that case all boundary modifications for 
that basin are discarded.

Hints

Whenever possible edit non-contributing areas first,
then delineate, and then modify basin boundaries.

See that dotted line at the top of Edit's pull down
menu? If you click on it the Edit menu is torn away
from the IHABBS menu bar. This is a handy feature if
you plan to edit several basins during an IHABBS
session.

Details

Modifications to a basin are recorded in the raster
version of the delineation as negative values. When
sub-basins are delineated within an edited basin the
sub-basin is defined by the flow direction grid AND 
the raster version of the basin that it's within.
The sub-basin will not include any portion of the
edited area of the basin that its within. It is,
however, constrained by by the limits of the basin
that its within.

If the sub area is deleted, the basin that it's 
within returns to its original, edited shape. It's the
negative values that allows this to happen.

Rain-on-reservoir basins are a little different. When
they are modified only the portion of the rain-on-
reservoir basin within the EDITED portion of its
parent basin is made negative. We've done this so
that if an edited rain-on-reservoir basin is deleted
without deleting its parent basin we don't 
inadvertently indicate portions of the parent basin
as having been edited when in fact only its rain-on-
reservoir basin was edited - an important issue if the
parent basin is delete later. We know this sounds a 
little confusing but it works since rain-on-
reservoir basins are entirely contained by their 
parent basins.

See Also

Delineate

/ONE - Edit->Modify Basin Boundary 
Edit - Modify Basin Boundary

Purpose 

To edit the boundaries of selected basins.

Usage

By selecting this IHABBS feature you will be put
directly into a polygon delineation mode. In this 
mode you are expected to define a closed polygon
by positioning the cursor with your mouse and
clicking the left mouse to select a polygon vertex
and the second mouse button to close and complete
the polygon. The interior of the polygon will be
edited.

When the polygon is completed IHABBS will compute
which basins fall within the polygon. At point a 
dialog will be displayed which asks you to define
what portions of existing basins or No Basin area
within the polygon should be assigned to a target
basin.

Having selected the from basins and the to basin
IHABBS will proceed to redelineate all of the 
effected basins.

Relationships

To preserve the topology of existing basins 
we prevent you from effecting existing basin 
discharge points.  We also require that from and
to basins be adjacent to one another. 

A U shaped polygon whose uprights fall within the
to basin can create holes in the basin delineation
which are unavoidable. The delineation of the
basin will include the hole. The area of the hole
will not be reflected in the basin's attributes.

Its possible to add multiple regions of disjoint No
Basin to the to basin. In this case only the adjacent
No Basin area will be delineated. However, in this
case the basin attributes will include the are that
was not delineated. 

It is possible to include non-contributing area into
a non-rain-on-reservoir basin. The non-contributing
area added by the modification should be reflected
in the basin's attributes.

When a basin is added a portion of a neighboring 
basin and is subsequently deleted, a redelineation
of the deleted basin will result in a hole between
itself and the neighboring basin.

Creative use of the basin boundary modification 
feature can be used to rectify the cases mentioned
above.

Modifications to basins are recorded, maintained,
and used through subsequent basin delineation and
editing activities. As basins are added and deleted
exiting basin changes are maintained except when
non-contributing areas are modified. 

Hints

Because modifications to non-contributing area always
over-ride basin boundary modifications its best to 
edit boundaries after non-contributing areas were
defined.

One of the tests performed by IHABBS is to TRY to
see if your from basin will be split by the edit
procedure. IHABBS takes your polygon and adds a 1-2
pixel border. If the buffered border is split by the
to basin IHABBS thinks that the from basin will be 
split. If you run into this problem, select a more 
modest polygon.

The viewer displays edited areas in the raster 
version of the basin delineation in contrasting 
shades of grey. Display this layer to provide a
visual indication of what has and has not been 
edited.

See Also

Delineate
Delineate - Add Outlet Point - Locate Using Mouse
Delineate - Add Outlet Point - Define Coordinates
Edit
Edit - Update Basin Attributes - Select Using Mouse
Edit - Update Basin Attributes - Select From List
Edit - Remove Basin - Select Using Mouse
Edit - Remove Basin - Select From List
Edit - Define Non-Contributing Areas
Edit - Undefine Non-Contributing Areas
Files

/ONE - Edit->Update Basin Attributes - Select Using Mouse 
Edit - Update Basin Attributes - Select Using Mouse

Purpose 

To update the attributes of a basin selected from the
map display.

Usage

Select the basin whose attributes are to be edited
by positioning the cursor on the targeted basin
and clicking a mouse button.

A dialog box of basin attributes well appear on the
screen. Select any non-spatial field to edit. Enter
the new attribute. If you select a non-editable
field you will be warned with a beep as you try
to enter a new attribute.

Relationships

The spatial basin attributes can not be modified 
with this feature. They are in the exclusive domain
of the delineate features and basin boundary
modification feature. To change the discharge point
location first delete the basin and then redelineate
it. To change the shape of a basin either define
or undefine enclosed non-contributing area or modify
the basin boundary. 

See Also

Delineate - Add Outlet Point - Locate Using Mouse
Delineate - Add Outlet Point - Define Coordinates
Edit - Modify Basin Boundary
Edit - Update Basin Attributes - Select From List
Edit - Remove Basin - Select Using Mouse
Edit - Remove Basin - Select From List
Edit - Define Non-Contributing Areas
Edit - Undefine Non-Contributing Areas
Query - Query Opened Basin Layer

/ONE - Edit->Update Basin Attributes - Select From List
Edit - Update Basin Attributes - Select From List

Purpose 

To update the attributes of a basin selected from the
basin name list box.

Usage

Select the name of the basin whose attributes are to 
be edited from the basin name list dialog.
 
See the help section on 
Edit - Update Basin Attributes - Select Using Mouse

Relationships

The basin list box is used by several IHABBS features
requiring basin selection by name. Upon selection of
Update Basin Attributes - Select From List, or any 
other feature requiring the selection of a basin by 
name, a list box dialog will be displayed if not 
already displayed. The list box dialog will remain 
displayed and will be managed throughout the entire 
IHABBS session unless dismissed by the user. All 
IHABBS features requiring selection of a basin by 
name will share this list box dialog.

See Also

Delineate - Add Outlet Point - Locate Using Mouse
Delineate - Add Outlet Point - Define Coordinates
Edit - Modify Basin Boundary
Edit - Update Basin Attributes - Select Using Mouse
Edit - Remove Basin - Select Using Mouse
Edit - Remove Basin - Select From List
Edit - Define Non-Contributing Areas
Edit - Undefine Non-Contributing Areas
Query - Query Opened Basin Layer
IHABBS Interface

/ONE - Edit->Remove Basin - Select Using Mouse 
Edit - Remove Basin - Select Using Mouse

Purpose

To remove a basin from the open basin GIS layer
by selecting it from the map display with the mouse.

Usage

See the help section on 
Delineate - Remove Basin - Select Using Mouse.

See Also

Delineate - Remove Basin - Select Using Mouse
Delineate - Remove Basin - Select From List

/ONE - Edit->Remove Basin - Select From List 
Edit - Remove Basin - Select From List

Purpose

To remove a basin from the open basin GIS layer
by selecting it from the basins name list.

Usage

See the help section on
Delineate - Remove Basin - Select From List.

See Also

Delineate - Remove Basin - Select Using Mouse
Delineate - Remove Basin - Select From List

/ONE - Edit->Define Non-Contributing Areas 
Edit - Define Non-Contributing Areas

Purpose 

To modify the flow direction GIS layer by defining
non-contributing areas.

Usage

By selecting this IHABBS feature you will be put
directly into a polygon delineation mode. In this 
mode you are expected to define a closed polygon
by positioning the cursor with your mouse and
clicking the left mouse to select a polygon vertex
and the second mouse button to close and complete
the polygon. The interior of the polygon will be
edited.

If the polygon you just drew does not contain 
existing basin delineations the flow direction grid 
will be modified to reflect the entire area as being
non-contributing.

If the polygon does contain existing basin 
delineations you will be presented with a dialog
requesting you to define within which basins you 
which to change the flow to non-contributing. The
No Basin selection will edit that portion of the
polygon you just drew that is outside of existing
basins to non-contributing area.

If you've selected existing basins those portions
of the selected basins within the polygon you just
drew will be will be made non-contributing. They will
also be redelineated. 

Relationships

Basin delineation can be told to either consider or
ignore non-contributing area. If told to consider it
the delineation will work its way around the
non-contributing area and all areas routed to it.

Because of the way non-contributing areas are treated
by the delineation process, any existing basin that  
had non-contributing areas added to it will be 
redelineated exclusively from the modified flow
directions. All basin boundary modifications will
be lost. 

Non-contributing areas can not be defined within or
adjacent to rain-on-reservoir basins. 
Non-contributing are not allowed to effect the 
discharge points of existing basins.

Hints

The viewer displays non-contributing area flow
directions in muted colors. Display open flow 
directions in the viewer to watch the progress of
your work.

Because IHABBS will redelineate basins exclusively
from flow directions if non-contributing areas are
added to existing basins its better if you can define
non-contributing areas before editing basin 
boundaries and best if before delineating basins.

See Also

Delineate - Add Outlet Point - Locate Using Mouse
Delineate - Add Outlet Point - Define Coordinates
Edit - Undefine Non-Contributing Areas

/ONE - Edit->Undefine Non-Contributing Areas 
Edit - Undefine Non-Contributing Areas

Purpose 

To modify the flow direction GIS layer by undefining
non-contributing areas.

Usage

By selecting this IHABBS feature you will be put
directly into a polygon delineation mode. In this 
mode you are expected to define a closed polygon
by positioning the cursor with your mouse and
clicking the left mouse to select a polygon vertex
and the second mouse button to close and complete
the polygon. The interior of the polygon will be
edited.

If the polygon you just drew does not contain 
existing basin delineations the flow direction grid 
will be modified to reflect the entire area back to 
being contributing.

If the polygon does contain existing basin 
delineations you will be presented with a dialog
requesting you to define within which basins you 
which to change the flow to contributing. The No 
Basin selection will edit that portion of the
polygon you just drew that is outside of existing
basins back to contributing area.

If you've selected existing basins those portions
of the selected basins within the polygon you just
drew will be will be changed back to contributing. 
They will also be redelineated. 

Relationships

Basin delineation can be told to either consider or
ignore non-contributing area. If told to consider it
the delineation will work its way around the
non-contributing area and all areas routed to it.

Because of the way non-contributing areas are treated
by the delineation process, any existing basin that  
had non-contributing areas removed from it will be 
redelineated exclusively from the modified flow
directions. All basin boundary modifications will
be lost. 

Hints

The viewer displays non-contributing area flow
directions in muted colors. Display open flow 
directions in the viewer to watch the progress of
your work.

Because IHABBS will redelineate basins exclusively
from flow directions if non-contributing areas are
removed from existing basins its better if you can 
define non-contributing areas before editing basin 
boundaries and best if before delineating basins.

See Also

Delineate - Add Outlet Point - Locate Using Mouse
Delineate - Add Outlet Point - Define Coordinates
Edit - Define Non-Contributing Areas


/ONE - Options
Options

Purpose

To change the program parameters that affect
the display or the program functionality.

Usage

Select an item from the Options cascading menu to 
select the type of parameters you wish to set.
the map features displayed in the IHABBS viewing 

/ONE - Options->Delineate Options...
Options - Delineate Options...

Purpose 

To control how basins are delineated.

Usage

To prevent IHABBS from snapping the user specified
discharge point to the nearest RF1 reach depress 
the 'No' button. Otherwise depress the 'Yes' button.

To prevent IHABBS from moving the optionally-snapped
discharge point to a nearby pixel of a higher flow
accumulation value depress the 'No' button. Otherwise
depress the 'Yes' button.

Hints

For most basin delineation sessions the desired 
options are Snap and Move.

See Also

Options - Parameters

/ONE - Options->Display Options...
Options - Display Options...

Purpose 

To control how alphanumeric and raster image data is 
formatted.

Usage

To control the units of measurement for the display
of attributes and the input of parameters depress 
either the English or Metric button.

To control the format of coordinates for the display
of coordinates or the input of coordinates depress
either the decimal or the DD:MM:SS.s button. The
decimal format expects coordinates to be entered as
a standard decimal value. The DD:MM:SS.s expects 
coordinates to be entered as integer degrees, colon,
integer seconds, colon, and integer or floating point
second. Fifteen degrees, 16 minutes, and 17 seconds
should be entered as 15.27138889 in decimal format
and as 15:16:17.0 or 15:16:17 in DD:MM:SS.s format.

To display greater raster image detail as you
tighten your display view you should select the Yes
button next to RESCALE ON ZOOM?. This will force
IHABBS to calculate the minimum and maximum visible
raster value to display prior to displaying the 
raster image. The calculated minimum and maximum 
values are used to generate a new color table 
maximizing the contrast within the display region.
This, however, requires reading the raster data file
twice before display which slows down the map 
display.

Hints

Raster GIS layer color table scaling is a feature you
may wish to use with discretion if image rendering 
times are unacceptable. You may want to wait until 
you've zoomed in before selecting this feature.

See Also

View - Features
IHABBS Interface

/ONE - Options->Parameters...
Options - Parameters...

Purpose

To allow advanced user control of certain soft-coded
parameters that affect program functions.

Usage

During basin delineation, the user selected point is
(optionally) snapped to the nearest river reach,
then moved to the center of the pixel on the flow-
direction grid, and then (optionally) moved to the
center of a neighboring pixel on the accumulation 
grid with accumulation value higher than the present
pixel by the ratio 'Accumulation Ratio'. 

'All Rivers' is presently an RF1 file. Rivers with
'sum_drain_length' greater than a threshold value 
called 'Major River Length' are called 'Major Rivers',
and the rest are called 'Streams'. This distinction
affects the display of 'Major Rivers', as well as the
Export of 'Major Rivers', and 'Streams'. The filtering
routines have turned out to be very slow.

Change the displayed parameters to desired value,
then click OK to affect the change.

See Also

Options - Delineate Options
View - Features
Configuration File

/ONE - Query
Query

Purpose 

To query basin attributes and raster GIS layer
values.

Usage

Select an item from the Query cascading menu to 
select the type of query you wish to perform.
the map features displayed in the IHABBS viewing 

Options control the displayed units of measure, the
format of displayed map coordinates, and whether or 
not dynamic scaling of raster data should be invoked.

See Also

File - New
File - Open - Open Basin GIS Layer
File - Open - Open Flow Direction GIS Layer
IHABBS Interface

/ONE - Query->Query Opened Basin Layer
Query - Query Opened Basin Layer

Purpose 

To query IHABBS for the attributes of the basin at
the current cursor position.

Usage

Position your cursor and depress a mouse button. The
attributes of the basin at the current cursor 
position will be reported. Basin attributes are 
reported only if you have a basin layer open for 
delineation or editing.

Relationships

To query basin attributes a basin GIS layer must 
first be opened. The units of the queried attributes
can be changed in Query - Options. The format of
queried coordinates can be changed in Options - 
Display Options.

Hints

The basin query dialog only reports when it has
input focus and the cursor is shown by a set of
crosshairs. If you change focus to another window
and want to continue displaying query results, click
on the query button in the basin query dialog first.
That should allow basin querying to continue.

See Also

File - New
File - Open - Open Basin GIS Layer
Options - Display Options
Query - Query Raster Layers
IHABBS Interface

/ONE - Query->Query Raster Layers
Query - Query Raster Layers

Purpose 

To query IHABBS for the values of raster data at the
current cursor position.

Usage

Position your cursor and depress a mouse button. The
raster data values of IHABBS raster data files at the
current cursor position will be reported.  Basin ID 
values are reported only if you have a basin GIS 
layer open for delineation or editing. Flow direction
values are reported only if you have a flow direction
GIS layer open for delineation or editing.

The reported basin ID is the value of the unique code
that IHABBS assigns to each delineated basin.

Relationships

To query basin identifiers a basin GIS layer must 
first be opened. To query flow directions a flow 
direction GIS layer must first be opened. The units 
of the queried attributes can be changed in 
Options - Display Options. 

Hints

The raster query dialog only reports when it has
input focus and the cursor is shown as a set of
crosshairs. If you change focus to another window
and want to continue displaying query results, click
on the query button in the raster query dialog first.
That should allow raster querying to continue.

See Also

File - New
File - Open - Open Basin GIS Layer
File - Open - Open Flow Direction GIS Layer
Options - Display Options
Query - Query Opened Basin Layer
IHABBS Interface

/ONE - View
View

Purpose 

To control what and how data is displayed in the 
display region.

Usage

Select an item from the View cascading menu to select
the map features displayed in the IHABBS viewing 
window. The View menu items allow you to select both
raster and vector map features. Only one raster
feature may be selected at any one time. As many
vector features as you like may be displayed over
a raster image or by themselves.

Additionally, you can manipulate how map features are
displayed. Color options allow you to alter the color
of vector map features. Other options control the 
displayed units of measure, the format of displayed 
map coordinates, and whether or not dynamic scaling
of raster data should be invoked.

Relationships

The items on the View menu allow you to control what 
and how data is displayed in the IHABBS viewing
window. How much data is visible in the IHABBS 
viewing window is controlled in the Zoom menu.

Hints

Some of the GIS layers take longer to display than
others. You may find it useful to wait until you've
tightened your view before displaying time consuming
GIS layers.  Also, raster GIS layer color table
scaling is a feature you may wish to use with
discretion if image rendering times are unacceptable.

See Also

Zoom
IHABBS Interface
Configuration File

/ONE - View->Features
View - Features

Purpose 

To control what data is displayed in the display 
region.

Usage

Select a raster image and as many vector drawings
as you like for display. Raster images may be
displayed with or without vector drawings. Vector
drawings may be displayed with or without raster
images. Only one raster image may be displayed at
once. As many vector drawing as you like may be 
displayed at once.

Vector drawings will always be displayed over raster
images. Raster images will never obscure vector
drawings.  Vector drawings are displayed in the 
order that they were selected.

Relationships

Certain raster images represent a continuous surface
of values. DEMs, for instance, depict elevations from
less than 0 meters to several thousand meters. Your
computer is capable of displaying only a relatively
small number of monotonic colors - somewhere between
200 and 250 monotonic colors. Not enough colors to
see much detail.

We've put a feature into IHABBS which allows it to
compute a new monotonic color table each time the
limits of the display region changes. As you zoom in
more and more detail in the raster image is revealed
when this option is invoked. See Options - Display
Options for details.

If the MAJORRIVERS record in the IHABBS configuration
file is commented out or missing, IHABBS will
selectively filter major rivers from the all rivers
layer based on the value of the MAJORLENGTH record.
This will slow down the display of major rivers
significantly! But this will enable you to see what
IHABBS thinks are major rivers before running the
export rivers features.

Hints

Some of the GIS layers take longer to display than
others. You may find it useful to wait until you've
tightened your view before displaying time consuming
GIS layers.  Also, raster GIS layer color table
scaling is a feature you may wish to use with
discretion if image rendering times are unacceptable.

Since vector drawings are displayed in the order 
that they were selected, display the most important
vector drawing last. Otherwise it will be obscured by
other vector drawings.

If the MAJORRIVERS record in the IHABBS configuraion
file is commented out or missing, IHABBS will
selectively filter major rivers from the all rivers
layer based on the value of the MAJORLENGTH record.
This will slow down the display of major rivers
significantly! But this will enable you to see what
IHABBS thinks are major rivers before running the
export rivers features.

See Also

Zoom
Options - Display Options

/ONE - View->Colors->Set Vector Colors
View - Colors - Set Vector Colors

Purpose 

To adjust the color that vector GIS layers are
rendered in.

Usage 

The color that each vector GIS layer is displayed in
is coded in the vector GIS layer header file. While
this value can (but probably should not) be edited by
the user, the vector colors are more readily adjusted
by using this IHABBS feature.

Simply select the GIS layer for which you wish
modify the color. Then select among the list of colors
that were specified in the configuration file. A small
window previews the color.

This is not a permanent change. The next time you
enter IHABBS, the original vector colors will
be invoked. Hopefully we've selected reasonable colors
for the various vector GIS layers. If not, contact us
for guidance on making permanent changes to the color
values assigned in the header files.

Hints

Make sure the gis layer colors contrast well with
the background color. It is possible to make a layer
"invisible" by assigning it the same color mix as the
background color. Likewise, select the vector colors to
contrast well with the raster layers you plan to display.
The color tables assigned to raster files can not be
directly modified by the user.
 
 
See Also

View - Colors - Set Point Color
View - Colors - Set Background Color

/ONE - View->Colors->Set Point Color
View - Colors - Set Point Color

Purpose 

To adjust the color that outlet points are rendered
in.

Usage

The color that points are displayed in is
hard-coded in the vector header, or in the case
of outlet points, defaults to the Highlight Color
specified in the config file, or just black.
However, the color is readily adjusted by using
this IHABBS feature.

Simply select the GIS layer for which you wish
modify the color. Then select among the list of colors
that were specified in the configuration file. A small
window previews the color.

This is not a permanent change. The next time you
enter IHABBS the original point color will be
invoked. 

Hints

Make sure the point color contrasts well with
the vector and background colors. It's possible to
make discharge points "invisible" by assigning them
the same color mix as the background color. Likewise,
select the point color to contrast well with
the raster layers you plan to display. The color
tables assigned to raster files can not be directly 
modified by the user.
 
See Also

View - Colors - Set Vector Colors
View - Colors - Set Background Color

/ONE - View->Colors->Set Background Color
View - Colors - Set Background Color

Purpose 

To adjust the color of the display region background.

Usage

The color that the background is displayed in defaults
to that of the operating system (Style Manager
in HPUX), and can also be permanently specified in
the configuration file. Additionally, the color is 
readily adjusted by using this IHABBS feature.

Move the slider bars left and right to adjust the
mixture of red, green, and blue. As you adjust the
colors with the sliders, the color of the background 
will change automatically. The adjusted color is also
displayed in a swatch immediately above the color
sliders. 

This is not a permanent change. The next time you
enter IHABBS the original background color will be
invoked. This color can be managed from operating
system utilities (Style Manager in HPUX) or by 
specifying the RGB values in the config file.

Hints

Make sure the background color contrasts well with
the vector and outlet point colors. It's possible to
make vectors and discharge points "invisible" by
assigning them the same color mix as the background
color.

The background color will be obscured by raster GIS
layers. The extent to which the background color is
obscured is a function of the the size of the raster
file, where your display region is centered, and the
extent to which you've tightened your view.
 
See Also

View - Colors - Set Vector Colors
View - Colors - Set Outlet Point Color

/ONE - Zoom
Zoom

Purpose

To control the limits of the display region.

Usage 

Select an item from the Zoom cascading menu to define
the geographic limits of the portion of the RFC 
displayed in the IHABBS viewing window. The Zoom menu
items allow you to zoom in to and out from the RFC in
addition to allowing you to redefine the center of 
your view of the RFC.

Relationships

The items on the Zoom menu allow you to control how
much data is visible in the IHABBS viewing window.
What data is actually displayed is selected in the
View - Features dialog.

Hints

See that dotted line at the top of Zoom's pull down
menu? If you click on it the Zoom menu is torn away
from the IHABBS menu bar. This is a handy feature if
you plan to zoom and pan several times during an 
IHABBS session.

See Also

View - Features
IHABBS Interface

/ONE - Zoom->Zoom to box
Zoom - Zoom to box

Purpose 

To select a smaller display region by defining a
"rubber band" box around a smaller area. 

Usage

This feature allows the user to "tighten" the view
of the RFC by defining a "rubber band" box around a
smaller area of interest. The cursor will change
shape from a pointer to a cross hair. Position the
cross hair on the first corner of the smaller region
and depress the left mouse button.  Then position the
cross hair on the second corner and depress the left
mouse button again. Between the first and second 
mouse button depressions a "rubber band" box will be 
displayed indicating the limits of your new view. 
Upon selection of the second box corner the "rubber 
band" box will be erased, the cursor will revert back
to a pointer, and your new view will be rendered. 
There is no need to keep the left mouse button 
depressed between the first and second zoom box 
corner selections. The order in which box corners are
selected is not important.

You will note that IHABBS will make every attempt to
fill the display canvas up to its edges. Because of
this feature, the zoomed image will almost always be
larger along one of its axis than the area described
by the zoom box. The displayed area will however
include all of the data requested by the user.

Relationships

If you change your mind while in the process of 
defining your zoom box you can simply make a new
selection from the ihabbs menu. The "rubber band"
box will disappear, the cursor will revert back to a
pointer, and your current view will remain the same.

Hints

Some of the GIS layers take longer to display than
others. You may find it useful to wait until you've
tightened your view before displaying time consuming
GIS layers.  Also, raster GIS layer color table
scaling is a feature you may wish to use with
discretion if image rendering times are unacceptable.

Errors

There is a known bug in the display system when you
zoom in too tightly. The vector layers have a
tendency get confused when you zoom in on an area
smaller than a pixel.

See Also

Options - Display Options
View - Features
Zoom - Zoom to Basin
Zoom - Zoom in at center
IHABBS Interface

/ONE - Zoom->Zoom to Basin
Zoom - Zoom to Basin

Purpose 

To select a smaller display region by selecting a
basin to zoom in on from the basin name list box. 

Usage

This feature allows the user to "tighten" the view
of the RFC by selecting a basin from a list of basins
in the currently open basin layer.  The view will be 
adjusted to the limits of the selected basin plus a 
modest buffer. The size of the buffer is defined in 
the IHABBS configuration file. 

Relationships

The basin list box is used by several IHABBS features
requiring basin selection by name. Upon selection of
Zoom to Basin, or any other feature
requiring the selection of a basin by name, a list
box dialog will be displayed if not already
displayed. The list box dialog will remain displayed
and will be managed throughout the entire IHABBS
session unless dismissed by the user. All IHABBS
features requiring selection of a basin by name will
share this list box dialog.

Hints

Some of the GIS layers take longer to display than
others. You may find it useful to wait until you've
tightened your view before displaying time consuming
GIS layers.  Also, raster GIS layer color table
scaling is a feature you may wish to use with
discretion if image rendering times are unacceptable.

See Also

Options - Display Options
View - Features
Zoom - Zoom to box
Zoom - Zoom in at center
IHABBS Interface

/ONE - Zoom->Zoom to extents 
Zoom - Zoom to extents

Purpose 

To select a larger display region by resizing the 
display region to the specified regional limits. 

Usage

This feature allows the user to "expand" the view
of the RFC by resizing delineation area to the limits
specified in the configuration file. MAXX, MAXY, 
MINX, & MINY specifies this outer bounding rectangle.
 
Hints

Some of the GIS layers take longer to display than
others. You may find it useful to unselect time
consuming GIS layers before expanding your view.
Also, raster GIS layer color table scaling is a 
feature you may wish to use with discretion if image
rendering times are unacceptable. 

See Also

Options - Display Options
View - Features
Zoom - Zoom out at center
Configuration File

/ONE - Zoom->Pan to cursor
Zoom - Pan to cursor

Purpose 

To select a new display region by shifting the  
display region center point. 

Usage

This feature allows the user to redefine the center
of the RFC view. The cursor will change shape from a 
pointer to a cross hair. Position the cross hair on 
the center of your new view and depress the left 
mouse button.  Upon selection of the new view center 
the cursor will revert back to a pointer and your new
view will be rendered.

Relationships

The current image center defines the center for rapid
zooming in and zooming out from the view center.

If you change your mind while in the process of 
defining your new view center you can simply make a
new selection from the ihabbs menu. The cursor will
revert back to a pointer and your current view will
remain the same.

See Also

Zoom - Zoom in at center
Zoom - Zoom out at center
IHABBS Interface

/ONE - Zoom->Zoom in at center
Zoom - Zoom in at center

Purpose 

To select a smaller display region by zooming in on
the display region center point. 

Usage

This feature allows the user to "tighten" the view
of the RFC by decreasing the limits of the view about
the center of the current view. The degree of zooming
is controlled by the current zoom setting.

Relationships

The degree to which zooming in on displayed features 
occurs with each selection of this menu item is 
controlled by Zoom - Set zoom factor. 

Hints

Some of the GIS layers take longer to display than
others. You may find it useful to wait until you've
tightened your view before displaying time consuming
GIS layers. Also, raster GIS layer color table
scaling is a feature you may wish to use with
discretion if image rendering times are unacceptable.

Errors

There is a known bug in the display system when you
zoom in too tightly. The vector layers have a
tendency get confused when you zoom in on an area
smaller than a pixel.

See Also

Options - Display Options
View - Features
Zoom - Zoom to box
Zoom - Zoom to Basin
Zoom - Pan to cursor
Zoom - Zoom out at center
Zoom - Set zoom factor

/ONE - Zoom->Zoom out at center
Zoom - Zoom out at center

Purpose 

To select a larger display region by zooming out from
the display region center point. 

Usage

This feature allows the user to "expand" the view
of the RFC by increasing the limits of the view about
the center of the current view. The degree of zooming
is controlled by the current zoom setting.

Relationships

The degree to which zooming out from displayed 
features occurs with each selection of this menu item
is controlled by Zoom - Set zoom factor. 

Hints

Some of the GIS layers take longer to display than
others. You may find it useful to unselect time
consuming GIS layers before expanding your view.
Also, raster GIS layer color table scaling is a 
feature you may wish to use with discretion if image
rendering times are unacceptable. 

See Also

Options - Display Options
View - Features
Zoom - Zoom to extents
Zoom - Pan to cursor
Zoom - Zoom in at center
Zoom - Set zoom factor

/ONE - Zoom->Set zoom factor
Zoom - Set zoom factor

Purpose 

To control the degree to which the display region is
zoomed in on or out from.

Usage

This feature controls the degree of zooming in and
zooming out from center. The user slides the slider
left or right to the desired zoom level. The reported
number is not the degree of magnification or 
reduction. Rather, it is the the degree to which
each axis of the image will be scaled up or down.

The initial or default zoom setting is defined in the
IHABBS configuration file.

Relationships

Altering the zoom setting controls the degree to 
which the displayed features are zoomed in on or
zoomed out from with each selection of Zoom - Zoom in
at center and Zoom - Zoom out at center.

See Also

Zoom - Zoom in at center
Zoom - Zoom out at center
Configuration File

/ONE Help->Help
Help - Help 

Purpose

On-line IHABBS user documentation.

Usage

Select a help item from the list box at the bottom of
the Help dialog. The help items are grouped by the
alphabetized IHABBS menu bar items. Additionally,
we've included help information on the IHABBS 
Interface, frequently asked questions, a glossary,
the IHABBS configuration file, and the batch 
delineate input file format . When a help item is 
selected, the help information on the selected topic 
is displayed in the text box at the top of the help 
dialog.
 
Hints

The contents of the file displayed by the IHABBS help
system may be edited by the user. The file is named
ihabbs.hlp. New help sections may be added by
enclosing the new section headings in arrow braces.
The text following the arrow brace enclosed headings
is displayed as help text. You can augment this help
file by adding text to existing help sections and by
creating new help sections.

Help file lines preceded by double forward slashes
are ignored by the IHABBS help system. The double
slashes indicate help file comment lines.

See Also

Help - Help Espanol
Help - About IHABBS 

/ONE - Help->Help Espanol
Help - Help Espanol

Purpose

(Optional) On-line IHABBS user documentation in Spanish

Usage

This works exactly the same as the English help file.
IHABBS will look for an "ihabbs.hlp.e" file or a spanish
help file specified in the configuration file. If none are
found, this menu item will be grayed out.

Hints

See Also

Help - Help
Help - About IHABBS


/ONE - Help->About IHABBS
Help - About IHABBS

Purpose 

Reports the IHABBS version number and details on how
to contact the IHABBS developers for information
about IHABBS not covered in the IHABBS help system.
The date and time of the last compilation are displayed 
on the IHABBS status line.

See Also

Help - Help
Help - Help Espanol

/ONE Temporary Files - File Creation and Deletion
Temporary Files - File Creation and Deletion

Purpose

Temporary files are created in order to hold 
dynamically changing  or sensitive data. Vector
and raster layers are copied over to temporary
files so that they will not be compromised 
during IHABBS execution. In addition, new basin
layers are held in temporary files until they are
saved.

Usage

These files are created 
on either a File->New or File->Open command.
They are copied over to permanent files and
deleted on File->Exit.

Hints

Temporary files are just as large as the 
permanent files they represent. There should
be enough extra storage space to accomodate them
during IHABBS execution.
 
See Also

Temporary Files - File Names and Working Directories
Temporary Files - Temp Data Files Found

/ONE Temporary Files - File Names and Working Directories
Temporary Files - File Names and Working Directories

Purpose

Working directories hold temporary  as well as
permanent files required for IHABBS operation.

Usage

The first thing that IHABBS looks for when creating
temporary files is the exported system variable
GISRS_SCRATCH_PATH. If this is defined, IHABBS
will attempt to create temporary files there.
If the GIS layer data is stored on a remote file
server (as per $GISRS_BASIN_DATA), having
GISRS_SCRATCH_PATH point to a local directory on
your machine may speed up calculation considerably. 


Otherwise, the working directories where temporary
files are created are:
$GISRS_BASIN_DATA/data/basin/raster/uf_flow and
$GISRS_BASIN_DATA/data/basin/vector
The temporary files are named dynamically as
a numerical sequence, for instance:

Tmp00000.tmp
Tmp00001.tmp
Tmp00002.tmp
Tmp00003.tmp
...

See Also

Temporary Files - File Creation and Deletion
Temporary Files - Temp Data Files Found

/ONE Temporary Files - Temp Data Files Found
Temporary Files - Temp Data Files Found

Purpose

On exiting IHABBS, a warning may be given 
regarding the presence of temporary data files.
This is meant to inform the user that files may 
exist that are not needed and are merely taking
up disk space. IHABBS normally cleans up all 
of its temporally files before exiting. But if
for any reason IHABBS is terminated in any other
way (via a control-C, for instance), temporary
files will be left behind. It is upon exiting a
properly terminated IHABBS session that such 
previously generated files are detected.

HOWEVER, care should be taken before manually 
deleting temporary files that no other user is
currently running IHABBS. If temporary files are 
deleted while IHABBS is running, it will abort
abnormally. 

Usage

If the Temp Data Files Found message is displayed,
click OK and exit IHABBS. Then, after checking that
no other IHABBS sessions are currently running, rm 
all files with the .tmp extension from the 
$GISRS_BASIN_DATA/basin/raster/uf_flow and
$GISRS_BASIN_DATA/basin/vector subdirectories.
If you have GISRS_SCRATCH_PATH defined, remove the
.tmp files there instead.

Hints

If for any reason you exit from IHABBS abnormally,
you may check for the presence of temporary files and
remove them before starting up a new session. In 
this way, you will avoid being prompted to do so at
the end of the new session.

See Also

Temporary Files - File Creation and Deletion
Temporary Files - File Names and Working Directories 

/ONE IHABBS Interface
IHABBS Interface

The IHABBS interface is designed to be highly visual
and intuitive. But it is worth pointing out a couple
of features that may make running IHABBS a bit more
enjoyable had you known that they were available.

Main Window

The IHABBS interface is constructed using X-Motif.
The title bar of the main window contains the usual
Motif features including the name of the program,
an icon for a pop-up menu of window control features,
an iconize button, and a maximize button. Below the
program name is a menu bar which allows you to select
from general IHABBS features. Selecting any item from
the menu bar will give you access to a menu of
specific IHABBS features. Selecting a specific IHABBS
feature will either allow you to immediately interact
with IHABBS data or will spawn a pop-up dialog for
additional inputs.

The startup size of the main window can be altered
by editing the STARTHEIGHT and STARTWIDTH records in
the IHABBS configuration file. Values of 1 will fill
your entire monitor; values of .5 will consume half
your screen height and width; etc.

Dialogs

Most pop-up dialogs don't require inputs before
proceeding to another IHABBS feature. Some dialogs,
referred to as application modal dialogs, require an
input before proceeding with another IHABBS feature.
Certain dialogs are made modal to prevent possible
IHABBS I/O confusions which may result in corrupted
databases. You can tell if a dialog is modal by the
beep that will be issued by the system when you try
to execute another IHABBS feature before concluding
the modal IHABBS feature. Modal dialogs are mainly
associated with file management and basin delineation.

Dialogs can be dismissed by either depressing the 
Cancel button or the OK button. The Cancel button 
will proceed with no action. The OK button will 
perform the selected IHABBS feature before being
dismissed. There are some IHABBS dialogs that 
are displayed not for parameter inputs but to report
data to the user. These dialogs are associated with
querying the various IHABBS databases. 

Non-modal dialogs that remain on the screen and
get updated periodically occasionally stop 
responding. This is not a bug but a feature of Motif.
Motif normally only updates dialogs which have focus.
Usually this presents very little problem due to the
intuitive nature of Motif. IHABBS, however, manages 
two dialogs which may loose focus while remaining 
displayed. These are the Query display windows. If
you select either of the query and features then move
on to another IHABBS feature without dismissing the
query dialog, the dialog looses focus and stops
displaying query data. No problem. Simply click on
the query dialog's title bar and continue querying. 
You can tell when a dialog has focus by the 
contrasting color of its frame.

Map Display

The main body of the IHABBS interface is devoted to
displaying map features. There are two parts to the
map display. The major part, on the right, is used
to display raster images and vector drawings. Only
one raster image can be displayed at any time. As
many vector drawings as you like may be displayed on
top of a raster image or by themselves. Several
IHABBS features are devoted to control what and
how much map data is displayed.

The minor part, on the left, contains the legend for
the data currently displayed. Since the legend can
be quite large yet is not scaled, it often does not
fit into the space provided. Scroll bars on the left
and bottom edge of the legend can be used to make
any portion of the legend visible. It's worth noting
that the size of the legend is a proportion of the
main window's size. Resizing the IHABBS main window
makes the legend wider and taller.

Coordinate Display

On the four corners of the map display we print the
geographic limits of the current viewing area. In the
lower right-hand corner of the IHABBS main window we
display the current cursor position. The format of
coordinate display is a user selectable option - see
Query or View Options. The distance the cursor
travels between mouse clicks is displayed in the
raster query dialog.

Coordinates are always displayed relative to the 
northwest hemisphere. In other words, degrees West
followed by degrees North. Coordinates are always
displayed in geodetic (longitude/latitude)
coordinates on the World Geodetic System 1984
horizontal datum.

Coordinate Entry

When IHABBS expects coordinate entry remember that
it wants geodetic coordinates relative to the
World Geodetic System 1984 horizontal datum. 
Coordinates are always assumed to be in the northwest
hemisphere. Regardless of the sign of your 
coordinate input, IHABBS assumes you mean the 
northwest hemisphere. Therefore:

   95.0 lon  45.0 lat converts to -95.0 lon 45.0 lat
  -95.0 lon -45.0 lat converts to -95.0 lon 45.0 lat
  -95.0 lon  45.0 lat converts to -95.0 lon 45.0 lat
   95.0 lon -45.0 lat converts to -95.0 lon 45.0 lat

Also, IHABBS does not want to see E, W, N, S, etc.
in the coordinate entry.

Arrow Keys

The cursor can be moved by the mouse or by the arrow
keys. The mouse is fast; the arrow keys are precise.
The space bar acts as the left mouse button and the
Enter key as the right mouse button.

What's Going On ? or
What's a Person To Do ?

To the left of the cursor position display box we've
placed an IHABBS status box. The box reports what
should be done next in the IHABBS dialog that has
current focus. In the event that IHABBS is in the
process of precessing data, the status box will
report the what its working on. In the event of an
error the status box, in addition to an error pop-up
dialog, will report the nature of the error. 

Cursors

Cursors of different shape are used to give the user
an additional indication of the state or the action
about to be performed.
  Normal arrow is the default cursor for the 
      majority of the time.
  Watch cursor signifies that the computer is
      busy and is not responding at this time.
  Box Kite denotes that the viewer will zoom to
      the area delimited by the points the user
      clicks on.
  Target or the Eye with the dot-in-the-middle is
      used to pick a point for delineation.
  Cross is used to select an area, or a point
      in the query mode. 

Selecting Basins

You'll usually select a basin from a map display. But
some folks like to select basins by name. The basin 
name dialog is shared by all IHABBS features 
requiring you to select a basin name from a list of 
basin names.

The first time a basin name is to be selected from a
list, the list is displayed in a dialog. The dialog
will remain displayed throughout the IHABBS session  
or until dismissed by the user. If another basin list
IHABBS feature is selected and the list is already
displayed, simply select the basin from the existing
basin list. The basin list is maintained throughout
the IHABBS session. As you add, delete, and edit 
basins you should see the basin list get modified.

/ONE FAQ - Frequently Asked Questions
FAQ - Frequently Asked Questions

[Q] Why is my basin smaller than I expected ?
[A] There could be three reasons for this:
    1) You've defined a non-contributing area and
       have told IHABBS to not include non-
       contributing area
    2) There is a dangling stream in the proximity
       of the discharge point. The tail water of a
       dangling stream usually behaves as a non-
       contributing area. You can include it using
       the modify basin boundary feature.
    3) You've defined a discharge point in a basin
       which has been made smaller with the modify
       basin boundary feature. A basin defined within
       a basin may not exceed the limits of the
       within basin. 
[Q] Why can't a rain-on-reservoir basin be adjacent
    to or include a non-contributing area ?
[A] By our way of thinking a non-contributing area
    is a region in which water flow into the ground.
    A rain-on-reservoir basin adjacent to or 
    including non-contributing area would therefore
    drain. We may not be right, but this reasoning
    makes sense to us.
[Q] Why do edited areas sometimes get changed to
    non-edited areas ?
[A] IHABBS makes every attempt to convert edited area
    to non-edited area when possible when delineating
    a basin within a basin. If an edited portion of
    the within basin flows to the new basin it will
    be recorded as a non-edited area of the new 
    basin.
[Q] Why, when I delineate a basin within an edited
    basin, does the new basin not include the edited
    area of the within basin ?
[A] The new basin is always defined by available flow
    direction information. Any area added to the 
    within basin with an edit feature that does not
    flow to the new basin discharge point is ignored.
    You may want to convert some of the within basin
    edited area to the new basin using modify basin
    boundary.
[Q] Why don't I get a rain on reservoir basin when 
    I've asked for one ?
[A] There are two possible reasons: you've either 
    defined a rain on reservoir basin elevation that
    is too low in which case it could not be 
    delineated or you've defined an elevation which
    resulted in a rain-on-reservoir basin which is
    exactly the same shape as the parent basin.
[Q] Why did my discharge point move ?
[A] Discharge points may only be located on rivers
    and streams. We snap your discharge point to the
    nearest river and stream and the adjust the 
    snapped position to the location of the most
    logical, local maximum flow accumulation.
[Q] Why is there a void between the basin I've just
    delineated and what I know is its neighboring
    basin ?
[A] Assuming that the flow direction reflects
    reality accurately and there are no dangling
    streams nor non-contributing area in the vicinity
    there is only one answer that comes to mind. 
    You may have tried to delineate or redelineate
    a basin in an area that had been edited and
    subsequently had basin deleted from it. 
    If the basin you've deleted was edited by adding
    area from an adjacent basin you will notice a 
    void between the two basins if you try to 
    redelineate the deleted basin. This is a result 
    of the fact that the deletion removes all record
    of the fact that the deleted basin had been 
    edited. The redelineation proceeds exclusively 
    from flow direction analysis. 
[Q] Why is it that IHABBS doesn't always clean up 
    all of the edited areas associated with deleted
    basins? 
[A] When deleting a basin within another basin IHABBS
    will try to clean up edited portions of the 
    within basin. Areas in the within basin that 
    were assigned to the deleted basin by the modify
    basin boundary feature will revert back to being
    non-edited. The only exception being those areas
    of the within basin that were assigned to not 
    included non-contributing area within the deleted
    basin.
[Q] Why do my exported basin delineations report 
    areas which are slightly different than the areas
    reported by IHABBS?
[A] IHABBS feels that the raster representation of 
    basin delineations are the most accurate for the
    given input data. IHABBS basin areas are computed
    within the raster domain. When IHABBS vectorizes
    the raster basin delineations, it "knocks" off 
    pixel corners for the sake of aesthetics and to
    account for the potential shortcomings of GIS
    systems to which IHABBS basins may be exported. 
[Q] Why does IHABBS keep telling me that a basin
    will be split by my modification ? 
[A] One of the tests performed by IHABBS is to TRY 
    to see if your 'from' basin will be split by 
    the edit procedure. IHABBS takes your polygon 
    and adds a 1-2 pixel border. If the buffered 
    border is split by the 'to' basin IHABBS thinks 
    that the 'from' basin will be split. If you run
    into this problem, select a more modest polygon.
[Q] Why does modify basin boundary result in holes
    and non-vectorized areas ?
[A] We've tried to prevent you from making as many
    mistakes as possible. But we can't catch them 
    all. The holes and non-vectorized areas result
    from the misuse of modify basin boundary. We've
    described the most common mistakes in the help
    section on modify basin boundary. As far as we
    know any mistakes in the use of modify basin 
    boundary can be corrected by reapplying modify
    basin boundary in a more rational fashion.
[Q] Why won't IHABBS allow me to edit basins and
    non-contributing areas especially around
    existing discharge points ?
[A] IHABBS must maintain a basin topology that
    makes hydrologic/hydrographic sense. Edit
    actions which break the chain from head water to
    tail water basins are prevented from occurring.
[Q] Why does IHABBS beep when I try to edit basin
    attributes ?
[A] Because the selected attribute is a spatial
    attribute which can only be modified by
    editing the basin boundary, modifying enclosed
    non-contributing area, or redelineating the
    basin.
[Q] Why are basin boundary modifications lost when
    I edit non-contributing or contributing areas
    within a basin ?
[A] Non-contributing areas affect the shape of the
    basin physiographically. When, under any
    circumstance, you effect the flow direction grid
    IHABBS will redelineate the basin from scratch
    because we assume that you want the terrain
    rather than prior subjective analysis to guide
    further delineation of the basin.
[Q] Why do I get the 'save-as' dialog when I enter
    'save' ?
[A] Because you attempted a save on a new basin GIS
    layer. You can only save to a previously existing
    layer. As a convenience to you we put you into
    the 'save-as' dialog rather than issuing an error
    message.
[Q] Why does 'save' tell me to 'save-as' then 
    changes to 'save-as' flow direction grid first ?
[A] Because we keep track of and associate changes
    made to flow direction GIS layers for each
    basin delineation GIS layer. That way we can
    use the correct flow directions for a given basin
    in future applications such as unit hydrograph
    calculations. Since you are not allowed to modify
    the flow direction GIS layer delivered with 
    IHABBS, any changes you've made to that layer
    must first be 'saved-as' rather than 'saved' when
    attempting to save changes made to a basin GIS 
    layer.
[Q] Why can't I save changes to the flow direction
    grid delivered with the IHABBS installation ? 
[A] We don't allow you to save changes to the
    flow direction GIS layer installed with IHABBS
    so that you will always have your original
    IHABBS starting point. Use the 'save-as' flow
    direction grid feature instead.
[Q] Why am I told to save the flow direction GIS 
    layer before saving the basin GIS layer ?
[A] The basin delineations will be used for other
    applications sometime in the future. We will
    need to know then what the flow directions were
    that led to the basin delineation. We keep
    track of that information for you. If you save
    basins without saving changes that have been
    made to the flow directions that produced those
    basins you'll compromise the utility of your
    basin delineations for future applications.
[Q] Why can't I delete or rename certain basin or
    flow direction GIS layers ?
[A] We don't allow you to delete or rename the
    flow direction GIS layer installed with IHABBS
    so that you will always have your original
    IHABBS starting point. We don't allow you to
    delete or rename the open basin or flow
    direction GIS layers because you're actually
    working with copies of the opened layers. If the
    original versions were deleted or renamed we
    would have no place for you to direct the output
    of the IHABBS save functions. 
[Q] How do I make a copy of a basin or flow
    direction GIS layer ?
[A] Open an existing basin or flow direction GIS 
    layer. Then SaveAs the basin or flow direction
    GIS layer. 
[Q] Why can't I query basins ?
[A] Probably because you haven't opened a basin GIS
    layer.
[Q] Why are the coordinates of an outlet point 
    different from its displayed position ?
[A] Each outlet point is snapped to its nearest 
    stream reach before the basin is delineated.
    The position is the snapped position, while
    the coordinates displayed are the original
    coordinates provided by the user. The position
    may be further modified by the flow accumulations
    local to the stream snapped position. If logical,
    IHABBS selects the center coordinate of the
    largest local flow accumulation as the location
    of the discharge point. We do this because the
    DEM and streams data is only an approximation of
    reality. Otherwise, the delineated basins are
    often poor representations of reality.
[Q] Why can't I query Basin IDs or flow directions ?
[A] Probably because you haven't opened a basin or
    flow direction GIS layer ?
[Q] Why do the query windows stop reporting 
    attributes ?
[A] Because since initially displaying the query
    window you've changed focus to another dialog.
    Simply click on the query dialog title and then
    continue querying.
[Q] I select RESCALE ON ZOOM and nothing happens. 
    WHY ?
[A] That's because raster image rescaling occurs only
    when your map display changes. Try Pan To Center
    On Cursor and selecting a new image center close
    to your current image center. Or you may try 
    resizing your window. These or any other IHABBS
    feature modifying the limits of your display
    region will rescale the raster image. 
[Q] Why can't I see much detail in the raster image ?
[A] Its because your computer can only display 200 -
    250 monotonic colors at once while the dynamic
    range of your raster image may span several
    thousand values. Try selecting the rescale on
    zoom option. This option will rescale the color
    table each time the display limits change. As
    you zoom in more and more raster detail will
    be revealed. 
[Q] Why can't I see my vectors ?
[A] There may be three reasons. First, vectors are
    drawn in the order that they were selected. It 
    may be that the vector that you're looking for is
    obscured by a vector drawing that had been
    subsequently selected. Try reordering the 
    selection of the vector drawings you wish to 
    view. Second, if the vector drawing is displayed
    over raster data, it may be that the color table
    for the raster image may match the colors of the
    vectors that you're looking for. Try changing 
    the colors of your vectors. Third, if a raster
    image is not displayed, it may be that the
    background color matches you're vector color.
    Try changing either the background or vector 
    color.
[Q] Why does it take so long to display a map ?
[A] The time it takes to display a map is a function
    of several factors. Disk access time, network
    loads, the speed of your computer, and the
    number of tasks your computer is busy with are
    factor effecting map display times but are out
    of our control. Factors which are in our control
    include the number of layers selected for 
    display, the number of objects in a given vector
    layer, how large a region is being displayed, and
    whether or not raster data rescaling is invoked.
    To speed up display try selecting fewer and less
    busy layers and turning off raster rescaling 
    until you've zoomed in on a smaller area.
[Q] Why does it take so long to display major 
    rivers ?
[A] Because the Major River Length parameter of the 
    Options > Parameters dialog is to a value not 0.
    This forces all references to Major Rivers
    use All Rivers and filter by the length 
    specified - very time consuming.
[Q] Why do I get all rivers when I select major 
    rivers in the display features dialog ?
[A] You've probably commented out or removed both the
    MAJORLENGTH and the MAJORRIVERS records in the 
    IHABBS configuration file.
[Q] Why do the open basin vectors not line up with
    the pixels in the open basin rasters?
[A] Because the basin vectorization function attempts
    to smooth basin vectors by "knocking" the corners
    off of the basin pixels. We do this to a) make 
    for a more pleasing basin boundary, b) to allow
    less sophisticated GIS systems to color fill
    basins which may be "pinched" in the middle, and
    c) to prevent less sophisticated GIS systems from
    splitting "pinched" basins into 2 or more smaller
    basins. 
[Q] Why does IHABBS beep at me and not let me make a
    selection from the menu or work with another
    dialog ?
[A] Certain IHABBS dialogs are application modal.
    This means that the selected IHABBS feature has
    the potential for corrupting the database if
    initiated but not completed before moving on to 
    another feature. You can press the OK button on
    the modal dialog to complete the IHABBS task
    controlled by the dialog or you can select the
    Cancel button which aborts the task. In either 
    case you will regain control of IHABBS.
[Q] Why does IHABBS beep after I've entered a few
    characters in a text box ?
[A] The text box is asking for a text string which
    may not exceed a certain length. The beep
    indicates that that length has been reached. 
[Q] What coordinate system does IHABBS work in ?
[A] Exclusively in geodetic coordinates on the
    World Geodetic System 1984 horizontal data.
    In other words, longitudes and latitudes. But
    its even more specific. IHABBS always assumes
    the northwest hemisphere. Therefore, as you
    enter coordinate values, IHABBS always 
    transposes the coordinates to the northwest
    hemisphere regardless of the sign you supply.
[Q] What does "Serious Programming Error" mean ?
[A] It means that we've blundered in an unexpected
    manner but were able to catch our mistake. This
    message should never appear. If it does, call
    us!
[Q] What does "Basins temporary database table 
    corrupted" mean ?
[A] It means that we've blundered in an unexpected
    manner but were able to catch our mistake. This
    message should never appear. If it does, call
    us!
[Q] What does "Programmer did not ensure fatal 
    error trapped" mean ?
[A] It means that we've blundered in an unexpected
    manner but were able to catch our mistake. This
    message should never appear. If it does, call
    us! But it also means that you can't continue
    with IHABBS. All is not lost. Since IHABBS works
    with temporary rather than original files, only
    new additions to the database will be lost. We
    suggest frequent saves as your work progresses.
    We also suggest backing up your data sets on a
    regular basis. 
[Q] I changed the contents of the IHABBS 
    configuration file but it doesn't seem to make a
    difference. Why ?
[A] The IHABBS configuration file is read only at 
    start up. Exit IHABBS and reenter IHABBS for 
    modifications to the configuration file to take 
    effect.
[Q] Why can't certain users access IHABBS data sets.
[A] Because you are in UNIX! UNIX deals with file
    permissions. The IHABBS data is owned by a 
    specific user. Depending upon file permission and
    group memberships other users may or may not
    have access to the IHABBS data. We suggest the 
    following:
       a) in the bin directory:
             chmod ug+x ihabbs
             chmod ug+r ihabbs.cfg
             chmod ug+r ihabbs.hlp
       b) in the subdirectory just above the ihabbs
          data directory:
             chmod -R ug+r data
             chmod -R ug+w data
     This will give all users within the same primary
     group as the ihabbs owner access to IHABBS.

/ONE Keyboard Shortcuts
Keyboard shortcuts

In addition to using the pull-off menu tabs to
zoom and navigate through the map window, the 
user may also use keyboard shortcuts. These
character combinations act just like the menu
options they represent. In most cases, the 
user will press the shortcut, and the cursor
will change, allowing the user to then select
a point from which to navigate.

The current list of shortcuts are:

   control-f   =  Zoom to full extent
   control-e   =  Zoom to box
   control-i   =  Zoom in at center
   control-o   =  Zoom out at center
   control-a   =  Pan to cursor
   control-v   =  In at cursor
   control-x   =  Out at cursor



/ONE IHABBS Chronology
IHABBS Chronology

Version 1.00
------------
Dates   : Jul. 1997 to Aug. 1997 
Features: View Rasters, Vectors, Outlets point.
          Delineate basin boundaries given discharge
          point coordinates, or automatically using
          a batch delineation script. Edit basin 
          attributes, basin boundary geometry. 
          Set and reset flow direction raster layer
          pixels to non-contributing.
          Export Basins, and Rivers and streams data
          in ARC/INFO, grass, version5, WHFS formats.

Version 1.10
------------
Dates   : Aug. 1997 to Sep. 1997
Features: Same features as version 1.00.
          Menu item Options->Parameters... is added 
          so that the following parameters may be 
          changed by the user during a run:
              Accumulation Ratio
              CWA Buffer Width
              Major River Length
              Max. Snap Distance
          Changes have been made to the database
          tables that renders version 1.10
          incompatible with version 1.00.

Version 2.20
------------
Dates   : Sep. 1997 to Oct. 1997
Features: Added export rasters.
          Menu item File->Export Layers...
          is replaced with a cascading menu:
          File->Export >
              Export Basins...
              Export Raster Layers...
              Export Vector Layers...
          For export in Version5 format the output
          coordinates format is forced to 4 decimal
          places and is no longer user selectable.
          In addition Version5 format output is
          filtered so that adjacent line segments
          that are co-linear are collapsed into one
          line segment.
          Menu item Help->Beta Version is removed.
          menu item Help->About IHABBS... displays
          the date and time of the last compilation
          in the status box. 
          Forecast Group is added to basin
          attributes.
          County Warning Area is added to batch
          delineation input record as field #4.
          Forecast Group is added to batch
          delineation input record as field #5.
          see Batch Delineate Input File Format.

Version 2.50
------------
Date    : Oct. 1997
Features: Added Intuitive cursors for Pick and Zoom.
          Left Select '+' as before.
          Added Toggles to enable/disable:
            Snap The Outlet Point to River Reach.
            Move The Outlet Point to Higher 
                 Accumulation Value
          Removed Snap Distance from Parameter dialog.
          Added HUCS to the display features dialog.
 
Version 2.51
------------
Date    : Nov. 1997
Features: Changed basin delineation coordinate entry
          delimiter from ':' to ' '. also accepts
          decimal degrees on entry.
          Export Rivers format NWRFS Version 5 has
          been replaced with IFP/NAV/StageIII format.
          Warning messages have been added in Export
          if the output files already present.
          Warning message has been added on exit from
          IHABBS if there are lingering temporary
          raster and vector files in the working 
          directories. see Help - Temporary Files.

Version 2.52
------------
Date    : Dec. 1997
Features: Allowed optional setting of the initial
          states of SnapToRiver and 
          MoveToHigherAccumulation flags in the 
          configuration file.

Version 2.54
------------
Date    : Jan. 1998
Features: Changed Lat/Long DDD:MM:SS format to
          DDD MM SS, with space as field separator.

Version 2.60
------------
Date    : Apr. 1998
Features: Added 3000 point limit for exporting in 
          Version 5, WHFS and WINQPF formats.
          Added 5000 point limit for exporting in 
          XNAV format.

Version 2.62
------------
Date    : Dec. 1998
Features: Corrected a bug in Modify Basin Boundaries
          that refused to edit because of an upstream
          outlet.
          Closing window/cursor zone core dump bug fixed.
          Spanish help file capabilities were also added.

Version 3.0
-----------
Date    : May. 1999
Features:  
        * More stable GUI.
        * User can now define up to 6 elevation zone
          boundaries within a basin. 
        * Creating/modifying basin calculates mean/min/max
          slope, elevation, and aspect.
        * Query basin now has an option for "Less" or "More",
          where the user may view the traditional basin
          attributes or the expanded, which include the 
          statistics described above. 
        * Opening an old basin layer will update and 
          calculate these attributes. Note that these
          older basin layers will need to be updated
          before other applications can effectively use
          them. (They'll receive warning messages otherwise.)
        * All Export and Removing/Renaming of file 
          functions removed. (They are now accessible from
          the File submenu on the NOHRSC toolbar.
        * Program can be run from the NOHRSC toolbar
          (for improved color management)
        * IHABBS can be executed outside the <BIN> directory
          from the NOHRSC toolbar.
        * IHABBS shares the nohrsc.cfg configuration
          file.
        * Background color can be stored in the 
          configuration file. 
        * IHABBS now looks to see if any modified basins 
          will affect hydrographs created in Unit Hydrograph.
          Note that the two programs have to use the same
          hydrograph TABLENAME stored in the config file.
          
Version 3.01
------------
Date:   Jun. 1999
Features:
        * Cosmetic changes to edit basin dialog
        * Bugfixes, including
          * Not properly reading in decimal coordinates now
            fixed.
          * Raster querying without a CWA layer present now doable
          * Too many open files bug fixed. 

Version 3.02
------------
Date:   July 1999
Features:
        * Bug interfering with delineation by coordinate fixed.
 
Version 3.03
------------
Date:   July 1999
Features:
        * Calculating major rivers is much faster
        * Snap to river reach delineation option can
          be set in the config file using SNAP = Yes/No
        * Move to higher accumulation delineation
          option can be set in the config file using
          MOVE = Yes/No

Version 3.04
------------
Date:   Jan. 2000
Features:
        * IHABBS automatically converts the entered
          tablename of a saved basin to lowercase.
          This is done for improved compatability with
          dbschema. 
        * Redelineation during basin deletion process
          handles flat areas better.
        * Basin geometry calculation handles edges of
          rasters and no data values better.
        * Selecting from list dialog bug fixed.
        * "Pretty basin" bug associated with basin deletion
          fixed       
        * Fixed ROR basin deletion bug. 
        * Fixed inability to change point type when updating
          basin attributes

Version 3.05
------------
Date:   Mar. 2000
Features:
        * Fixed bug during basin deletion process that
          returned an "object_identifier # not encountered"

Version 3.07
------------
Date:   Aug. 2000
Features:
        * Progress indicator during delineation process
        * Added capability to view Land use and cover
        * Improved split basin check while editing basins
        * Added check for basin splitting while
          delineating within a modified basin
        * Added use of control- keyboard shortcuts for
          zoom

Version 3.08
------------
Date:   Nov. 2000
Features:
        * Fixed sensitivity of ROR basin button
        * Does not launch if database not present
        * Leftover areas split by delineating within
          a basin now incorporated into subbasin as a
          modification.
        * Fixed a bug that corrupted the basin raster when
          delineating within a modified basin

Version 3.10
------------
Date:   May 2001
Features:
        * Edit basin updated CWA field properly
        * Query basin displays adjusted discharge
          coordinate, not original unadjusted
        * Ability to open flow direction grid as
          read only-- does not copy flow layer into
          temp file and does not allow editing of 
          non-contributing area
        * Allows flow direction grid to be of
          different resolution than terrain layers
          (DEM, accumulation, etc)...
        * Fixed exposed canvas callback which allows
          non HP X library displays to successfully
          select with mouse
        * Looks for configuration file properly in
          current directory first
        * Fixed a bug that vectorized internal basin
          depressions if mirror flow at discharge 
          point
        * Uses several new columns in the product
          table and product groups tables. The tables
          can be updated using the update_table.sh
          script. Note that once this is done, older
          executables may not be able to save properly
        * Can use the GISRS_SCRATCH_PATH environment
          variable to redirect temporary file creation
          to another directory (a local, one for example)

Version 3.11
------------
Date:   Aug 2001
Features:
        * Basin geometry statistics calculation fixed
        * Edited ROR basin able to split parent basin
        * More tolerant of corrupted files

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

        * linux version
        * Support for read only/24 bit color
        * More tolerant startup
        * "type" (from product table) added to product 
          group table

Version 3.13
------------
Date    : Mar. 2002
Features:
        * Major river calculation more efficient
        * Changing vector/point color interface
          issues fixed

Version 3.14
------------
Date    : May  2004
Features:
        * Fixed potential crash bug in displaying legend
        * Fixed several bugs that dealt with delineating
          within a basin that contained an ROR basin

Version 3.15
------------
Date    : June 2004
Features:
        * Rescale on Zoom checks appropriate raster area
        * Fixed potential crash bug when closing layer

Version 3.16
------------
Date    : July 2004
Features:
        * Fixed possible crash bug when batch delineating

Version 3.17
------------
Date    : Nov. 2004
Features:
        * Fixed displaying of non-existent stations
        * Fixed initializing of opened basin layer
        * Handles different downstream ROR basins better
        * Allows more editing of ROR basins
        * Requires flow direction grid to be saved
          only when values actually change.

Version 3.18
------------
Date    : June 2005
Features:
        * Fixed a bug where the basin raster would
          become corrupted if delineation errored
        * Skips no data values in the flow direction
          grid instead of erroring
        * Allows attempt to get rid of unknown values
          in the basin raster
        * More tolerant of editing around NCA
        * More tolerant of calculating upstream area
          with bad basin topology

Version 3.19
------------
Date    : October 2006
Features:
        * Fixed initializing of basin river precision attribute
          where not snapping to a river

Version 3.20
------------
Date    : February 2007
Features:
        * Save dialogs default to original names
        * Save checks presence of existing attribute table
          before writing
        * Save checks writability of existing attribute table
          before writing
        * Save does not save permissions on a file that is owned
          by someone else.

Version 3.21
------------
Date    : March 2008
Features:
        * Fixed a bug where an error situation would cause IHABBS to crash.
        * Tolerates (corrupted) basins where non-contributing area pixels
          are found underneath unedited basin pixels.

Version 3.22
------------
Date    : May 2010
Features:
        * Fixed floating point precision when comparing discharge points
        * Prevents modification of ROR basin type


/ONE Glossary
Glossary

CWA    : County Warning Area
D8     : A means of representing flow directions in
         a raster format. For a given elevation pixel
         the eight neighbors are examined. The pixel
         with the lowest elevation relative to the
         center pixel defines the flow direction.
         There are eight possible flow directions:
         north, northeast, east, southeast, south,
         southwest, west, and northwest.
dangling stream :
         A stream whose tail water does not tie into
         another stream.
DEM    : Digital Elevation Model. A raster data file
         containing terrain elevations. Our DEM was
         constructed from 3-arc second USGS DEM's and
         Canadian DTED files.
DLG    : The USGS Digital Line Graph format for
         vector data sets.
EPA    : The Environment Protection Agency
flow accumulation :
         The sum total area of all terrain flowing
         to a given pixel not including the area of
         that pixel.
flow direction :
         The D8 direction that water from a given
         pixel flows. See D8. 
focus  : The Motif window that is currently receiving
         keyboard or mouse input.
GIS    : Geographic Information System. Software for 
         managing geographically distributed data.
IHABBS : Integrated Hydrologic Automated Basin 
         Boundaries System
HSA    : Hydrologic Service Area
NOHRSC : The National Operational Hydrologic Remote 
         Sensing Center
non-contributing-area :
NCA    : Part of the landscape into which water flows
         but out of which water does not flow.
NWS    : The National Weather Service 
parent basin :
         The basin in which a rain-on-reservoir
         resides.
pixel  : Picture element. An individual raster matrix
         value. A pixel defines a value at a specific
         raster location.
rain-on-reservoir basin :
ROR    : A basin whose spatial limits are defined
         by the maximum pool elevation of a dammed
         reservoir. An ROR basin is an island polygon
         within a parent basin polygon.
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.
RFC    : River Forecast Center
topology :
         The order in which objects are linked 
         together.
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 IHABBS. 

'nohrsc.cfg' has the following entries pertinent 
to IHABBS use:

      ** Program Layers And Parameters **
ACCUMRATIO    = Tension parameter used in adjusting
                the computed coordinates of snapped
                outlet point in relation to the flow
                accumulation data.
                Optional - default is 4.0
DATABASE      = PostgreSQL database name 
                (main database for attributes)
                Required - e.g. 'development'
SCHEMA        = PostgreSQL schema name
                (main schema in database for attributes)
                Required - e.g. 'gisrs'
TABLENAME     = Hydrograph table name, used for
                checking altered hydrographs.
                Optional - default is "hydrograph".
RADIX         = Initial IHABBS display degrees
                format. 
                options: 10 for decimal degrees
                         60 for DDDMMSS.S
                Optional - default is 10
IHABBSHELP    = this help file 
                Optional - default is 'ihabbs.hlp'
SPANISHIHABBSHELP = help file in spanish (where necessary)
		Optional - default is 'ihabbs.hlp.e'.
MAJORLENGTH   = Major river threshold length in
                kilometers
                Optional - default is 0.0   
RESCALE       = Initial IHABBS optional parameter
                rescale on zoom. Yes or No
                Optional - default is Yes
LEGEND        = side of screen that GIS legend appears on.
                LEFT or RIGHT. Optional - default is HIDE. 
                (not viewed)
SNAP          = Snap to river reach delineation option.
                Yes or No. Optional - default is Yes.
MOVE          = Move to higher accumulation delineation  
                option.
                Yes or No. Optional - default is Yes.
RFC           = RFC name
                (for extents and zoom limits)
                Required - e.g. ABRFC
STARTHEIGHT   = Initial IHABBS display window height
                fraction of monitor height (.1-.99)
                Optional - default is .80
STARTWIDTH    = Initial IHABBS display window width
                fraction of monitor width (.1-.99)
                Optional - default is .80
UNITS         = Initial IHABBS display 
                units. options: English or Metric
                Optional - default is English
ZOOMFACTOR    = startup zoom in/out factor. 
                Optional - default is 2.0
BGCOLOR       = Startup background color.
                Optional - default is system color.
HICOLOR       = Startup highlight color, the default
                color for basin outlets.
		Optional - basin outlets default to black
MAXY	      = Zooming out extents of RFC - North. Required.
MAXX          = Zooming out extents of RFC - East. Required.
MINY          = Zooming out extents of RFC - South. Required.
MINX          = Zooming out extents of RFC - West. Required.

      ** Raster Layer Names **
ACCUMULATION  = flow accumulation raster layer
                (for computation and display)
                Required - 
ASPECT        = aspects raster layer
                (for display only)
                Required - e.g. abdem_15.a
ELEVATION     = DEM raster layer
                (for display only)
                Required - e.g. abdem_15.e
FLOWDIRECTION = flow direction raster layer
                (for computation and display)
                Required - 
SLOPE         = slopes raster layer 
                (for display only)
                Required - e.g. abdem_15.s

      ** Vector Layer Names **/
RIVERS        = streams layer for the rfc.
                (for display only)  
                Required - e.g. abrf1
REFBASINS     = reference basins vector layer
                (for display only)
                Optional - e.g. basin_1995
COUNTIES      = counties boundaries vector layer
                (for display only)
                Optional - e.g. counties 
CWAS          = county warning areas vector layer
                (for display and selection)
                Required - e.g. cwas
HUCS          = HUCS vector layer
                (for display only)
                Optional - e.g. hucs
LAKES         = lakes and streams vector layer
                (for display only)
                Optional - e.g. lakes
MAJORRIVERS   = major rivers vector layer
                (for display only)
                Optional - e.g. rf1_150
RFCS          = RFC boundaries vector layer
                (for selection and display)
                Required - e.g. rfcs
STATES        = states boundaries vector layer
                (for display only)
                Optional - e.g. states
WORLD         = world outline vector layer
                (for display only)
                Optional - e.g. world
STATIONS      = Observation station point layer
                (for display only)
                Optional - e.g. stations
                
Only lines starting with these keywords are 
processed.  All other lines are considered comments.



/ONE Batch Delineate Input File Format
Batch Delineate Input File Format:

Records are separated by newlines, and in each record,
fields are separated by a '|' character.
Therefore no field may contain '|' as data.
Format for each record:

Fld Format  size Description
--- ------- ---- -------------------------------------
001 String   1-5 River Forecase Center acronym
                 - e.g. ABRFC 
002 String   1-5 COMS Handbook 5 ID for outlet point
                 - e.g. CARC1
003 String   1-8 Shef ID for the associated basin
                 - e.g. RIVERUPPR
004 String   0-3 CWA ID for the outlet point
                 - e.g. AMA
005 String  0-32 Forecast Group for the associated
                 basin
006 String     1 Point type: 'f'=forecast, or
                             'd'=data point.
007 Integer    2 Latitude degrees north sans sign
                  - e.g. 39    
008 Integer    2 Latitude minutes north - e.g. 45
009 Integer    2 Latitude seconds north - e.g. 03
010 Integer  2-3 Longitude degrees west sans sign
                 - e.g. 106
011 Integer    2 Longitude minutes west - e.g. 13
012 Integer    2 Longitude seconds west - e.g. 59
013 String  0-80 Description - e.g. Carrol River 
014 Decimal 0-10 Drainage basin area in square miles
                 - e.g. 140.4 
015 String  0-40 User-defined attributes. May be used
                 by the user for any purpose.
// 
// End of ihabbs.hlp //
//
