gw90 manual

543
GASWorkS9.0 User's Manual Bradley B. Bean, PE 419 East Columbia Street, Colorado Springs, Colorado 80907 USA Distributor: COMPUTERS & ENGINEERING Holzmühler Weg 87-89, 35457 Lollar-Germany. www.comp-engineering.com

Upload: ultron2099ultron

Post on 22-Nov-2014

116 views

Category:

Documents


0 download

TRANSCRIPT

GASWorkS 9.0

User's Manual

Bradley B. Bean, PE

419 East Columbia Street, Colorado Springs, Colorado 80907 USA Distributor: COMPUTERS & ENGINEERING Holzmhler Weg 87-89, 35457 Lollar-Germany. www.comp-engineering.com

1991-1997, 2006 Bradley B. Bean, PE - All rights reserved.

GASWorkS 9.0

Licensing...GASWorkS, its options, and supplements are licensed for installation on only one computer per authorized copy. That is, only one copy of the program is intended to be installed per license. Each purchased copy of the program represents one license. We are relying on your honesty and integrity to ensure that multiply copies of the program are not created. In reference to this paragraph, the following definitions shall apply: Software shall mean the GASWorkS program, documentation, and any associated options, enhancements, or supplements; User shall mean the individual or organization purchasing the Software, the individual or organization employing the persons to be using the Software, the individual or organization otherwise responsible for the administration of the use of the Software, or any affiliate thereof; Developer shall mean Bradley B. Bean, PE. By use of the Software, the User consents to accept full responsibility for the use of the Software including: Interpretations or decisions based on any results derived from the Software; Any claims resulting from the use, accidental misuse, or intentional misuse of the Software by the User; And for reimbursement of the original purchase price to the Developer for each unauthorized copy of the Software generated from the User's authorized copy. Depending on the specific version received by the User, the Software will use a certain copy protection method. The method may require registration of the software with the Developer, installation of a physical security device on the Users equipment, or other method of protection. By installing the Software the User consents to the means of copy protection.

It is the User's obligation to immediately return the Software, without installing it, if they do not concur and consent to these Licensing requirements.

Trademark Notice...GASWorkS, GASBase, and the "B-Cubed" logo are trademarks of Bradley B. Bean, PE. dBASE is a trademark of ASHTON TATE a division of Borland International. AutoCAD is a trademark of Autodesk, Inc. Arc/Info is a trademark of Environmental Resource Systems Inc. Windows (and it variations and derivations) are trademarks of Microsoft Corporation. MicroStation is a trademark of Bentley System Inc.

Copyright Warning...The GASWorkS software and User's Manual are protected under United States and international copyright laws and treaties. Making unauthorized copies of either the software or the associated documentation is a violation of United States and international law. Don't be a criminal, don't copy.

Bradley B. Bean, PE

ENGINEERING & SOFTW ARE

i

GASWorkS 9.0

Guarantee...If you are not fully satisfied with the performance of GASWorkS, uninstall the software, return the original distribution materials, hardware key (if provided), and documentation within thirty days of the date of receipt. We will promptly refund the original purchase price. If during the useful lifetime of the software, GASWorkS or its options do not perform as claimed, notify us of the deficiency and we will promptly address your concern and do our best to correct the problem.

Application LimitThe number of Users that can simultaneously run the GASWorkS software is dependent on the license style purchased. This number is referred to as the application limit. A single User license allows only one User at a time. A limited network license allows a fixed number of Users (depending on the purchase agreement). An unlimited network license has no User limit. GASWorkS keeps track of how many Users are using it. When it is executed, it checks the number of Users currently using the software. If the application limit is not exceeded, the software will be started. If the application limit is exceeded, a warning message will appear and the software will not start. If GASWorkS is abnormally terminated, the User count will become corrupt and GASWorkS may erroneously report the number of current Users preventing additional Users from beginning execution. If this occurs, use the following procedure to start GASWorkS. Select the Windows Start button. The program menu list will appear. Select the Run item from the program list. At the Open prompt type \Program Files\GASW orkS 9\app\GW 90.exe /-1. Include the quotation marks. Note that there is a space between Program and Files, between GASWorkS and 9, and between the closing quote () and the forward slash (/). The quotes must be included for Windows to properly process the command.

Software UpdatesFrom time to time the GASWorkS software is revised and updated to correct reported or discovered bug fixes, to add User requested enhancements, and to perform other required maintenance. These updates are available for download and installation from our website www.b3pe.com. Notification of updates is not generally made to the User community, the User should occasionally check for new updates from this site. Frequently asked questions are also posted on the website.

Bradley B. Bean, PE

ENGINEERING & SOFTW ARE

ii

GASWorkS 9.0

About This Manual...This manual attempts to provide the User with an understanding of the GASWorkS software by providing extensive descriptions and documentation of its various features. The main body of the manual presents descriptions of the various menu items and data screens. Separate sections are provided for several of the more extensive features. The Appendix of the manual presents a primer on network analysis, along with technical documentation of the various equations and data files used and supported by GASWorkS. The use of italics is used extensively throughout the manual. Italicized words are used in two manners - one to emphasize a word, the other to indicate the name of a menu item, command button, screen name, or keyboard key. In addition to the information contained in this manual, examples, how-to tips and instructions are included in the GASWorkS On-Line help. A copy of this manual in Portable Document Format (pdf) is contained on the GASWorkS installation CD. With some versions of GASWorkS, the Demonstration Guide and Users Manual are installed and viewable using the Help menu. Additional information and documentation may be found on our website www.b3pe.com.

Bradley B. Bean, PE

ENGINEERING & SOFTW ARE

iii

GASWorkS 9.0

Bradley B. Bean, PE

ENGINEERING & SOFTW ARE

iv

GASWorkS 9.0

Table of Contents1 3 5 6 6 7 8 15 17 17 18 19 19 19 20 21 22 23 25 27 27 28 29 30 30 30 31 31 32 33 33 33 34 34 35 35 35 35 36 36 37

GETTING STARTED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Software Copy Protection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Execution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Uninstalling GASWorkS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Using GASWorkS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Release Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GENERAL INFORMATION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Hardware Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Software Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GASWorkS Data Elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Menu Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Menu Access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Command Execution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Negotiating Data Screens . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Accessing Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Accessing On-Line Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Notes For International Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . MENU ITEMS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . File - File Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . New - Create A New Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . New Project - Create A New Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Open - Open An Existing Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Close - Close A Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Save - Save Model Changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Save As - Save Model Changes To Another Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . Rename - Change The Name Of The Current Model . . . . . . . . . . . . . . . . . . . . . . . . . . Copy - Copy Model Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Delete - Deleting Model Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Append - Appending Model Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Bundle - (Submenu) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Bundle A Model - Zipping A Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . UnBundle A Model - Unzipping A Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . Purge - Removing UnRequired Model Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Preferences - (Submenu) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Paths - Setting The Default File Directories . . . . . . . . . . . . . . . . . . . . . . . . . . . Property Tables - Setting The Default Property Tables . . . . . . . . . . . . . . . . . . Options - Set User Interface Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Facility Settings - Display/Edit Facility Settings . . . . . . . . . . . . . . . . . . . . . . . Save Current Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Retrieve Saved Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Bradley B. Bean, PE

