The RGM HEC 2000 software program provides an interactive graphical user interface to the Army Corps of Engineers HEC-1 computer program. The program operates in a Windows™ environment and uses familiar menus, controls and procedures.

The program was written to benefit engineers and hydrologists by maintaining the classic features of HEC-1 and providing a user-friendly environment that is compatible with Microsoft Windows. For example, data from RGM HEC 2000 can be copied across applications, such as Excel or Word using the clipboard, Also, graphs produced by the program are presented in a standard graphical format for use in other software.

The HEC-1 program is distributed herein, in conformance with the Army Corps of Engineers stipulations that permit free distribution. All of the files that are necessary to operate the program are shipped with the RGM HEC 2000 software package.

The program is installed from the Install CD by executing the Setup.exe file in the root directory. The installation instructions are presented in successive screens and are self-explanatory.

The project files may be set up in separate directories to maintain good file housekeeping. RGM HEC 2000 will operate on the project files from its own application directory.

Each INSTALL CD is coded by Version Number and a unique Serial Number. These numbers can be recalled during program operation using the About Menu.  The Key number is attached to the CD case and must be entered to install the program.

Executing the program file RGMHEC2000.exe or the shortcut starts the program with the start-up information screen. Click the screen to proceed.

Use FILE, OPEN, and then browse for the appropriate file name. For convenience, some standard HEC-1 sample files are provided on the Install CD.

If any files appear in the list at FILE, Open Recent Files Saved As: a file can be opened by clicking the file reference.

The HEC-1 input file is in text format using Fortran type columns. RGM HEC 2000 simplifies data entry using a specialized spreadsheet designed specifically for HEC-1 input.

Data may be entered directly into the spreadsheet. Navigation Keys are available to speed data entry. The descriptions of the specialized features of the spreadsheet are provided later in this document.

RGM HEC 2000 provides a simple error checker using the AUDIT DATA menu. This routine checks for obvious errors in your data, such as too many characters in a column, or lack of the ZZ card, to name two. The error(s), if any, are reported in a message box.

HEC-1 is accessed using the RUN menu. Depending on the computer speed, the results are available almost instantaneously.

The results of a HEC-1 run may be viewed in RGM HEC 2000 in several ways, as follows:

The output of HEC-1 is a text file that may be read directly from RGM HEC 2000 using the VIEW HEC-1 OUTPUT menu. The program knows to read the latest HEC-1 output file.

There are screen action buttons that allow the user to navigate quickly to the bottom and top of the file as well as a right-button menu with the same features.

Data from the output file may be copied for use in another program, or the text output may be saved or printed. A Zoom feature is also provided since fonts are generally small to fit on a standard page width. In Zoom mode a horizontal scroll bar facilitates viewing.

To request specific hydrographs be output from HEC-1, the user must provide a KO card with the value 21 in the five column. The KO card is typically entered after the KK card, and RGM HEC 2000 provides automation for this in the TOOLS menu.

When the program has RUN, and after the GRAPH DATA menu -- then GRAPH menu have been accessed, the user may view tabular hydrograph data in three formats:

Hydrodata - shows three decimal hydrograph ordinates for the runoff duration for each hydrograph written out using the KO card with a value of 21 in column five.

Center of Mass menu - Included in the Hydrodata screen is a menu that will compute the Center of Mass of the hydrographs.  This is useful quantity when the detention time of a storm routed through a basin is needed.

Peak Flows - a horizontal spreadsheet view of just the peak hydrograph flows versus the KK station for each hydrograph that was written out using the KO card with a value of 21 in column five.

Tabular Peak Flows - a table of the peak hydrograph flows versus the KK station for each hydrograph written out using the KO card with a value of 21 in column five.

RGM HEC 2000 contains a powerful yet simple graphing routine to allow the user to visualize hydrographs easily with a minimum of user intervention. The hydrographs that are written out are identified by inserting a KO card (with a value of 21 in column 5) after the KK card of the requested station.

To view the hydrographs access the GRAPH DATA menu then GRAPH menu. Select the KK station and Plan. Use the GRAPH menu or GRAPH button and the hydrograph will be displayed.