ENGINEERING & SOFTW ARE

v

GASWorkS 9.0

Table of Contents37 37 38 38 39 39 39 40 40 42 42 43 43 44 44 45 45 45 45 45 45 46 46 47 47 48 49 49 50 50 51 51 52 52 52 53 53 54 54 54 55 55 56 57 57

Restore A Model - Restoring Model Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Restore Samples - Restoring The Sample Models . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Quick Export - (Submenu) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Exit GASWorkS - Leaving GASWorkS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Edit - Entering And Editing Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Model Notes - Editing The Model Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Mass Update - Mass Updating Model Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Property Tables - Editing Look-Up Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Facility Settings - Display/Edit Facility Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Analysis - Calculating Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Solve Single Model - Solving A Single Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Calculate Gas Properties - Calculating Gas Properties . . . . . . . . . . . . . . . . . . . . . . . . . GASCalc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Report - Viewing And Printing Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Standard (All) - Reporting Model Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Standard (Select) - (Submenu) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Customer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Header . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Node . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Pipe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Summary - Creating A Summary Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Connectivity - Creating A Connectivity Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Property Tables - Reporting Look-Up Table Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . Data Check - Finding & Reporting Data Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Solution Log - Viewing A Solution Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Set Report Options - Setting Report Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Graphics - Accessing The Graphic Data Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . View/Edit - Viewing & Editing Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Settings - Changing Graphic Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Background Settings - Set A Background Image . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Save Display As BMP - Saving The Displayed Image . . . . . . . . . . . . . . . . . . . . . . . . . Save Display To Clipboard - Copying The Displayed Image . . . . . . . . . . . . . . . . . . . . Utilities - Using The Utility Routines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Set Defaults - Setting Default Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Customer (Submenu) - Customer Data Routines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Attribute File - Setting An Attribute File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Update External Loads - Assign And Update Node Loads . . . . . . . . . . . . . . . Execute SQL Statement - Update Attribute Values . . . . . . . . . . . . . . . . . . . . . Pipe (Submenu) - Pipe Data Routines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Attribute File - Setting An Attribute File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Execute SQL Statement - Update Attribute Values . . . . . . . . . . . . . . . . . . . . . Import/Export - Importing And Exporting Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Data Check - Checking Model Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Miscellaneous (Submenu) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Check Connectivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Bradley B. Bean, PE

ENGINEERING & SOFTW ARE

vi

GASWorkS 9.0

Table of Contents57 58 58 59 59 59 59 60 60 61 61 61 61 62 62 63

Renumber Nodes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Calculate XYs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Sort Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Window - Window (Screen) Access Utilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Arrange Icons - Arranging Icons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Arrange Windows - Arranging Open Screens . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Windows List - Accessing Open Screens . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Help - Using The On-Line Help Routines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Contents - Accessing The Help Topics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Using Help - Instructions For Using Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Technical Support (Submenu) - How To Reach Us . . . . . . . . . . . . . . . . . . . . . . . . . . . Contact Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Request Registration Number . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Send Help Request . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . View Demonstration Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Menu Map . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

DATA SCREENS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67 Bundle Specification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70 Connectivity Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72 Customer Data Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74 Data Check . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78 Data Check Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85 Default Data Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87 Facility Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93 File Selection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96 Find Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99 Gas Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100 Header Data Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103 Mass Update . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105 Model Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108 Node Data Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110 Path Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114 Pipe Data Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116 Preference Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120 Project Specification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122 Property Table Selection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125 Print Control - (long form) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127 Print Control - (short form) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130 Query Specification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132 Renumbering Specification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135 Report Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136 Solution Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140 Solution Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148 Solution Log Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150

Bradley B. Bean, PE

ENGINEERING & SOFTW ARE

vii

GASWorkS 9.0

Table of Contents

Summary Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152 Summary Report Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154 XY Calculation Specification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158 GRAPHIC DATA INTERFACE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GDI Window Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GDI Toolbars . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GDI Commands & Icon Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Mouse Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Key Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Entering Coordinates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Attribute Valve Data Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Background Image Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Bitmap Scale Factor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Color Legend . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Customer Data Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Graphic Line Data Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Graphic Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Graphic Symbol Data Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Multiple Edit Specification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Node Data Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Pipe Data Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Plot Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Set Display Colors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Set Text Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Shift Specification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Text Data Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Tool Palette Edit Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Trace Specification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Trace Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Trace & Update Specification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . PROPERTY TABLES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Using Property Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Property Table Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Compressor Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Fitting Property Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Pipe Property Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Regulator Property Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Valve Property Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Well Property Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161 164 167 168 212 213 214 216 217 223 225 226 231 233 238 240 243 250 262 267 271 273 275 277 279 282 284 287 289 290 294 297 299 302 305 308

Bradley B. Bean, PE

ENGINEERING & SOFTW ARE

viii

GASWorkS 9.0

Table of Contents313 315 319 322

ATTRIBUTE DATA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Attaching A Customer Attribute File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Attaching A Pipe Attribute File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Using SQL To Update Attribute Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

IMPORT & EXPORT ROUTINES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325 Import/Export Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329 Import/Export File Selection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331 IMPORT ROUTINES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Importing Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Importing Column Format ASCII Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Importing Delimited Format ASCII Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Importing Customer X-Y Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Importing dBASE Format Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Importing DXF Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Importing Shape Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Importing Node X-Y Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Importing Stoner PD & XY Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Importing XLS Format Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . EXPORT ROUTINES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Exporting Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Exporting ASCII Customer Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Exporting ASCII Node Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Exporting ASCII Pipe Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Exporting dBASE Customer Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Exporting dBASE Node Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Exporting dBASE Pipe Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Exporting DXF Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Exporting GASWorkS 7.0 Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Exporting Microsoft Access Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Exporting Microsoft Excel Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Exporting Node X-Y Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Exporting Stoner Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Exporting Shape Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . MISCELLANEOUS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Using Non-Pipe Elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Using The Pipe Sizing (Optimization) Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Using The Query Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Using Attribute Valves . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Using Diversified Customer Loads . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Convergence Problems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Using A Command Alias File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333 335 336 339 342 344 346 353 355 355 355 357 359 359 361 364 368 370 373 376 380 380 380 381 381 381 383 385 388 392 394 395 397 398

Bradley B. Bean, PE

ENGINEERING & SOFTW ARE

ix

GASWorkS 9.0

Table of Contents