RGM HEC 2000 selects differing colors each time the screen is redrawn. This feature is provided to assist the user in distinguishing lines on computer monitors. Selecting the GRAPH button additional times will reset to a new palette of colors each time.

There are four (4) sliders to adjust the plot. One may use the Y Expansion scroller along the right side, the X Expansion or the Pan Shift scroller interactively until a good representation of the plot is found. The values near each slider provide a numerical reference of the relative scales.  The Zoom slider will adjust the graph in logical steps and may be appropriate in some cases, but not all.

The vertical scale tick marks are automatically adjusted by the Graph routine.

In addition, one may determine roughly the hydrograph values on the plot using the mouse. The Y value (usually cfs) and the Time value are shown on the Information screen as the mouse is moved.

Adjust the graphs line width using the slider.

There are three methods provided to edit the plotted hydrographs.

On-the-Fly Annotation - select a hydrograph by clicking into the cell of the Plan box. Right-click and drag the text line to a point on the screen. Continue moving a stalled text line by right clicking on the graph screen. Double click to set the text line on the screen.

Text Mode - Click the graph screen and a text box will appear. Enter text, move with a left mouse Click to another part of the screen. Final set the text by Double-Clicking the Text Box.

Erase Mode - Click the ERASE MODE button and window a portion of the screen to erase.

Graph Editor - The RGM HEC 2000 program ships with a copy of Windows paint, which is actually provided by windows to all users as a part of the operation system. Click the GRAPH EDITOR button and the hydrograph screen will be presented in Windows Paint for editing. Consult the Windows manual for instructions on the use of Paint, however, it is a fairly straightforward program that can be operated using the toolbars and menus. Graphs can be saved during this procedure as well as from the EXPORT GRAPH button. Any registered Windows graph editor will work though it must be OLE compatible (Windows style programs). Apple Quick Time will stall as it is not OLE compliant.

When editing is complete the user can click the FILE, EXIT AND RETURN menus to return to RGM HEC 2000. You are then asked if you want to keep the edit or discard the edit and return to the previous view. Click NO EDIT if you want to discard the changes and click KEEP EDIT if you want to keep the edited version.

Clear Graphic - clears the current screen. Generally, you can restore a cleared graphic by clicking KEEP EDIT after the GRAPH EDITOR. Of course, one can redraw the selected graphs by merely clicking GRAPH as many times as needed to achieve the desired color palette.

There are two file operations in the Graph routine.

Exporting or Saving a Graph - use EXPORT GRAPH to save the graph to a disk file. The graph is saved in Windows BMP format in the directory selected.

Saving a KK/Plan Scheme - occasionally the user has developed a group of hydrographs that may need to be saved as a set for future use. Click FILE, SAVE KK/PLAN SCHEME to save the set of KK stations and Plans that are currently checked.

Loading a KK/Plan Scheme - The saved set or schemes can be retrieved using menus FILE, LOAD KK/PLAN SCHEME.

RETURN to the Main screen to continue, or to revise data for another run.

RGM HEC 2000 provide a number of useful routines that evaluate the data produced by HEC-1.

RESERVOIR ROUTING OUTPUT

This routine can be used to review all hydraulic routings produced by HEC-1. For example, if there are detention basins in the output, one can review the HEC-1 output screen and scroll to the position of the sought routing. However, the Reservoir Routing Output condenses the output information into one screen. This feature can be used when iterating to a specific flood stage elevation or outflow.

When HEC-1 is run again the output screen is updated, when activated, with the new data.

AUTO COMPARE KK PLANS

Use this feature to compare sets of KK stations. Click the first Station and it will appear on the mid-screen, then click another KK station and it will appear and be compared. If the second line value is greater than the first line value, it will be highlighted. This feature is useful when iterating to a solution between two stations where the second line values of flow must be less than or equal to the first line values, as is often the goal in storm water management when comparing existing and proposed cases.

Click on the Compared pane and the pane will be cleared. Refresh data if necessary. The user may copy data to the Clipboard during this routine, for use in other applications.

When HEC-1 is run again the screen is updated, when activated, with the new data.