Program Limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 399 How To Reach Us . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401 APPENDIX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Network Primer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GASWorkS Data Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Supported Dimensional Units . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Standard GASWorkS Units . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Pipe Flow Equations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Regulator Flow Equations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Valve Flow Equations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Compressor Power Equations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Well Equation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Support Equations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Compressibility Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Temperature Calculations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GASWorkS Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Standard Look-Up Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 403 405 419 424 427 428 444 447 451 453 454 458 460 464 467

GLOSSARY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 489 INDEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 495

Bradley B. Bean, PE

ENGINEERING & SOFTW ARE

x

GASWorkS 9.0

Getting Started

GETTING STARTED

Bradley B. Bean, PE

ENGINEERING & SOFTW ARE

1

GASWorkS 9.0

Getting Started

Bradley B. Bean, PE

ENGINEERING & SOFTW ARE

GASWorkS 9.0

Getting Started

Use the procedures outlined in this section to install GASWorkS and begin using it to model your gas system. If you are a new User, working the example model contained in the Demonstration Guide will provide instructions and examples of using the basic features of the GASWorkS software. If you are a current User, you might browse the Release Notes section to review the new features contained in this version of the software. In addition to the example included with this manual, the On-Line Help system contains many other examples and how-to tips (the Building Your First Model example is a good topic to start with). A list of the commands available in the Graphic Data Interface is provided in that section of this manual. The Menu descriptions section of this manual provides some abbreviated instructions on accessing and using many of the routines found in the software. GASWorkS is suitable for modeling a variety of distribution, gathering, transmission, and plant piping systems containing most any compressible, single phase fluid. Many of the examples used in its documentation refer to distribution type systems. However, please consider that the methods required to create and solve these examples, are exactly the same as those required to create and solve a model of any type of system. If you encounter problems, or have specific questions, refer to the appropriate section in the manual for detailed instructions, descriptions, and explanations. Or, use the On-Line Help topics to view examples and how-to tips on performing a specific task. Feel free to contact us with your questions.

Installation...To install the GASWorkS software... From A CD: If the software was received on a CD... ! An appropriate version of Windows must be running to install GASWorkS, if it is not, start Windows now. ! Place the CD in the appropriate disk drive. The installation program may or may not automatically start. ! To manually start the installation program, select the Start button on the Windows Task Bar. Select the Run item from the Start menu list. Type the letter corresponding to the drive containing the GASWorkS CD, followed by the word setup, then press the ENTER (5) key. For example, type d:setup, then press the ENTER (5) key. Follow the instructions in the General Installation Instructions topic to continue the installation.

Bradley B. Bean, PE

ENGINEERING & SOFTW ARE

3

GASWorkS 9.0

Getting Started

From An Electronically Received File: If the software was received electronically (email or download)... ! Download or copy the file to a temporary directory on the machine where GASWorkS is to be installed. ! If a faux extension is present (.txt or .ok) remove the extension. ! After removing the faux extension, double click on the setup filename. Follow the instructions in the General Installation Instructions topic to continue the installation.

General Installation Instructions: ! After the installation program has been started, several screens will appear during the setup process. Read the contents of each screen and respond appropriately. ! The Welcome screen will appear first. Read the contents of the screen carefully, then select Next to continue with the installation or select Cancel to cancel the setup process. ! The Licensing screen will appear next. Read the terms of the License carefully, then select Agree to continue with the installation or select Disagree to cancel the setup process. ! The Documentation screen will appear next. If you would like to install a copy of the Demonstration Guide and Users Manual select Yes. Otherwise respond No. If the documentation is installed it can be viewed from the GASWorkS Help menu. ! The Location screen will appear next. If you would like to install GASWorkS in a different directory, enter or select a different destination directory. Select Next to continue with the installation or select Cancel to cancel the setup process. ! The Program Group screen will appear next. Select Continue to proceed, or change the program group and then select Continue to continue installing, or select Cancel to end the installation. ! Various warnings and messages may appear during the installation process. When a warning or message appears, read the message carefully, then select the appropriate option to either continue or terminate the installation process. ! A message will appear when the installation process is complete. The message will indicate whether the installation succeeded or failed - select the appropriate option to clear the message. Upon successful installation, a "GASWorkS" program item will be created in the Start-Programs menu list. Select the GASWorkS 9.0 item to execute the GASWorkS software.

Bradley B. Bean, PE

ENGINEERING & SOFTW ARE

4

GASWorkS 9.0

Getting Started

Software Copy Protection...GASWorkS uses several means of software copy protection. We understand that this may be offensive to some Users, however it is essential to ensuring the commercial viability of GASWorkS. One of the following methods may be used to protect the installed version of the GASWorkS.

Parallel (Printer) Port Hardware Key: If a Parallel port hardware key is provided, place the key in an available parallel (printer) port. Insert the key so that the end marked "COMPUTER" is connected to the computer's printer port. If a printer or other device is attached, the key should be placed between the computer, and the printer cable or device. Note... When installing on a Windows NT based operating system (NT/XP/2000) additional installation steps are required. See the readkey.txt file found on the GASWorkS distribution CD for additional instructions.

USB Port Hardware Key: If a USB port hardware key is provided, additional installation steps are required. See the readkey.txt file located on the GASWorkS distribution CD for additional instructions. Once the software for the key has been installed place the key in an available USB port. When using hardware key (Printer or USB port) protection, GASWorkS may be installed on multiple machines and the hardware key may be shared. However GASWorkS can only be used to solve a model on the machine where the hardware key is installed. Only edit and view functions are available on the machines which do not contain the key.

Registration: Some versions of GASWorkS are required to be registered to allow access to its complete set of functions. If the installed version of GASWorkS requires registration, a serial number will be displayed the first time GASWorkS is executed. If this message appears select the Request Registration Number command button. An email format request form will appear, complete the appropriate information and send the email to request the required number. The number will be provided at our first convenience.

Bradley B. Bean, PE

ENGINEERING & SOFTW ARE

5

GASWorkS 9.0

Getting Started

If you do not wish to request the number or if you want to access GASWorkS before you receive your registration number, select the Continue command button to open GASWorkS in limited non-solution mode. When using registration protection, GASWorkS may be installed on multiple machines, however it can only be used to solve a model on the machine that has been registered. Only edit and view functions are available on the machines which are not registered.

Execution...To execute the GASWorkS software... ! An appropriate version of Windows must be running before GASWorkS may be executed. If Windows is not running, begin its execution now. ! Select the Start button from the Windows Task Bar. Move the mouse pointer to the Programs item. The Programs menu list will appear. ! Once the Program list is displayed. Select the GASWorkS program group from the list. Select the GASWorkS 9.0 program item from the group list. ! The GASWorkS software will be started. After the software has been loaded into memory, the GASWorkS Copyright Notice will appear click the Continue button or press the ENTER (5) key to continue. ! After clearing the notice, depending on certain preference settings, a blank screen may appear, or the Graphic Data Interface screen may appear. In either case choose the desired option from the pull-down menus, GDI command list or toolbars - or select the Exit item from the Files menu list to quit the program.

Uninstalling GASWorkS...To uninstall (remove) the GASWorkS software... ! An appropriate version of Windows must be running before GASWorkS may be uninstalled. If Windows is not running, begin its execution now. ! Select the Start button from the Windows Task Bar. ! Select the Settings item from the Start-up list. Then select the Control Panel item from the Settings list.Bradley B. Bean, PE ENGINEERING & SOFTW ARE

6

GASWorkS 9.0

Getting Started

The contents of the Control Panel folder will be displayed. ! Click on the Add/Remove Programs icon. The Add/Remove Programs Properties screen will appear. ! Select the GASWorkS 9.0 item from the program list. Select the Add/Remove command button to proceed with the removal. Several prompts will appear throughout the removal process, read the messages carefully and respond appropriately. A message will appear when the removal process is complete. The message will indicate whether the removal succeeded or failed. ! When done, select the OK command button to close the Add/Remove Program Properties screen. When GASWorkS is installed, it creates various subdirectories directly under the main GASWorkS application directory (for example \Program Files\GASWorkS 9\Files). These directories are used to containing a variety of GASWorkS property, initialization, and model files. If new files have been added to any of these directories, or any of the original files have been modified since installation (which is almost always the case) the uninstall routine will not be able to remove the affected directory. If this occurs, the directory and its contents can be manually removed using the Windows Explorer program.

Using GASWorkS...GASWorkS 9.0 is designed to be easy and intuitive to use. However, there are a few general concepts that need to be learned before becoming proficient with the software. There are two ways to get started with GASWorkS. One, the General section found later in this manual provides an introduction to many of the basic concepts required to use GASWorkS. Review this section to obtain general information needed to use the software. Once the general concepts have been learned, use the On-Line Help system to review the numerous examples and how-to tips for instructions on performing the various tasks required to create, solve, report, and edit a model of your piping system. The other method is to work the example contained in the Demonstration Guide provided with this manul. The guide will introduce the basic concepts required to create, solve, report, and edit a simple example model. If time is short, we suggest that you start with the Demonstration Guide - then review the contents of the manual when time is available.

Bradley B. Bean, PE

ENGINEERING & SOFTW ARE

7

GASWorkS 9.0

Getting Started

Release Notes...GASWorkS 9.0 represents a continued evolution of the GASWorkS software - however, as with all evolutionary processes, things change. In this revision, the most noticeable change will be in the way that the data is managed. The previous versions of GASWorkS used a database style management system - open a data table, retrieve a record from the table, make a change, replace the record into the table. With this method the data is continuously saved to disk storage. GASWorkS 9.0 uses an open, edit, save method of file management, similar to the methods used in spreadsheet and wordprocessor applications. With this method the model files are opened and loaded into memory. When changes are made they are only saved to the data in memory, not the data in disk storage. When the work session is complete, the User may chose to save the data changes or discard them. Remember to save your changes. Numerous other changes were made, additional commands and functions were added and inevitably some features were discontinued. A partial summary of the many feature changes is provided in the following tables. Data Management The most noticeable change to existing Users will be how the data files are managed. Good or bad GASWorkS now uses the open, edit, save management scheme for handling its data files. Other data management changes include... Support for facility identification is provided. Pipes and associated customers can be grouped by facility type, similar to layers in a CAD application. Individual facilities can be set to be reported, solved, displayed - or set to active to allow or disallow editing. The User can revise the facility list. Customers- A Link ID data item was added to enhance sharing of data with other applications. A unit count item was added to allow a single customer feature to more easily represent multiple physical customers. Support is now provided for branch customers. This allows one customer to feed from another customer. Multi-segment service lines are now supported. For our UK customers, individual diversity handling is now supported. Pipes- A Link ID data item was added to enhance sharing of data with other applications. An external database can now be attached to the pipe features in the model. A Facility Type data item has been added. Fittings (valves, elbows and tees) can be attached directly to a pipe segment. The equivalent length is automatically computed and used during calculation. Nodes - Separate control for application of the Design Factor and status for base and external loads was added. Long node names - up to 40 characters - are now supported. Property Tables- The various property tables (pipe, valve, regulator, compressor, well, fitting) are accessed using an improved spreadsheet style interface. Now has the Ability to save and retrieve specific tables. Now has the ability to setup color and linetype specifications for individual pipe sizes and types. Pipe sizes to include during pipe sizing (optimization) can now be more easily identified. See the PropertyBradley B. Bean, PE ENGINEERING & SOFTW ARE

8

GASWorkS 9.0

Getting StartedData Management

Tables section for notes on using old look-up tables. File Handling- GASWorkS 7.0 files are automatically imported when opened. A graphic preview of the model is displayed in the file selection form. Implementation of open, edit, save style file handling. Automatic save at User specified time intervals is supported. Linked Database - A linked database feature has been added to replace the GASBase database. Pipe and customer model data can be complimented by the use of linked database. The linked database is automatically managed by GASWorkS - as model features are added or deleted, the associated (linked) database feature is also updated. The fields in the linked database can be specified by the User based on a seed file. The contents of the linked database can be manipulated using Standard Query Language (SQL) manipulation commands. Undo - An undo feature has been added to allow restoration of previous data or graphic changes. The undo feature can be turned on or off by the User. The oops (undelete) routine has been expanded to include Customer, User Graphic, and User Text features. Deleted files are now automatically sent the Windows Recycle Bin instead of being permanently deleted.

Customer Load Manipulation Customer feature data. A multiple unit field has been added - a single customer feature can be used to represent multiple customers (units). A link identification field has been added to allow enhanced connection between the GASWorkS data model and an external database. Diversity- For Users of the IGE diversity calculations, heating/construction type and annual usage can now be set for each individual customer. Calculation in looped systems is now supported.

Graphic Data Interface The graphical data interface was enhanced by the addition of many new commands and features. Listed here in no particular order, the new features include: One click access to the pipe, node, and customer data. To access pipe data, click the left mouse button on a pipe feature. To access node data, SHIFT-click the left mouse button on a node feature. To access customer data, CTRL-click the left mouse button on a customer feature. Multi-segment service lines are supported. Customer features may have polyline type service lines. The main tap location can be specified by the User.

Bradley B. Bean, PE

ENGINEERING & SOFTW ARE

9

GASWorkS 9.0

Getting StartedGraphic Data Interface