MULTI- KK COMPARE

A series of KK comparison sets can be listed from the left pane. If the second line value is greater than the first line value, it will be highlighted. Item pairs can be removed or added one KK station at a time using the ADD and REMOVE buttons.

When HEC-1 is run again the screen is updated, when activated, with the new data.

PRINTING GRAPHS

Graphs may be printed in three ways:

Simple Print Graph located in the File menu in the Grapher Program; permits printing to the default printer, and allows adjustment of the margins, and control over landscape and portrait style.

Graph Editor; the users default graph editor (MS PAINT) can be used by using the Graph Editor in the Grapher Routine.

Export Graph, can be used to save the graph to a disk file for later printing by appropriate software, or inclusion as a picture file in other applications.

FILE, OPEN will open a standard HEC-1 input file in column format.

FILE, IMPORT INPUT DATA - allows the opening of another HEC-1 input file to examine or copy data.

FILE, USE FREE OR RAW DATA - allows user to open and convert a HEC-1 File that was written in free format (*FREE card was used in the file). RAW input is plain text data that one wishes to convert to HEC-1 Format.

The Free Format screen is used to OPEN or PASTE a file. CONVERT the file, and review whether the convert worked sufficiently. A properly formatted HEC-1 File in FREE format should convert correctly. If there are extra spaces, tabs or commas in the FREE or RAW file, these can be removed and adjusted in the Free Format screen, then CONVERT again. One may Save or Copy the File from the Free Format Input Screen that shows after CONVERT is pressed.

FILE, Open Recent Files Saved As: - select the file and it will be opened.

FILE, SAVE - saves the HEC-1 input file

FILE, SAVE AS - saves the HEC-1 input file and records the data and time in the recent file list.

FILE, QUIT PROGRAM ends the RGM HEC 2000 program and returns the user to Windows™. Appropriate screen safeguards are built in to prevent the accidental loss of data.

There are various features of the spreadsheet that assist the user in important ways. These are enumerated as follows:

Cell Color indicates five modes - the user can not change these colors:

Editing Comment Card (KM), ID cards, KK cards, "*" Cards - use COMMENT ENTRY or double click the left, fixed column to enter the comment card edit mode. The Edit Comments screen will appear and allow a more convenient form of text entry than entering data field by field. The user can hit ENTER or SAVE AND EXIT to save the editing line. Use ESC key to exit, or the CANCEL EDIT button.

Editing Cell Text - click into any cell to edit cell text. Editing is complete when the active cell is changed by; arrow keys, mouse moves or ENTER. Cell editing features are available also on the right mouse button.

For convenience, the comment card editor will not edit the station name of the KK card, only the columns beyond that provide descriptive or comment type data.

INSERT ROW inserts a row above the current cursor position.

DELETE ROW deletes the row of the active cell.

DELETE LINES - from the RIGHT BUTTON, DELETE LINES menu or the EDIT, DELETE LINES menu deletes a selection of lines.

EDIT UNDO / REDO – unlimited levels of undo are available. The REDO command will bring the screen back to the last undo one time only. A record of the Undo level is presented on the status bar. A value of 1 indicates the system has undone all edits.

EDIT, COPY will copy a selection.

EDIT, CUT will erase or cut out a selection.

EDIT, PASTE ABOVE / INSERT LINES will insert the number of cells necessary to paste the clipboard to the spreadsheet starting at the active cell position.

EDIT, AREA PASTE OVER will overlay the clipboard contents starting at the active cell position, replacing the current contents of the cells with the pasted data.

EDIT, CLEAR CONTENTS is similar to EDIT, CUT except that the contents are not entered into the Clipboard. It is possible to use UNDO to retrieve data erased by CLEAR CONTENTS.

Most commands may be accessed by speed keys using the ALT key or CTRL key.

Use the ALT key and the underlined letter of the respective command to access commands located in the top menu of each screen.

File Operations

Start a New HEC-1 File CTRL N

Open a HEC-1 Input File CTRL O

Save a HEC-1 Input File CTRL S

Editing

Settings

Tools