Support for User graphic lines and symbols is now provided. Graphic (non-model) lines and symbols can be included in the model graphics. Graphics are added by drawing or inserting the feature at User specified locations. A new GDI toolbar has been added to allow management of the Graphic features. Automatic assignment of supply main on customer entry. A command is provided for one click entry of customer features - select a the customer location - the customer is automatically assigned to the nearest main. Automated insertion and addition of regulator, compressor, and valve elements. A set of commands has been added which allows the addition and insertion of non- pipe elements. The insertion routine automatically updates pipe lengths when the device is inserted into an existing segment. Enhanced command list. The command list includes the traditional alphabetic listing and a new grouped listing. The grouped listing groups commands by type in toolboxes for example the add commands are grouped in one toolbox, the edit commands in another, etc. The lists have been expanded to included all of the new and existing commands. Plot preview. The plot image is displayed in a preview window before it is sent to plotter/printer when plotting. Plot to User specified scale. Plots may be made to fit the specified page size, or to a User specified scale. Enhanced arc handling. Arcs can now be adjusted after they have been entered. Pipe ends for arc type pipes can be moved. Additional symbol and line styles. New node symbols and line styles have been added. Non-continuous line styles can be used with all line widths. Improved flow arrow handling - style, size and display selection. Flow arrows can be displayed as the traditional arrow heads or as chevrons at mid-section. Automated header tap on lateral pipe entry. Using a CTRL-click selection at the From Node and To Node prompt will automatically tap the pipe near the selected location. Double the number of customer edit and entry commands. Numerous other commands have been added for editing and entering customer data. The Customer toolbar is now two-tiered. Calculation of pressure drop between graphically selected points. The pressure drop between a pair of selected node points can be displayed based on a User selection. Automated calculation of efficiency based on calibration values. The efficiency of the pipes along a route between two User selected points can be automatically computed based on User specified calibration values.

Bradley B. Bean, PE

ENGINEERING & SOFTW ARE

10

GASWorkS 9.0

Getting StartedGraphic Data Interface

Calculation of item statistics for graphically selected data features. A summary of various data values can be displayed based on a User selected set of features. Extract, copy, and move pipe, node, and customer features based on a graphically identified selection set. A portion of a system can be extracted from a model, based on a User specified set of features. Associated pipes, nodes, and customers are included in the extraction and deletion routines. Match hydraulic and graphic properties. The properties of a selected feature can be applied to other user selected features. Multi-segment measurement tool. Distance along a multi-segment route can be measured using the new tool. Support of branch customers. A grouping of trunk and branch customers can be created, allowing one customer to be supplied from another. Save and retrieve graphical views. A graphic view can be saved, then retrieved at a later time. Multiple view tab (panels) are provided. The GDI supports three separate panels, each with the ability to display a different view of the model. Multiple previous and next zooms. Each GDI panel allows up to ten views to be saved and accessed using the Previous and Next zoom commands. Trace and update data values along a trace route. Pipe, node, and customer values can be changed along a trace route. Set hydraulic symbols independent of pipe length. Pipe symbol size for compressors, regulators, valves and wells can be set independent of the actual element graphical length. Save display to Windows Clipboard. The GDI display can be saved to the Windows clipboard and pasted into supporting applications. Calculate XYs from latitude and longitude. Approximate planar coordinates can be calculated from geographic coordinates. Automatically set text display limit. The text display limit can be set to the current view by simply double clicking the display limit data box. Entry of pipe by length and User drawn angle. In addition to the previous entry methods, a pipe segment can be entered by entering a desired length, then graphical selecting the desired angle. Display pipe length during manual graphic entry. The pipe length can optionally be displayed during entry. Automatically reset colors - useful after traces and queries. Automatically find and delete zero length pipes - useful for data imported from CAD & GIS sources.

Bradley B. Bean, PE

ENGINEERING & SOFTW ARE

11

GASWorkS 9.0

Getting StartedGraphic Data Interface

Pipe color and linetype can be set using values contained in the Pipe Properties table, based on size and type values, or based on facility type. Improved background handling including: Support for blocks in DXF backgrounds. Ability to set scale and origin shift when attaching a DXF background. Turn display of individual background image off without unattaching the image. Support for Shape file background images is now supported. Support for typed commands. Support is now provided for manual entry of typed commands. This may seem like a step backwards, but often it is quicker to type a command than to find and select it from the command list. Full or abbreviated commands may be entered, and the User may create a command alias list to use their known name for the GDI commands. A routine to automatically identify and tap unbroken intersections has been added. This is especially useful for cleaning up imported CAD and GIS data. Overall improvement of display speed. Right clicking the mouse while working in GDI, displays a pop-up menu allowing a command to be repeated, the display to be panned or zoomed, or a feature edit command to be executed.

Solution Routine Capacity- Support for increased model capacity - the solution, reports, and graphical display have been tested and verified with models up to 250,000 nodes in size. Optimization- A more robust pipe sizing routine now produces more accurate and consistent optimal pipe size sets. Ability to set limit pressures at multiple condition nodes. A maximum velocity limit may be imposed. The pipe table to use for new size selection can be specified independent of the model pipe table. Flow Equations- Support for several additional pipe flow equations was added, including additional versions of the AGA partially and fully turbulent equation, and the high and low pressure versions of the IMC (Polyflo) equations. Diversity- For Users of the IGE diversity calculations, heating/construction type and annual usage can now be set for each individual customer. Calculation in looped systems is now supported.

Bradley B. Bean, PE

ENGINEERING & SOFTW ARE

12

GASWorkS 9.0

Getting StartedReports

The various report features have been enhanced in a number of ways - which include: Standard Reports- Enhanced in-report data editing. Enhanced query routine allows a query specification to be saved and retrieved. Improved print handling especially for wide reports. Inclusion of customer model and attribute data. Inclusion of pipe attribute data. Automatic sort by node name or id number. Ability to delete a feature from the report. Graphically find a feature from a record selected in a report. Summary Report - Addition of a numerous items to the system summary option. The report is displayed in a User revisable text window. Selected contents can be copied, cut, and pasted into other applications. Data Check - Additional items and options have been added to the check routines. The report is displayed in a User revisable text window. Selected contents can be copied, cut, and pasted into other applications. Exclusion Report - Additional items and options have been added to the check routines. The report is displayed in a User revisable text window. Selected contents can be copied, cut, and pasted into other applications.

Other Features Mass Update- Expanded item support including assignment and query of graphical properties. The ability to save and retrieve query specifications was added. DXF Import- Now allows assignment of multiple pipe layers. Specification of arc resolution. Specification of length and coordinate units, and origin shift - allowing automatic scale and shift during import. Import of pipe, valve, customer, and User text features has been incorporated into a single routine. The ability to save and retrieve an import specification was added. Utilities - An automated node reduction routine was added. This routine is especially useful when working with CAD and GIS data that needs a bit of massaging/cleanup after importing. A routine has been added to create a graphical model from a non-graphical model. Quick Export - A set of quick export routines have been added to allow the export of data associated with the current model to be exported to number of formats with a single click. All pipe, node, and customer data is included in the export. Supported formats include, Microsoft Access database, Microsoft Excel workbook spreadsheets, ESRI Shape file, GASWorkS 7.0, dBASE and ASCII text files.

Bradley B. Bean, PE

ENGINEERING & SOFTW ARE

13

GASWorkS 9.0

Getting StartedDiscontinued Features

Several features have been discontinued from the current GASWorkS release. Their exclusion was based on their perceived usefulness with respect to the latest software functionality. These features include... Model Edit Data Form - The fill in the blanks style model edit data form is no longer supported. This routine was most useful for creating no graphical models. Non-graphical models are no longer supported. Relate Features - The ability to relate separate models together has been discontinued. The main purpose of the relate feature was to help manage large models. GASWorkS now supports large models in both its report and analysis features, combined with the newly added Facility feature, combined models can now be efficiently managed. GASBase - The predefined customer and pipe attribute database included in previous version of GASWorkS has been discontinued. Similar, and more robust features are provided by the new Linked database feature. When a GASWorkS 7.0 model with an associated GASBase database is imported, the GASBase database is converted to a Linked database. All of the data will be retained, however some of the automated load manipulation functionality of GASBase will be lost. Import/Export - Some import and export routines have been discontinued including the GasTool and Data Dump formats, and some old versions of GASWorkS. If conversion from these formats is required, we can process them for you.

We hope that you will be pleased with the many improvements and enhancements we have made to GASWorkS. Please let us know if you have any comments, concerns, or questions regarding our latest release...

Bradley B. Bean, PE

ENGINEERING & SOFTW ARE

14

GASWorkS 9.0

General Information

GENERAL INFORMATION

Bradley B. Bean, PE

ENGINEERING & SOFTW ARE

15

GASWorkS 9.0

General Information

Bradley B. Bean, PE

ENGINEERING & SOFTW ARE

GASWorkS 9.0

General Information

Hardware Requirements...GASWorkS will operate on any computer configured to run Windows 98, 2000, ME, NT 4.0, or XP. The machine must be equipped with a Compact Disk (CD) drive, and at least one parallel printer port (if hardware key provided). The following optional equipment is also recommended: Item Processor Installed RAM Available Hard Disk Capacity Monitor Mouse Printer Port Printer Plotter Digitizing Tablet Minimum Requirements Any class of Pentium 128 Minimum Program Only - 10 Mbyte Data - .35 Mbytes per 1000 nodes and .8 Mbytes per 10000 customer records. VGA-16 Color, 640x480 Microsoft compatible two or three button mouse. One parallel None None Node Any Windows compatible laser printer 300 dpi or better Any Windows compatible color raster plotting/printing device Any WinTab compatible device VGA-256 color, 800x600 or better Recommended Options Highest available Pentium Maximum available on machine

Software Requirements...GASWorkS requires the installation of the Windows 98, 2000, ME, NT 4.0, or XP operating system to be functional.

Bradley B. Bean, PE

ENGINEERING & SOFTW ARE

17

GASWorkS 9.0

General Information

GASWorkS Data Elements...GASWorkS uses an intuitive set of data elements to represent the piping systems that it models. The basic elements of its data structure are nodes, pipes, and customer data. Nodes represent the connections, intersections, and terminations of pipes. Nodes are the points where flow is introduced into the system (supplies) or taken out of the system (demands). Nodes can also used to represent customer connections and to assign customer loads. Customer features provide an efficient and intuitive way of representing customer locations and demands. Pipes connect the nodes and carry flow between them. Flow can be thought of as going into or out of nodes. However, flow only goes through pipes. GASWorkS supports various types of pipe elements - Line Pipe, Regulators, Valves, Fittings, Compressors, and Wells. Both hydraulic and attribute pipe data may be maintained. The hydraulic pipe data represents the items which affect the flow and pressure drop through the pipes. For example, pipe diameter, length, connectivity, etc. The attribute data represents items which do not affect the flow or pressure drop through the pipes. The customer data contains information about the location and demand of the customers associated with a model. The customer data can be divided into two types of information - model data which describes the customers location, the supply main identity, the load application details, and the total customer load - and a second type of information called attribute information, which can contain a variety of non-model data associated with the customer. All of the model files are accessed by way of a single key file known as the Header file. This file contains some general information about the model and the solution control parameters and serves as the access point for all of the other files. A variety of other data are also used to support GASWorkS and its various routines. These include gas properties, attribute valves, User text, and background images. Each is described in detail in various sections of the GASWorkS documentation.

Bradley B. Bean, PE

ENGINEERING & SOFTW ARE

18

GASWorkS 9.0

General Information

Menu Structure...The GASWorkS routines are accessed through pulldown menus and dialog boxes. The menus are grouped under headings by functionality. The menu headings are displayed near the top of the main GASWorkS screen.

Menu Access...Menu items are accessed by selecting an item from a menu list. The menu lists are activated by selecting the appropriate menu heading. Menu headings and menu items may be selected by one of the following methods: ! Position the mouse pointer over the desired heading or item, then press the left most mouse button. This is referred to as clicking on the item. ! Or, use the TAB or Arrow keys to position the cursor on the desired menu heading or menu item, then press the ENTER (5) key. ! Or, hold down the ALT key while pressing the key corresponding to the underlined letter of the desired heading or item. A menu list may be deactivated by pressing the Escape (ESC) key or selecting another menu heading. Some menu items have submenus associated with them, these are accessed through submenu headers. Submenu headers are followed by ... and a right arrow symbol. Rest or click the mouse on the header title to access the submenu. Multiple submenus may exist.

Command Execution...Many dialog boxes and data screens contain controls known as Command Buttons. Command buttons may be used to quickly access a specific function. The function associated with a command button is executed when the button is selected. The OK button found on many of the message boxes displayed by GASWorkS, is an example of a command button. Command buttons may be selected by one of the following methods: ! Position the mouse pointer over the desired command button, then press the left mouse button. This is referred to as clicking on the button.

Bradley B. Bean, PE

ENGINEERING & SOFTW ARE

19

GASWorkS 9.0

General Information

! Or, use the TAB keys to highlight the desired command button, then press the ENTER (5) key. ! Or, hold down the ALT key while pressing the key corresponding to the underlined letter in the caption of the desired command button.