SETTINGS, USE FULL SCREEN - major program screens will operate at full screen rather than as a window. Operation will return to windowed screens if unchecked

SETTINGS, RESET UNDO – when the UNDO memory becomes large, the user may recover that memory by discarding past UNDO levels. A warning screen provides the ser with the memory used by UNDO. By resetting UNDO, the user will no longer be able to UNDO back to earlier screens.

SETTINGS, UNDO OFF – using this feature will turn off the undo system and will result in faster operation.

SETTINGS, COLOR CHANGES - allows the user to set some of the default colors of RGM HEC 2000. The settings are not saved between each use. Click on the item in the Color Edit pane and a color edit screen will provide a color selection screen.

SETTINGS, GRID FONT – allows or changes the setting of the font used on the Spreadsheet.

SETTINGS, RESTORE COLOR - returns the color changes made to the default.

SETTINGS, TOGGLE GRIDLINES - turns the gridlines on or off.

SETTINGS, RESET - resets the cursor to the top and clears memory.

SETTINGS, ADJUST GRIDS - allows manual adjustment of rows and columns.

SETTINGS, DEFAULT ROW FONT - restores font to program default.

SETTINGS, PRINTER FONT - used to set the font for printing. The screen shows only monospaced fonts, as other fonts will not line correctly in columns. If no fonts are available the user must load monospaced fonts from the printer software. Windows provides the Courier Font as a default monospaced printer font.

SETTINGS, GRAY CURRENT BACKGROUND - the cells will take on a gray background. This is used to identify certain areas of the spreadsheet and is especially useful in long files where the user needs to return to a specific area of the spreadsheet for repeated operations.

SETTINGS, HIGHLIGHT CURRENT TEXT - a color selection screen allows the text color to be changed for the selected area of the spreadsheet.

SETTINGS, HIGHLIGHT FONT - allows a variety of changes to the selected cells, including color, font, etc.

SETTINGS, HIDE SELECTED ROWS - selected rows or the current row will be hidden, and will appear as a thin, horizontal line. The row numbering is not affected.

SETTINGS, UNHIDE ALL ROWS - restores visibility to rows that have been hidden.

TOOLS, IDENTIFY KK CARDS - will color the fonts in all KK cards to the color red to distinguish sections in HEC-1

TOOLS, IDENTIFY CARDS - will color any card by entering the card identification code (first column). The color of the fonts in the line containing the identification card will be colored blue.

TOOLS, IDENTIFY KK GROUPS – will shade and color the lines representing one station, between KK cards.

TOOLS, TRIM GRID TO ZZ CARD - will remove all empty lines past the ZZ card.

TOOLS, ADD KO PRINT CARD - will add the line with the minimum information necessary to use the GRAPH DATA menu items (a "21" in Field 5).

TOOLS, RUN HEC-1 AS WINDOW – Use to view the operation of HEC-1. If the user resets the "Close on Exit" (Ignored in Windows XP)  property of the executable file, HEC1E.EXE (by right clicking the file in Explorer) the HEC-1 window can be set to remain open until terminated by the user.  Windows XP will use the HEC1.EXE file.

TOOLS, RUN with DEBUG SCREEN - The program will write the results of the DOS execution to a Windows form - similar to running in a DOS mode window.

TOOLS, FIT ROWS - will minimize the spreadsheet row heights.

TOOLS, FIT COLUMNS - will minimize the column widths.

TOOLS, FILL ROWS AND COLUMNS – will minimize both the row heights and the column widths to create a more compact viewing area.

TOOLS - HELP TIPS - will toggle help tips when the user moves the cursor over a cell when the cell is in the no-edit (green) mode -- click into a new cell to obtain information about the field. The help tips are also always available on the status bar.

TOOLS, SELECT RECENT FILES TO CLEAR - selectively clears the list of files on the FILE menu. Recent files are added to the FILE menu whenever the user saves a file using FILE, SAVE AS.

TOOLS, ITERATER - One can perform quick computations of peak flows in in relation to any HEC-1 variable and see the results on a spreadsheet. This is often used for sensitivity analyses.

The program provides help in a variety of ways:

The status bar will provide information on the active card, from left to right, as follows:

1. Current File, including path. Also, whether Last File Run option was used.

2. The status of the Undos.

3. The Identification of the Card, PC, ID, KK, etc.

4. The HEC-1 Row in accordance with the output file. The program will track cards that HEC-1 does not number and will adjust accordingly.

5. The Field number - fields are in accordance with HEC-1 numbering system.

6. The HEC-1 program variable - as identified by HEC-1.

7. The HEC-1 description of the variable.

The HELP menu provides two methods to find help:

HELP, BROWSE HELP FILES - uses a mini-browser that navigates using BACK, FORWARD and jumps as in a web browser. The HEC-1 Manual or the HEC-1 Appendix may be selected

HELP, SEARCH HELP FILES - allows the user to search the HEC-1 Manual, the HEC-1 Appendix or this Operation manual may be searched.

HELP, ABOUT - provides information about the RGM HEC 2000 computer program including author, support website, and copyright.

HEC-1.COM - Check the web site for free software updates and notes on the program.  Use the website to ask questions by email.

FILE, PRINT SETUP - allows the user to set up the printer. Generally, the best print method is to use a 6 point monospaced font that will print the entire card line on a standard 8-1/2 inch wide sheet.

FILE, PRINT - will print the HEC-1 input data.

The RGM HEC 2000 program provides error messages that generally describe common problems during use. Typical trouble or errors are as described follows:

This program has been severely tested in actual production and should operate flawlessly. Nevertheless, in the event additional assistance is needed, email:

with your question or description of problem. Comments will be sent to the return email address subject to conditions of purchase.

License Agreement

I GRANT

Ralph. G. Mastromonaco, P.E., P.C. ("RGM PE, PC") hereby grants To the end user person or entity ("Licensee") a Non-exclusive license to use the accompanying Software product(s), in machine executable Object code form (the "Software") subject to The terms and conditions set forth below. LICENSEE MAY use the Software on any single Computer; use the Software on a second computer So long as the primary user of each copy is the Same person and more than one copy is not Running simultaneously on a second computer; And copy the Software for archival purposes, Provided any copy must contain all of the Original Software's proprietary notices. LICENSEE MAY NOT permit other individuals to Use the Software except under the terms listed Above; modify, translate, reverse engineer, Decompile, disassemble (except to the extent Applicable laws specifically prohibit such Restriction), or create derivative works based On the Software; copy the Software (except as Specified above); export, directly or Indirectly, the Software to any person or Entity outside the United States except as Provided in paragraph 6 below; rent, lease, Transfer or otherwise transfer rights to the Software; or remove any proprietary notices or Labels on the Software.

II LIMITED MEDIA WARRANTY

RGM PE, PC warrants that, for a period of thirty (30) days from the date of delivery to Licensee As evidenced by a copy of Licensee's receipt, The media, if any, on which the Software is Furnished shall be free from defects in Materials and workmanship under normal use. The sole responsibility and Liability of RGM PE, PC, and Licensee's exclusive remedy under this limited warranty will be replacement of the defective media. Disclaimer Of warranties. Except for the express limited Media warranty stated above, Licensee expressly acknowledges and agrees that use of the Software is at Licensees sole risk. The software is provided "as is" And without warranty of any Kind. RGM PE, PC and its Licensors and suppliers make No warranties or conditions, Express or implied, including Without limitation the Implied warranties or Conditions of Merchantability, fitness for A particular purpose, and Non-infringement, regarding The software. Neither RGM PE, PC nor its licensors or Suppliers warrant, guarantee Or make any representations Regarding the use or the Results of the use of the Software in terms of its Correctness, accuracy, Reliability, or currentness Or that the operation of the Software will be Uninterrupted or error free. The entire risk as to the Results and performance of The software is assumed by Licensee, including without Limitation any risk of the Introduction of computer Viruses and any risk arising Out of any content Transmitted or received in Connection with the use of The software. The exclusion of implied warranties is not Permitted by some states or other jurisdictions and therefore the above exclusion may not apply to licensee. This warranty gives licensee Specific rights and licensee may also have other rights, which may vary, from state to State and jurisdiction to Jurisdiction.