Negotiating Data Screens...GASWorkS provides numerous data screens for entering, editing, viewing, and managing the data it requires. Generally, a data screen will contain fields for entering individual data values, data lists for selecting predefined data, option buttons and check boxes for selecting options, and command icons and command buttons for executing commands. The TAB keys or mouse can be used to move between the various controls contained on all screens. On certain screens, some items are supported by data lists. Dimensional units are an example of an item associated with a list. To activate a data list - click on the arrow symbol next to the right side of the data field, then select the desired item from the list by clicking on the item. Or, press an Arrow key while the cursor is in the desired field to change the selected value. Or, press the character corresponding to the first letter of the item description.

Where check boxes are used, a check mark (U)will appear in the box when the item is selected. The status of a check box may be changed by clicking in the box, or by pressing the Space Bar while the cursor is in the box. Where option buttons are used, a dot "!" will appear inside the option circle when the item is selected. Option buttons are found in groups. Only one option may be chosen at a time. To change the status of an option button - click on the desired button, or use the TAB keys to move between options. When the cursor is located on the desired option, press the ENTER (5) key. In addition to using command buttons to execute commands, some screens also use icons to access their commands. An icon is a small image which represents the task that the command performs. Icons can only be selected using the mouse. To select an icon and execute its command, click on the icon by placing the mouse pointer over the icon image, then press the left mouse button. The printer symbol found on many report screens, is an example of an icon. Data fields or list values highlighted with a yellow background represent calculated data values, and in general, can not be directly edited by the User - these values change when the one of the editable values are changed and a solution is successfully executed.

Bradley B. Bean, PE

ENGINEERING & SOFTW ARE

20

GASWorkS 9.0

General Information

When entering numbers in a data field, do not include the digit grouping identifier (thousands identifier). For example, enter ten thousand as 10000" not as 10,000" (or 10.000" if a dot is used as the digit grouping identifier). The GASWorkS Graphics Data Interface (GDI) provides a unique set of access methods, refer to the Graphic Data Interface section for specific notes and instructions on its use.

Accessing Files...A common file dialog box is used by all GASWorkS routines to enter required file names. The dialog box allows the drive, directory, and name of the desired file to be selected or entered. To select a drive: ! Move to the Drives list using the TAB keys or the mouse. ! Change the selected drive by pressing the key corresponding to the desired drive letter, by pressing the Up or Down Arrow keys to change the selected drive, or by clicking the arrow symbol next to the drives data list and then selecting the desired drive.

To select a directory: ! Move to the Directories list using the TAB keys or the mouse. ! Change the selected directory by pressing the key corresponding to the first letter of the desired directory (until the correct directory is selected), by pressing the Up or Down Arrow keys to change the selected directory, or by clicking the arrow symbols or adjusting the scroll bar next to the list to select the desired directory. Double click on a directory to display its contents.

To select a file: ! Move to the Files list using the TAB keys or the mouse. ! Change the selected file by pressing the key corresponding to the first letter of the desired file (until the correct file is selected), by pressing the Up or Down Arrow keys to change the selected file, or by clicking the arrow symbols or adjusting the scroll bar next to the list to select the desired file.

Bradley B. Bean, PE

ENGINEERING & SOFTW ARE

21

GASWorkS 9.0

General Information

To manually enter a file name: ! Move to the Filename data field using the TAB keys or the mouse. ! Type the desired drive, path (directory), file name, and extension in the file name data field. GASWorkS model files are managed through their associated header file. The header file uses an .hdr extension, consequently the ".hdr" extension must be included when manually entering a model's header file name.

To select a recently opened file: ! Move to the Filename data field using the TAB keys or the mouse. ! Select the desired file by clicking on the arrow symbol adjacent to the data field. Then click on the name of the desired file using the mouse.

After the desired file name has been entered or selected - click the Continue command button to proceed. To leave the File Selection dialog box and terminate the function that invoked the dialog - click the Cancel command button. Note: Each time GASWorkS starts, it automatically opens the last model file that was worked on. This feature can be disabled by closing the model before leaving GASWorkS.

Accessing On-Line Help...GASWorkS has an extensive On-Line Help system. The topics contained in the help system provide numerous examples and how-to tips. To access the help system, select the Contents item from the Help menu list. The Contents screen will appear, select the Index tab to display a listing of the topic subjects contained in the help system. Select an item from the index list to view the associated topic documentation. If you are not familiar with using On-Line Help systems, select the Using Help item from the Help menu list for a complete description on how to use the On-Line Help system. If you cant find what you need in the help system, or in the manual, or just dont want to look for it - call, fax, or e-mail us for help. Our contact information is: Toll-free Telephone: 800-391-9391 (US Only) Telephone: 719-578-9391 Fax: 719-578-9394 e-mail: [email protected]

Bradley B. Bean, PE

ENGINEERING & SOFTW ARE

22

GASWorkS 9.0

General Information

Notes For International Users...By default GASWorkS initially starts up using US units of measure. Please dont let this discourage you, GASWorkS supports a wide range of dimensional units which can surely meet your needs. You can set the appropriate values by considering the following instructions. To change the default units to be used when creating new models, select the Default Values item from the Utilities menu list. The Default Values screen will be displayed. Select the Dimensional Units tab, the contents of the tab will be displayed. On the Dimensional Units tab select the desired unit settings. After the settings have been made, select the Apply Displayed Values command button to change the values in the currently open model, or select the Save Settings command button to save the current settings for future use. The values contained in the standard Property tables are entered using US units of measure. These values will automatically be converted to the proper units when used with pipe elements possessing another set of units. For example, diameter values contained in the Pipe Properties table that are entered in Inches, will be converted to the equivalent size in millimeters if a pipe segments diameter units are set to Millimeters, when required by a report or display routine. When new items are added to the Property tables, their dimensional units can be set to any desired unit. Note: The example models provided with GASWorkS all use US units of measure. To obtain valid results, these examples must be worked using the US units. When working these examples, the default data values and coordinate units must be set to their original US values. GASWorkS can accommodate either a comma (,) or a dot (.) as the decimal identifier - or a comma (,) or a dot (.) as the digit grouping identifier depending on the associated Windows setting. For example, one thousand ten can be displayed as 10,000.10" or as 10.000,10" depending on the Windows setting.

Bradley B. Bean, PE

ENGINEERING & SOFTW ARE

23

GASWorkS 9.0

General Information

Bradley B. Bean, PE

ENGINEERING & SOFTW ARE

24

GASWorkS 9.0

Menu Items

MENU ITEMS

Bradley B. Bean, PE

ENGINEERING & SOFTW ARE

25

GASWorkS 9.0

Menu Items

Bradley B. Bean, PE

ENGINEERING & SOFTW ARE

GASWorkS 9.0

Menu Items

This section provides a general reference for using the GASWorkS menu items. Grouped by functional topic, procedures are described for using each of the items available in the GASWorkS menu lists. Most of the menu items will launch a data screen or dialog box. Further information describing the use of the data screens and dialog boxes is provided in following sections of this manual. Some menu items have submenus associated with them, and are accessed through submenu headers. Submenu headers are followed by ... and a right arrow symbol. Rest or click the mouse pointer on the header title to access the submenu. Multiple submenus may exist. Certain menu items will be displayed if a model is not open.

File - File Management...The GASWorkS model file management routines are grouped under the File menu heading. The routines located under this heading are used to manage the model files only. That is, these routines manipulate the files directly associated with a model. The contents and use of each of the GASWorkS files are described in the Appendix of this manual. Access to the GASWorkS support files, such as the Property Tables, is handled by the individual routines that access or manipulate those specific files. Management routines such as copying and deleting the support files must be performed manually by the User. A GASWorkS model consists of a number of files each possessing the same name but varying extensions. Some of the files represent the header, pipe, node, and customer data associated with each model, others represent support, or other data files. A full list of the specific file extensions is contained in the Appendix. GASWorkS manages the model files based on the name of the header file. When prompting for a model name, GASWorkS expects the ".hdr" extension of the header file to be present. Be sure to include the ".hdr" extension when manually entering a model name. Only one model may be open at a time. The name of the currently opened model is displayed near the top of the GASWorkS interface screen. Certain menu items and commands will prompt for a file name if a function which affects a model file is executed, and a model has not already been opened. Once a model has been opened, execution of subsequent model related routines will apply to the open model. The routines found in the File menu list are described on the following pages...

New - Create A New Model...The New menu item creates a new set of model files. To create a new GASWorkS model: ! Select the New item from the File menu list. The File Selection dialog box will appear.

Bradley B. Bean, PE

ENGINEERING & SOFTW ARE

27

GASWorkS 9.0

Menu Items

! In the File dialog box, select or enter the name of the new model. If the name of an existing model is selected or entered, a warning will appear. To overwrite an existing model, select the Yes command button. To return to the File Selection dialog without overwriting the existing files, select the No command button. If you choose to overwrite the model files, the contents of the original files will be sent to the Windows Recycle Bin. ! In the File dialog box, click the Continue command button to accept the specified file name, or click the Cancel button to exit without selecting a file. When a valid file name has been selected or entered, GASWorkS will create and open a new header file, and a set of empty data and support files. The contents of the header file will be similar to the last saved model. The GDI will automatically open. The Graphic Data Interface window will appear. Use the appropriate GDI commands to enter the data associated with the new model. If the GDI is not automatically opened, select the View/Edit item from the Graphics menu list. As new pipe and node features (records) are added, the values initially populating the new items are extracted from the default values. The default values may be set by using the Set Defaults routine found in the Utilities menu list. If the path name is omitted when entering a new file name, the current drive and directory will be assigned as the path. If the extension is omitted, the ".hdr" extension will be automatically applied.

New Project - Create A New Model...The New Project menu item is similar to the New item, it creates a new set of model files, but also allows various settings to selected before creating the model. To create a new GASWorkS model: ! Select the New Project item from the File menu list. The Project Specification screen will appear. ! On the specification screen, select or enter the name of the new model. Select the desired support file settings. Select any desired background files to attach. Select the Continue command button to create the model, or click the Cancel button to exit without selecting a file.

Bradley B. Bean, PE

ENGINEERING & SOFTW ARE

28

GASWorkS 9.0

Menu Items

If the name of an existing model is selected or entered, a warning will appear. To overwrite an existing model, select the Yes command button. To return to the File Selection dialog without overwriting the existing files, select the No command button. If you choose to overwrite the model files, the contents of the original files will be sent to the Windows Recycle Bin. GASWorkS will create and open a new header file, and a set of empty data and support files. The contents of the header file will be similar to the last saved model. The GDI will automatically open. The Graphic Data Interface window will appear. Use the appropriate GDI commands to enter the data associated with the new model. If the GDI is not automatically opened, select the View/Edit item from the Graphics menu list. As new pipe and node features (records) are added, the values initially populating the new items are extracted from the default values associated with the specified Default Data file.

Open - Open An Existing Model...The Open menu item opens an existing model for editing, reporting, or solution. To open an existing model: ! Select the Open item from the File menu list. The File Selection dialog box will appear. ! In the File dialog box, select or enter the name of the desired model's header file. Remember to include the ".hdr" extension if you manually enter the name. A warning will appear if the file is not found. ! In the File dialog box, click the Continue button to accept the selected file name, or click the Cancel button to exit without selecting a file. When a valid file name has been selected, GASWorkS will open and read the associated model files. Once the model is read into memory the various edit, report, and solution routines can be used to manipulate the model. Choose the desired function to proceed. Routines that require access to a model file will automatically prompt for a file name, if a model is not currently open. Note: If the Automatically Open GDI preference is selected, the Graphic Data Interface window will appear after a valid file name has been selected or entered. Note: If a version 7.0 model is selected, a prompt will appear requesting whether to import the file - respond appropriately. If the model is imported, a separate (converted) set of model files will be created with the same name as the original file followed by a _90" suffix.

Bradley B. Bean, PE

ENGINEERING & SOFTW ARE

29

GASWorkS 9.0

Menu Items

Close - Close A Model...The Close menu item closes the currently open model. To close the current model: ! Select the Close item from the File menu list. If changes have been made to the model, a prompt will appear asking whether to save or discard the changes - select the appropriate response. Note: Each time GASWorkS starts, it automatically opens the last open model file. This feature can be disabled by closing the model before leaving GASWorkS.

Save - Save Model Changes...The Save menu item saves the changes made to the currently open model. To save the current model changes: ! Select the Save item from the File menu list. A message will appear when the changes are saved. Select the OK command button to clear the message.

Save As - Save Model Changes To Another Name...The Save As menu item saves the current changes to another (different) model name and changes the name of the currently open model to the specified name. To save the current model changes to another name: ! Select the Save As item from the File menu list. The File Selection dialog box will appear for entering the name the new model name. ! In the File Selection dialog box, select or enter the name to save the changes to. A warning will appear if a model with the specified name already exists. To overwrite the existing model, select the Yes command button. To return to the File Selection dialog box without overwriting the existing model, select the No command button. If you choose to overwrite the existing model, the contents of that model's files will be sent to the Windows Recycle Bin. ! In the File Selection dialog box, click the Continue button to accept the specified model name, or click the Cancel button to terminate the command. After a valid file name has been selected, GASWorkS will copy the contents (in memory) of the currently open model into the selected model files. Upon completion of the save process, a prompt will appear. Select the OK command button to clear the message. Note: The Save As command saves (copies) the contents of the data stored in memory, not the data stored in the file on disk. To copy the data stored on disk to another destination use the Copy command.

Bradley