III LIMITATION OF LIABILITY PE, PC's liability to Licensee or any third party arising out of or related to this Agreement however caused and on any theory of liability, whether in contract, tort (including negligence), or otherwise will not exceed the fee, if any, paid by Licensee for the Software. The Software is not specifically developed or licensed for use in any nuclear, aviation, mass transit, or medical application or any other inherently dangerous applications.

Neither RGM PE, PC nor its Licensors or suppliers shall be liable for any claims or Damages arising from such use of the software. In no event Will RGM PE, PC or its licensors Or suppliers be liable to Licensee or any third party For any indirect, special, Incidental, or consequential Damages (including damages For cost of obtaining Substitute goods, loss of Business profits, business Interruption, loss of data And equipment, and other such Damage or loss), however Caused (including without Limitation any loss caused by The introduction of computer Viruses or content Transmitted or received in Connection with the use of The software) and on any Theory of liability, whether Based in tort (including Negligence), contract, or Otherwise, even if RGM PE, PC, Or its licensors, suppliers Or authorized dealers have Been advised of the Possibility of such damages. Licensee acknowledges that the license fee, if any, reflects this allocation of Risk. Because some states or Other jurisdictions do not Allow the exclusion or Limitation of liability for Consequential or incidental Damages, the above Limitations or exclusions may Not apply to licensee.

IV TITLE

Title, ownership rights, and intellectual property rights in and to the Software shall remain in RGM PE, PC and/or its licensors and suppliers. The Software is protected by the copyright laws of the United States and international copyright treaties. Title, ownership rights, and intellectual property rights in and to the content accessed through the Software is the property of the applicable content owner and may be protected by applicable copyright or other law. This Agreement gives Licensee no rights to such content. Except as expressly provided herein, all right, title and interest in and to the Software remains with RGM PE, PC and its licensors and suppliers.

V TERMINATION

The Agreement, including all of Licensee's right to use the Software, will terminate automatically and immediately if Licensee fails to comply with the limitations described above. Upon termination, Licensee must immediately stop using the Software and Licensee must return to RGM PE, PC or destroy all copies of the Software.

VI EXPORT LAW ASSURANCES Licensee agrees not to export the Software outside of the United States except as permitted by the laws and regulations of the United States. If Licensee has rightfully obtained the Software outside of the United States, Licensee agrees not to re-export the Software except as permitted by the laws and regulations of the United States and the laws and regulations of the jurisdiction in which

Licensee obtained the Software.

VII GOVERNMENT RESTRICTED RIGHTS LEGEND

If Licensee is acquiring the Software on behalf of any part of the United States Government, the following provisions apply. The Software and accompanying documentation are deemed to be "commercial computer software" and "commercial computer software documentation", respectively, pursuant to DFAR Section 227.7202 and FAR 12.212(b), as applicable. Any use, modification, reproduction, release, performance, display or disclosure of the Software and/or the accompanying documentation by the U.S. Government or any of its agencies shall be governed solely by the terms of this Agreement and shall be prohibited except to the extent expressly permitted by the terms of this Agreement.

Ralph. G. Mastromonaco, P.E., P.C. 13 Dove Court Croton-on-Hudson, NY 10520

VIII MISCELLANEOUS

This Agreement represents the complete agreement between Licensee and RGM PE, PC concerning the subject matter hereof and supersedes all prior agreements and representations between them. It may be amended only by a writing executed by both parties. The acceptance of any purchase order placed by licensee is expressly made conditional on licensee's assent to the terms set forth herein, and not those contained in licensee's purchase order. If any provision of this Agreement is held to be unenforceable for any reason, such provision shall be reformed only to the extent necessary to make it enforceable. This Agreement cannot be amended, modified, or waived, unless the change is written and signed by an authorized RGM PE, PC representative. This Agreement is governed by the laws of the State of New York, without reference to its conflict of law principles. Should Licensee have any questions concerning this Agreement, please contact in writing:

Ralph. G. Mastromonaco, P.E., P.C.13 Dove Court Croton-on-Hudson, NY 10520

[HOME]