Upload
sjscribd
View
216
Download
0
Embed Size (px)
Citation preview
8/17/2019 Fathom 7 0 Modules Guide
1/202
AFT Fathom™
Modules User’s Guide
AFT Fathom version 7.0 Modules
Incompressible Pipe Flow Modeling
Applied Flow Technology
8/17/2019 Fathom 7 0 Modules Guide
2/202
CAUTION! AFT Fathom is a sophisticated pipe flow analysis program designed forqualified engineers with experience in pipe flow analysis and should notbe used by untrained individuals. AFT Fathom is intended solely as anaide for pipe flow analysis engineers and not as a replacement for otherdesign and analysis methods, including hand calculations and soundengineering judgment. All data generated by AFT Fathom should be
independently verified with other engineering methods.
AFT Fathom is designed to be used only by persons who possess a levelof knowledge consistent with that obtained in an undergraduateengineering course in the analysis of pipe system fluid mechanics andare familiar with standard industry practice in pipe flow analysis.
AFT Fathom is intended to be used only within the boundaries of itsengineering assumptions. The user should consult the User’s Guide for adiscussion of all engineering assumptions made by AFT Fathom.
Information in this document is subject to change without notice. No part of this User’sGuide may be reproduced or transmitted in any form or by any means, electronic ormechanical, for any purpose, without the express written permission of Applied FlowTechnology.
© 2008 Applied Flow Technology Corporation. All rights reserved.
Printed in the United States of America.
First printing.
“AFT Fathom”, “AFT Mercury”, “Applied Flow Technology”, and the AFT logo are
trademarks of Applied Flow Technology Corporation.
Microsoft, Visual Basic, Excel and Windows are trademarks or registered trademarks ofMicrosoft Corporation.
8/17/2019 Fathom 7 0 Modules Guide
3/202
Contents
Summary
1. Introduction .................................................................... 1
2. Using Goal Seek and Control........................................ 7
3. Goal Seek and Control Example ................................. 33
4. Modeling Extended Time Simulation.......................... 47
5. Modeling Time and Event Based Transients ............. 81
6. Extended Time Simulation Example........................... 91
7. Working with Cost Databases................................... 113
8. Performing Cost Analysis.......................................... 137
9. Cost Analysis Example .............................................. 151
10. Using Modules Together.......................................... 169
Glossary.......................................................................... 179
8/17/2019 Fathom 7 0 Modules Guide
4/202
iv AFT Fathom 7.0 Modules User’s Guide
8/17/2019 Fathom 7 0 Modules Guide
5/202
Table of Contents v
Detailed Contents
Summary..................................................................................................iii
Detailed Contents ..................................................................................... v
1. Introduction .................................................................... 1
What this user’s guide covers................................................................... 1
Modeling capabilities ............................................................................... 2
GSC module ....................................................................................... 2
XTS module ....................................................................................... 2
CST module ....................................................................................... 2 Who can use AFT Fathom........................................................................ 3
Getting started with the AFT Fathom Modules........................................ 3
GSC module ....................................................................................... 3
XTS module ....................................................................................... 3
CST module ....................................................................................... 3
Using Modules together ..................................................................... 3 Example models ................................................................................. 4
Using online help...................................................................................... 4
Activating modules................................................................................... 4
Opening models with and without module data ....................................... 5
Opening models without module data in a module............................ 6
Opening models with module data without an active module ........... 6 Using modules in scenarios ......................................................... 6
2. Using Goal Seek and Control........................................ 7
What is the GSC module? ........................................................................ 7
How does the GSC module work?............................................................ 7
Using the GSC module ............................................................................. 8
8/17/2019 Fathom 7 0 Modules Guide
6/202
vi AFT Fathom 7.0 Modules User’s Guide
Enabling GSC use..................................................................................... 9
Goal Seek and Control Manager ............................................................ 10
GSC variables ......................................................................................... 11 Types of variables...................................................................... 11
Creating and deleting variables ................................................. 12
Applying variables..................................................................... 14
Object type................................................................................. 14
Junction type.............................................................................. 14
Junction number and name........................................................ 14 Variable parameter .................................................................... 14
Linking variables ....................................................................... 15
Variable bounds......................................................................... 15
Reviewing junction input data................................................... 15
Editing junction input data ........................................................ 15
GSC goals ............................................................................................... 16 Types of goals............................................................................ 16
Creating and deleting goals ....................................................... 19
Applying goals........................................................................... 20
Goal types.................................................................................. 20
Object types ............................................................................... 21
Reviewing object input data ...................................................... 21
Editing object input data............................................................ 21
GSC data in Model Data......................................................................... 22
GSC feedback during the solution.......................................................... 22
GSC data in output ................................................................................. 23
Changing input values to GSC results.................................................... 24
Transferring results to initial............................................................ 24
Generating a disconnected scenario................................................. 25
When goals cannot be achieved.............................................................. 26
Physically unrealistic goals.............................................................. 27
Better starting point needed ............................................................. 27
Changing control parameters ........................................................... 27
Changing tolerance in Solution Control .................................... 28
8/17/2019 Fathom 7 0 Modules Guide
7/202
Table of Contents vii
Changing goal seeking numerical control ................................. 29
What to do if the Solver gets stuck......................................................... 29
GSC data differences across scenarios ................................................... 32
3. Goal Seek and Control Example ................................. 33
Topics covered........................................................................................ 33
Required knowledge............................................................................... 33
Model file ............................................................................................... 34
Problem statement .................................................................................. 34
Step 1. Start AFT Fathom....................................................................... 34
Step 2. Specify system properties........................................................... 34
Step 3. Build the model .......................................................................... 35
A. Place the pipes and junctions ................................................ 35
B. Enter the pipe data................................................................. 35
C. Enter the junction data .......................................................... 36
J1 Reservoir ............................................................................... 36
J9 Reservoir ............................................................................... 36
J3 Tee......................................................................................... 37
J6 Elbow .................................................................................... 37
J4, J7 Control Valves................................................................. 37
J5, J8 Heat Exchangers.............................................................. 37
J2 Pump ..................................................................................... 37
D. Check if the pipe and junction data is complete ................... 37
Step 4. Open the Goal Seek and Control Manager................................. 38
Step 5. Add a variable............................................................................. 38
Step 6. Add a goal................................................................................... 39 Step 7. View GSC settings in Model Data ............................................. 42
Step 8. Enable goal seeking.................................................................... 43
Step 9. Run the model............................................................................. 43
Step 10. Examine the results................................................................... 44
Analysis summary................................................................................... 45
8/17/2019 Fathom 7 0 Modules Guide
8/202
viii AFT Fathom 7.0 Modules User’s Guide
4. Modeling Extended Time Simulation.......................... 47
What is the XTS module?....................................................................... 47
How does the XTS module work?.......................................................... 48
Using the XTS module ........................................................................... 48
Enabling XTS transient mode................................................................. 49
Transient control window....................................................................... 51
Entering junction transient data ....................................................... 52
Initiating transients .................................................................... 53
Repeat transient ......................................................................... 53
Transient Special Conditions..................................................... 53
Entering reservoir volume data............................................................... 54
Infinite reservoirs ............................................................................. 54
Finite reservoirs................................................................................ 54
Finite open tanks........................................................................ 55
Finite closed tanks ..................................................................... 55
Known parameters initially.............................................................. 57
Entering reservoir transient data ...................................................... 58
Infinite reservoirs....................................................................... 58
Finite open tanks........................................................................ 58
Finite closed tanks ..................................................................... 59
What happens when finite tanks overflow? ..................................... 59
What happens when finite tanks drain? ........................................... 60
What happens when pipes are uncovered? ...................................... 60
Interpreting pipe depth and elevation data....................................... 61
Maximum and minimum pressures in closed tanks ......................... 61 Transient data in Model Data window ................................................... 61
Solution progress window with XTS ..................................................... 62
Transient control difference methods..................................................... 63
Forward difference method.............................................................. 64
Central difference method................................................................ 64
Relative and absolute tolerance ................................................. 65 Relaxation.................................................................................. 67
8/17/2019 Fathom 7 0 Modules Guide
9/202
Table of Contents ix
Maximum iterations................................................................... 67
Changing parameters during the run ......................................... 67
Output values displayed with forward difference............................ 67 Output values displayed with central difference.............................. 68
Transient data in Output window ........................................................... 69
Detailed results for a time step......................................................... 69
Transient results for all time steps ................................................... 69
Quick graphs .................................................................................... 70
Transient Graph Results ......................................................................... 73 Profile graphs ................................................................................... 73
Animation of output................................................................... 74
Transient graphs............................................................................... 75
Transient Visual Report.......................................................................... 76
Special conditions................................................................................... 77
Special conditions with no transient data .................................. 77 Special conditions with transient data....................................... 78
Pump special conditions ............................................................ 79
Transient Special Conditions ........................................................... 80
5. Modeling Time and Event Based Transients ............. 81
Time-based transients ............................................................................. 81
Event-based transients ............................................................................ 82
Single event transients ..................................................................... 82
Dual event transients: cyclic and sequential .................................... 83
Cyclic events.............................................................................. 83
Sequential events ....................................................................... 84 Junctions with inherent event logic ........................................................ 85
Check valve...................................................................................... 86
Relief valve ...................................................................................... 86
Thought experiment to further clarify event transients .......................... 86
Other transient features........................................................................... 87
Absolute vs. relative transient data .................................................. 87 Repeat transient................................................................................ 87
8/17/2019 Fathom 7 0 Modules Guide
10/202
x AFT Fathom 7.0 Modules User’s Guide
Add time offset................................................................................. 87
Graphing the transient data .............................................................. 87
Event messages....................................................................................... 89 Transient indicators on the Workspace .................................................. 89
Transient data in Model Data ................................................................. 90
6. Extended Time Simulation Example........................... 91
Topics covered........................................................................................ 91
Required knowledge............................................................................... 91
Model file ............................................................................................... 92
Problem statement .................................................................................. 92
Step 1. Start AFT Fathom....................................................................... 92
Step 2. Specify system properties........................................................... 92
Step 3. Build the Model.......................................................................... 93
A. Place the pipes and junctions ................................................ 93
B. Enter the pipe data................................................................. 93
C. Enter the junction data .......................................................... 94
J1 Reservoir ............................................................................... 94
J11, J13, J15, J17, J19 Assigned Pressures ............................... 95
J10, J12, J14, J16, J18 Valves ................................................... 95
J4, J6 Valves.............................................................................. 95
J3, J5 Pumps .............................................................................. 95
J8 Control Valve........................................................................ 96
J2, J7, J9 Branches .................................................................... 96
D. Check if the pipe and junction data is complete ................... 96
Step 4. Specify transient output time units............................................. 96
Step 5. Select transient analysis.............................................................. 97
Step 6. Open transient control ................................................................ 97
Step 7. Set up the system transients........................................................ 99
A. Auxiliary pump J5 transient. ....................................................... 99
B. Valve J6 Transient..................................................................... 100
C. Valve J12, J14, J16, J18 Transients .......................................... 100 Step 8. Run the model........................................................................... 101
8/17/2019 Fathom 7 0 Modules Guide
11/202
Table of Contents xi
Step 9. Examine the transient results.................................................... 102
Analysis summary................................................................................. 111
7. Working With Cost Databases .................................. 113
Sources of cost data supported ............................................................. 113
Types of databases supported............................................................... 113
Engineering and cost databases ............................................................ 114
Cost Database window ......................................................................... 114
One time vs. recurring costs........................................................... 115
Creating cost databases......................................................................... 116
Pipe material costs ......................................................................... 118
Non-recurring costs ................................................................. 119
Recurring costs ........................................................................ 119
Junction costs ................................................................................. 119
Deleting costs................................................................................. 119
Non-recurring costs, non-pumps and control valves ............... 119
Recurring costs, non-pumps .................................................... 120
Pump and control valve costs .................................................. 121
Costs for tees and branches ..................................................... 122
Pipe fitting & loss costs ................................................................. 122
Scale tables..................................................................................... 123
Global multipliers in cost database ................................................ 124
Global multipliers in Database Manager ....................................... 124
Using cost databases............................................................................. 125
Database Sections.................................................................... 126
How repetitive costs are handled ................................................... 126
Using the Database Sources tables................................................. 127
Pipe costs in Pipe Specifications window...................................... 127
Cost for pipe fittings & losses........................................................ 130
Junction costs in Junction Specifications window......................... 131
All databases vs. selected cost databases....................................... 132
Cost Settings window..................................................................... 133 Database locations in General Preferences .......................................... 134
8/17/2019 Fathom 7 0 Modules Guide
12/202
xii AFT Fathom 7.0 Modules User’s Guide
Reviewing application of cost data....................................................... 135
8. Performing Cost Analysis.......................................... 137
What is the CST module?..................................................................... 137
How does the CST module work?........................................................ 137
Using the CST module.......................................................................... 138
Accessing cost databases...................................................................... 139
Cost databases ................................................................................ 139
Energy Cost databases.................................................................... 139
Database Manager.......................................................................... 139
Cost Application Manager.................................................................... 139
Cost Databases ............................................................................... 141
Energy Cost Databases................................................................... 141
Cost Multipliers ............................................................................. 141
Maximum Cost Groups .................................................................. 141
Service Duration ............................................................................ 142
Cost Settings window ........................................................................... 142
Cost Calculations ........................................................................... 142
Energy Cost .................................................................................... 142
Cost Definitions ............................................................................. 143
Monetary vs. non-monetary costs .................................................. 143
Engineering parameter costs .......................................................... 144
Custom monetary units .................................................................. 144
Cost Time Period ........................................................................... 144
Cost Report ........................................................................................... 145
What are maximum cost groups? ......................................................... 146
Typical usage guidelines................................................................ 147
Creating a maximum cost group for pumps................................... 147
How cost multipliers are applied with maximum cost groups....... 148
Maximum cost is the base cost before multipliers are applied 148
Pump operates part of the time................................................ 148
Spare pump .............................................................................. 148 Maximum cost groups for control valves....................................... 149
8/17/2019 Fathom 7 0 Modules Guide
13/202
Table of Contents xiii
9. Cost Analysis Example .............................................. 151
Topics covered...................................................................................... 151
Required knowledge............................................................................. 151 Model file ............................................................................................. 152
Problem statement ................................................................................ 152
Step 1. Start AFT Fathom..................................................................... 153
Step 2. Open the model file .................................................................. 153
Step 3. Cost Settings............................................................................. 153
Cost Calculations ........................................................................... 154
Cost Definitions ............................................................................. 154
Cost Time Period ........................................................................... 154
Step 4. Create the cost databases.......................................................... 155
Create a new cost database for the pipe costs................................ 155
Enter the pipe material costs .......................................................... 156
Create cost scale tables .................................................................. 159
Add the costs for pipe fittings........................................................ 160
Create a new cost database for the pumps ..................................... 163
Enter the pump costs................................................................ 163
Connecting the cost databases........................................................ 164
Step 5. Including items in the Cost Report ........................................... 165
Step 6. Run the model........................................................................... 166
Step 7. Examine the Cost Report.......................................................... 166
Analysis summary................................................................................. 168
Cost optimization with AFT Mercury™ .............................................. 168
10. Using Modules Together.......................................... 169 Model file ............................................................................................. 169
Problem statement ................................................................................ 169
Start AFT Fathom................................................................................. 170
Open the model file .............................................................................. 170
Variable and goal settings .................................................................... 170
Transient control settings ..................................................................... 170 Junction transient data .......................................................................... 172
8/17/2019 Fathom 7 0 Modules Guide
14/202
xiv AFT Fathom 7.0 Modules User’s Guide
Cost settings.......................................................................................... 174
Run the model....................................................................................... 174
GSC and XTS module solutions........................................................... 175 Examine the results............................................................................... 175
Summary............................................................................................... 177
Glossary.......................................................................... 179
8/17/2019 Fathom 7 0 Modules Guide
15/202
C H A P T E R 1
Introduction
Welcome to the AFT Fathom™ 7.0 Modules. AFT Fathom is a graphicalplatform for modeling incompressible flow in pipe networks.
There are three optional add-on modules which extend AFT Fathom’s
extensive modeling capabilities into new areas. The Extended TimeSimulation (XTS) module allows the engineer to model time varyingsystem behavior. The Goal Seek & Control (GSC) module allows theengineer to perform multivariable goal seeking and simulate controlsystem functions. The Cost (CST) calculation module allows theengineer to calculate system costs, both initial and recurring. Themodules can be used individually or together.
The AFT Fathom Modules automate and organize a range of engineeringfunctions, bringing increased productivity to the piping system engineer.
What this user’s guide covers
This User’s Guide documents features in the AFT Fathom Modules
which are not discussed in and are not part of the standard AFT Fathom7.0 User’s Guide provided separately. This User’s Guide assumes theuser is familiar with AFT Fathom. Please consult the AFT Fathom 7.0User’s Guide for information on standard AFT Fathom functions.
8/17/2019 Fathom 7 0 Modules Guide
16/202
2 AFT Fathom 7.0 Modules User’s Guide
Modeling capabilities
GSC module
• Can automatically have parameters vary to meet specified goals
• Can specify group goals to ensure a group of pipes or junctionssatisfies operating criteria
• Can link variables to force commonality in solutions
• Can easily apply and unapply goals and variables
XTS module
• Can model transient behavior over time
• Supports time and event transients for valve position, pump speed,
pump control setpoints, pressure or flow, reservoir liquid level orsurface pressure, spray CdA, control valve setpoints
• Reservoirs can be finite with defined tank geometries so surfacelevel changes with time can be computed
• Reservoirs can be open or closed. If closed, surface pressure changesdue to gas compression (when the liquid level changes) can bemodeled.
• Transient data shown on Output window and controlled by specialOutput Control features
• Transient data can be graphed over time
• Profile data can be animated
• Quick Graph on Output window shows a popup graph of transient
data
CST module
• Can obtain cost for entire pipe system (has all cost capabilities ofAFT Mercury™)
• Can account for non-recurring and recurring costs
8/17/2019 Fathom 7 0 Modules Guide
17/202
Chapter 1 Introduction 3
• If used with XTS module, can calculate pump energy usage and costover time
Who can use AFT Fathom
AFT Fathom assumes that the user possesses a good general knowledgeof engineering pipe system hydraulics. Even the most advanced andeasy-to-use software package cannot make up for a lack of fundamentalknowledge on the part of the user. The level of knowledge assumed by
AFT Fathom is consistent with that obtained in a typical engineeringundergraduate course in fluid mechanics. See the copyright page in thisUser’s Guide for cautionary information.
Getting started with the AFT Fathom Modules
GSC module
Chapter 2 discusses in detail how to use the GSC module. Chapter 3focuses on an example application.
XTS module
Chapter 4 discusses in detail how to use the XTS module. Chapter 5discusses time and event transients. Chapter 6 focuses on an exampleapplication.
CST module
Chapter 7 discusses how Cost Databases are built and used. Chapter 8
discusses in detail how to use and apply data to generate costcalculations. Chapter 9 focuses on an example application.
Using Modules together
Chapter 10 discusses how the modules can be used with each other andlooks at an example.
8/17/2019 Fathom 7 0 Modules Guide
18/202
4 AFT Fathom 7.0 Modules User’s Guide
Example models
An auxiliary help file (called FathomExamples.hlp) is installed with
AFT Fathom and leads the user through modeling a number of realworld systems. This help file can be accessed by choosing “ShowExamples” from the Help menu. The example models discussed inFathomExamples.hlp are installed in the Examples folder. It can beopened from the Help menu by choosing “Show Examples”.
Using online helpTo access AFT Fathom's online help, press the F1 function key or selectHelp from the menu bar. For convenient access, much of the content ofthis User’s Guide is included in the Help system. The Help button ineach dialog window provides context-sensitive help on the features ofthat window.
In the Help system you have the option of searching for information onspecific topics or searching through the hierarchical layout to find moregeneral information.
Activating modules
When AFT Fathom launches, the first window displayed is the ActivateModules window (Figure 1.1 top). This allows you to select whichmodules you would like to activate for use in AFT Fathom. If a license isnot found for a module, the selection will be disabled (Figure 1.1bottom). Even though the Activate Modules window allows you tochoose a module for activation, that does not mean that a license isavailable for use – it just means that a license exists. If it is in use byanother user and thus not available for checkout, you will be informed
after clicking the OK button.
If there is a module you would like to always have activated when youstart AFT Fathom, select it in the Activate Modules window and thenclick the Set as Default button (see Figure 1.1).
If you do not want the Activate Modules window to display when youstart AFT Fathom, clear the “Always Show” check box provided.
8/17/2019 Fathom 7 0 Modules Guide
19/202
Chapter 1 Introduction 5
If, after starting AFT Fathom, you decide you would like to activate (ordeactivate) a module, you can open the Activate Modules window fromthe Options menu.
Figure 1.1 The Activate Modules window displays when AFTFathom launches, showing all modules available (top)or only some available (bottom).
Opening models with and without module data
What happens when you open a model that has module data withoutaccess to that module, and vice versa? This section discusses whathappens to the model.
8/17/2019 Fathom 7 0 Modules Guide
20/202
6 AFT Fathom 7.0 Modules User’s Guide
When AFT Fathom is used along with a module, that module is said tobe active.
Opening models without module data in a module
There is no problem opening a model without module data into AFTFathom when one or more of the modules is active. When doing so, themodel can be enhanced through the module features. However, once amodel which uses module features is saved, the data can only be retainedby continuing to use that model with the active module.
If you want to continue to use the original model without modulefeatures, you may want to keep two versions of the model. One for usewith modules and one without.
Opening models with module data without an activemodule
If you open a model which has module data in it, and that module is notactive, AFT Fathom will attempt to activate the module. If it cannot, themodule related data will not be displayed in AFT Fathom. Further, AFTFathom does not attempt to retain the original module data and it may belost if the model is later saved.
When you open the model in such cases, AFT Fathom will inform youwhat modules are used in the model, and warn you about lost data if you
open the model and save it. You will be given a choice to cancel themodel opening process at that point.
Important: Opening a model created with a module into an AFTFathom session without that module will usually result in the data beinglost.
Using modules in scenarios
You may have a model where some scenarios use certain modules whileothers do not. If a module is used in any scenario, AFT Fathomconsiders that entire model to be using the module. Thus even if thescenario which uses the module is not opened, the data may be lost whenthe model is saved.
8/17/2019 Fathom 7 0 Modules Guide
21/202
C H A P T E R 2
Using Goal Seek and Control
This chapter introduces the Goal Seek and Control Module (GSC).
Detailed information regarding GSC menus and functionality is given inthis chapter. Chapter 3 provides a detailed hands-on GSC example.
What is the GSC module?
Many engineering modeling tasks involve more than just directly solvinga system. In some cases a manual, “cut and try” method of changinginput variables to achieve desired operating results is required. When a
single parameter is being changed, the manual process (while tediousand time consuming) can be used successfully. However, varying two ormore parameters at the same time quickly becomes impractical.
The GSC module automates the process of changing input variables toachieve desired design goals. For single variable situations, the GSCmodule offers the advantage of being much faster than manual methods.Further, it provides a practical tool for solving cases when there are two
or more variables.
How does the GSC module work?
The GSC module employs numerical optimization technology like thatused in AFT Mercury™. The optimization engine employed by the AFTFathom GSC module uses state-of-the-art optimization technologylicensed from Vanderplaats Research and Development, the leading
8/17/2019 Fathom 7 0 Modules Guide
22/202
8 AFT Fathom 7.0 Modules User’s Guide
company in optimization technology. However, rather than minimizingsome function value such as system cost or weight, the GSC modulesatisfies equality criteria using “goal programming” methods.
The core hydraulic solution in AFT Fathom is performed by theHydraulic Solver. In standard AFT Fathom usage, the Hydraulic Solveris called once to solve a system. The GSC module’s NumericalOptimizer is used to call the Hydraulic Solver repeatedly, thus solving aseries of models with different inputs. The Numerical Optimizer adjuststhe user specified Variables (discussed later in this chapter) in orderforce the Hydraulic Solver output values to agree with the user specifiedGoals (also discussed later in this chapter). Figure 2.1 depicts therelationship between the different components.
Convergedon goals?
No
Yes
Numerical Optimizer
Hydraulic Solver
Graphical Interface
Input Output
Figure 2.1 The GSC module flowchart shows how the HydraulicSolver is called repeatedly in an iterative loop.
Using the GSC module
The user has the option of activating or not activating the GSC modulewhen AFT Fathom first loads. After AFT Fathom is loaded, the GSC
module can be activated or deactivated for use from the Options menu.Whether or not GSC is activated impacts the View menu, Analysismenu, Model Data window and Output window.
If the GSC module is active, the user can still run models without goalseeking. This is selected under Goal Seek & Control on the Analysismenu. Hence there are three possibilities for GSC.
1. GSC is not active
2. GSC is active and goal seeking is ignored
8/17/2019 Fathom 7 0 Modules Guide
23/202
Chapter 2 Using Goal Seek and Control 9
3. GSC is active and goal seeking is performed
Table 2.1 lists the three possibilities and the impact on various AFT
Fathom features.
Table 2.1 AFT Fathom feature accessibility based on GSCactivation and GSC use
GSC Not Active GSC Active GSC Active
Feature No Mode Ignore Use
"Goal Seek and Control
Manager" on View MenuNot Visible Visible Visible
"Goal Seek and Control" on
Analysis MenuNot Visible Visible Visible
"Goal Seek and Control" tab
in General Section of Model
Data
Not Visible Visible Visible
"GSC Variables" and "GSCGoals" tab in General Section
of Output window
Not Visible Not Visible Visible
Enabling GSC use
When the GSC module is active, two new menu items appear – one onthe View menu and the other on the Analysis menu. On the Analysismenu is the Goal Seek & Control menu, from which the user can select“Ignore” or “Use”.
The GSC module goal seeking is enabled by selecting Goal Seek &Control -> Use from the Analysis menu (Figure 2.2). This can beselected before or after a model is built. Pre-existing models built with
standard AFT Fathom can be opened with GSC and goal seeking dataadded.
Goal seeking can be turned off at any time by selecting Ignore from thesame menu. The Ignore mode causes the GSC module to function likestandard AFT Fathom. One difference is that users can still enter goalseeking data and this data is retained in the model. If the model isopened in standard AFT Fathom, this data will be lost. Table 2.1 relates
the differences between not using GSC and using it in Ignore mode.
8/17/2019 Fathom 7 0 Modules Guide
24/202
10 AFT Fathom 7.0 Modules User’s Guide
The purpose of Ignore mode is that it allows the goal seeking to bequickly turned off and on without having to change data in the GoalSeek & Control Manager (discussed in the next section).
When the goal seeking mode is selected, the Goal Seek and ControlManager option on the View menu is enabled.
Figure 2.2 Select “Use” from the Goal Seek & Control menu itemon the Analysis menu to instruct AFT Fathom to
perform goal seeking when it runs.
Goal Seek and Control Manager
The Goal Seek and Control Manager is where variables and goals aredefined and applied (Figure 2.3). The Goal Seek and Control Manager isopened by selecting Goal Seek and Control Manager from the ViewMenu.
8/17/2019 Fathom 7 0 Modules Guide
25/202
Chapter 2 Using Goal Seek and Control 11
There are three tabs on the Goal Seek and Control Manager, and the firsttwo will be used most frequently. These are the Variables tab and theGoals tab. Variables and goals are discussed in then next few sections.
Figure 2.3 Goal Seek and Control Manager is where you defineand apply your variables and goals.
GSC variables
Variables are input parameters that the GSC module will change toachieve the user's desired goals. Variables are defined and applied fromthe Variables tab on the Goal Seek and Control Manager window (see
Figure 2.4). Generally, there must be one variable applied for each goalthat is applied.
Types of variables
All variables are junction parameters. The variables that are available foreach junction type are shown in Table 2.2. There are over 30 types ofvariables.
12 AFT F h 7 0 M d l U ’ G id
8/17/2019 Fathom 7 0 Modules Guide
26/202
12 AFT Fathom 7.0 Modules User’s Guide
Figure 2.4 GSC Variables are input parameters to be
automatically varied.
Creating and deleting variables
To create a variable, click the New Variable button on the Variables tab(Figure 2.4). This will insert a new item into the variable list. After thevariable has been added, the variable data is defined by entering thenecessary data in each of the data columns.
Variables may also be added by duplicating an existing variable, thenmodifying the data for the new variable. To duplicate a variable, selectthe variable to be duplicated from the variable list, and click the
Duplicate Variable button.To delete a variable, select the variable by clicking on the appropriaterow in the variable list. After selecting the variable to be deleted, clickthe Delete Variable button. If you want to delete all of the variables inthe list, click the Delete All Variables button.
Chapter 2 Using Goal Seek and Control 13
8/17/2019 Fathom 7 0 Modules Guide
27/202
Chapter 2 Using Goal Seek and Control 13
Table 2.2a List of object types with available variables
Object Type Variables Restrictions
Assigned Flow Flow
Elevation
Temperature Only with heat transfer
Assigned Pressure Pressure
Elevation
Temperature Only with heat transfer
Branch Imposed Flow
Check Valve Loss Value
Control Valve Control SetpointGeneral Component Loss Factor
Heat Exchanger Loss Factor
Heat Rate Only with heat transfer
Discharge Temperature Only with heat transfer
Temperature Rise Only with heat transfer
Enthalpy Rise Only with heat transfer
Heat Transfer Area Only with heat transferOverall Heat Transfer Coefficient Only with heat transfer
Secondary Flow Only with heat transfer
Secondary Inlet Temperature Only with heat transfer
Orifice Diameter/Area
Loss Factor
Elevation
Pump Speed
FlowHead Rise
Impeller Size
Control Setpoint
Relief Valve Loss Value
Reservoir Liquid Level
Surface Pressure
Temperature Only with heat transfer
Screen Open Area
Loss Factor
Spray Discharge Spray Area
K
Number Sprinklers Only sprinklers
Number Sparger Holes Only spargers
Elevation
14 AFT Fathom 7 0 Modules User’s Guide
8/17/2019 Fathom 7 0 Modules Guide
28/202
14 AFT Fathom 7.0 Modules User s Guide
Table 2.2b List of object types with available variables
Object Type Variables Restrictions
Three Way Valve Open Percentage
Valve Loss Value
Elevation Only exit valves
Venturi Loss Factor
Applying variables
Once a variable has been created, the user must specify if a variable is tobe used when the GSC module is run. To apply a variable, select thecheckbox in the Apply column.
Using the Apply feature allows the user to define multiple variables thatcan be used in alternate cases or analyses. Any of the variables that arenot being used for a particular analysis can remain in the list for lateruse. Click the Apply checkbox for the variables that are to be used in thecurrent analysis.
Object type
The Object Type defines whether the variable applies to a pipe or a junction. At this time, variables may only be assigned to junction objecttypes.
Junction type
The Junction Type column is used to define the type of junction towhich the variable is being applied.
Junction number and name
The specific junction to vary is selected in the Junction Number andName column. The list will only display junctions of the type selected inthe Junction Type column.
Variable parameter
Each junction type has a specific set of parameters that are available asvariables (Table 2.2). The list will only display parameters that are
available for the junction type selected in the Junction Type column.
Chapter 2 Using Goal Seek and Control 15
8/17/2019 Fathom 7 0 Modules Guide
29/202
Chapter 2 Using Goal Seek and Control 15
Linking variables
The Link To column is used to force a variable on multiple junctions ofthe same type to solve to the same value.
An example where this would be desirable would be when using pumpimpeller trim as a variable for several pumps in parallel. It is oftendesirable to solve for a condition where the pump impeller trim is thesame for all of the pumps. This can be accomplished by using variablelinking. A pump impeller trim variable would be defined for each of thepumps. Then, one of the pumps would be selected as the basis pump,which just means no linking is specified for this pump. The other pumpswould be linked to the basis pump by selecting the basis pump from thelist in the Link To column.
Variable bounds
During a goal search, the GSC module will modify the values for thedefined variables. Sometimes it is helpful to specify upper and lower
bounds for variables to provide logical extremes during the goal search.Some examples of logical bounds that can be applied would be lowerand upper bounds on valve open percentage of 0% and 100%,respectively.
Note that bounds can have engineering units, but these units are notdisplayed. It is assumed the units are the same as the junction inputparameter specifications window.
Reviewing junction input data
If you would like to see the input data for the junction selected as avariable, press the right mouse button on the far left column in theVariables table. The inspection window will display, showing you theinput data.
Editing junction input data
Similar to the inspection feature just described, you can open theJunction Specifications window by double-clicking the far left column inthe Variables table. From there you can change any data desired.
16 AFT Fathom 7.0 Modules User’s Guide
8/17/2019 Fathom 7 0 Modules Guide
30/202
16 AFT Fathom 7.0 Modules User s Guide
GSC goals
Goals are output values you would like to achieve. The GSC moduleadjusts the applied variables until the applied goals are met. Goals aredefined and applied on the Goals tab on the Goal Seek and ControlManager window (Figure 2.5). Generally there should be one goalapplied for each applied variable.
Figure 2.5 GSC Goals are output parameters to be achieved bychanging the variables.
Types of goals
The GSC module offers over 150 goals applied to pipes, junctions orgroups of pipes and/or junctions. Table 2.3 lists all of the types of goals.
Chapter 2 Using Goal Seek and Control 17
8/17/2019 Fathom 7 0 Modules Guide
31/202
p g
Table 2.3a List of object types with available goals
Object Type Goals Restrictions/Comments
Pipe Energy Gradeline
Head Gradient
Head Loss
Heat Rate Into Pipe Only with heat transfer
Hydraulic Gradeline
Mass Flow Rate
Pressure Drop Friction
Pressure Gradient
Pressure StagnationPressure Static
Pressure Static Maximum
Pressure Static Minimum
Temperature Only with heat transfer
Temperature Loss Only with heat transfer
Velocity
Volumetric Flow Rate
Wall Temperature Only with heat transferArea Change Energy Gradeline
Bend Hydraulic Gradeline
Check Valve Mass Flow Rate
General Component Pressure Stagnation
Jet Pump Pressure Static
Orifice Temperature Only with heat transfer
Relief Valve Volumetric Flow Rate
Screen
Valve
Venturi
Volume Balance
Assigned Flow Energy Gradeline
Hydraulic Gradeline
Pressure Stagnation
Pressure StaticAssigned Pressure Mass Flow Rate Net Into Jct Net flowrate
Vol. Flow Rate Net Into Jct Net flowrate
18 AFT Fathom 7.0 Modules User’s Guide
8/17/2019 Fathom 7 0 Modules Guide
32/202
Table 2.3b List of object types with available goals (cont.)
Object Type Goals Restrictions/Comments
Branch Energy Gradeline
Hydraulic Gradeline
Mass Flow Rate Net flowrate
Pressure Stagnation
Pressure Static
Temperature Only with heat transfer
Volumetric Flow Rate Net flowrate
Control Valve Cv If Open Pct data exists
Energy Gradeline Only for FCVHead Loss Not PDCV
Hydraulic Gradeline Only for FCV
Mass Flow Rate Only for PRV, PSV
Open Percentage If Open Pct data exists
Pressure Loss Not PDCV
Pressure Stagnation Only for FCV
Pressure Static Only for FCV
Temperature Only with heat transfer
Volumetric Flow Rate Only for PRV, PSV
Dead End Energy Gradeline
Pressure Stagnation
Heat Exchanger Energy Gradeline
Heat Rate In Only with heat transfer. For non-
fixed heat rate exchanger models.
Hydraulic GradelineMass Flow Rate
Pressure Stagnation
Pressure Static
Temperature Only with heat transfer. For non-
controlled temperature models.Volumetric Flow Rate
Chapter 2 Using Goal Seek and Control 19
8/17/2019 Fathom 7 0 Modules Guide
33/202
Table 2.3c List of object types with available goals (cont.)
Object Type Goals Restrictions/Comments
Pump Energy Gradeline
Head Rise Only for non-fixed head rise pumps
Hydraulic Gradeline
Mass Flow Rate Only for non-fixed flow pumps
NPSH Margin
Power Overall
Pressure Rise Only for non-fixed head rise pumps
Pressure Stagnation
Pressure StaticTemperature Only with heat transfer
Volumetric Flow Rate Only for non-fixed flow pumps
Reservoir Mass Flow Rate Net Into Jct Net flowrate
Vol. Flow Rate Net Into Jct Net flowrate
Spray Discharge Mass Flow Rate Out Net flowrate
Volumetric Flow Rate Out Net flowrate
Tee or Wye Energy Gradeline
Hydraulic GradelinePressure Stagnation
Pressure Static
Temperature Only with heat transfer
Three Way Valve Energy Gradeline
Hydraulic Gradeline
Pressure Stagnation
Pressure StaticTemperature Only with heat transfer
Group Sum Head loss
(pipes and junctions) Heat rate in Only with heat transfer
Mass flow rate
Pressure loss
Volumetric flow rate
Group Max/Min Uses all pipe goals Same as pipe goals
PipesGroup Max/Min Use all junction type goals Same as junction goals
Junctions
Creating and deleting goals
To create a goal, click the New Goal button on the Goals tab. This willinsert a new item into the goals list. After the goal has been added, the
20 AFT Fathom 7.0 Modules User’s Guide
8/17/2019 Fathom 7 0 Modules Guide
34/202
goal data is defined by entering the necessary data in each of the datacolumns.
Goals may also be added by duplicating an existing goal, then modifyingthe data for the new goal. To duplicate a goal, select the goal to beduplicated from the goal list, and click the Duplicate Goal button.
To delete a goal, select the goal by clicking on the appropriate row in thegoal list. After selecting the goal to be deleted, click the Delete Goalbutton. If you want to delete all of the goals in the list, click the DeleteAll Goals button.
Applying goals
Once a goal has been created, the user must specify if a goal is to beused when GSC is run. To apply a goal, select the checkbox in the Applycolumn.
Using the Apply feature allows the user to define multiple goals that canbe used in alternate cases or analyses. Any of the goals that are not beingused for a particular analysis can remain in the list for later use. Clickthe Apply checkbox for the goals that are to be used in the currentanalysis.
Goal types
Users may specify three types of goals when using the GSC module.
• Point Goal – A point goal is specified when the desired goal can bespecified at a specific object location in the model.
• Differential Goal – A differential goal is used when the goal value isactually determined by the difference in values between two specificobject locations. An example of a differential goal might be thepressure difference between two locations in the model.
• Group Goal – A Group goal is used when a goal is to be applied to agroup of objects at the same time. In order to use a Group goal, all ofthe objects must be added to a Group by using the Groups commandon the Edit menu.
Chapter 2 Using Goal Seek and Control 21
8/17/2019 Fathom 7 0 Modules Guide
35/202
Object types
For Point and Differential goal types, the object type indicates whetherthe goal is to be applied to a pipe or a junction object. If the goal is to be
applied to a junction, the type of junction is selected from the list.
For the Group goal type, the user must select between a Group Max/Minor a Group Sum object type.
A Group Max/Min goal allows a single goal to be applied to a group ofobjects. The GSC module applies a Group Max/Min goal by ensuringthe final goal value is either greater than or equal to (a Min goal) or less
then or equal to (a Max goal) the specified value for each object in thegroup. For example, a Group Max/Min goal can be applied to ensure aminimum flow rate out of each spray discharge nozzle in a group ofnozzles. Group Max/Min goals only work for groups where all groupmembers are of the same type (i.e., all pipes or all valve junctions).
A Group Sum goal is used to set the sum of the goal parameter for all themembers in a group to a specified value. For example, the Group Sum
goal can be applied to set the sum of the volumetric flow rates throughall of the nozzles in a group of spray discharge nozzles to a particularvalue. Groups used in Group Sum goals can consist of pipes and/or junctions, with junctions of different type.
Reviewing object input data
If you would like to see the input data for the pipe or junction selected asa goal, press the right mouse button on the far left column in the Goalstable. The inspection window will display, showing you the input data.This feature does not work for group goals.
Editing object input data
Similar to the inspection feature just described, you can open the Pipe or
Junction Specifications window by double-clicking the far left column inthe Goals table. From there you can change any data desired. Thisfeature does not work for group goals.
22 AFT Fathom 7.0 Modules User’s Guide
8/17/2019 Fathom 7 0 Modules Guide
36/202
GSC data in Model Data
When the GSC module is active, the Model Data window displays a list
of all variables and goals in the General section. This is useful fordocumentation purposes. See Figure 2.6.
Figure 2.6 Model Data window shows the variable and goal input
data.
GSC feedback during the solution
Figure 2.1 depicted the logic flow when running AFT Fathom with goalseeking enabled. When a goal seeking model is run, the Solution
Progress window displays additional information (Figure 2.7).As shown in Figure 2.7, at the far right is how many calls have beenmade to the Hydraulic Solver. This relates to the Figure 2.1 iterationloop from the Hydraulic Solver to the Numerical Optimizer, and howmany times GSC has gone around the loop.
The Best (Lowest) field shows the progress towards satisfying the GSCgoals. As progress is made, this field will approach zero. This relates to
Chapter 2 Using Goal Seek and Control 23
8/17/2019 Fathom 7 0 Modules Guide
37/202
the diamond in Figure 2.1 which checks goal convergence. This occurswhen the Best (Lowest) value is sufficiently small.
GSC informationdisplayed on this line
As progress is made,this should approach
zero
Number of calls to theHydraulic Solver
displayed here
Figure 2.7 The Solution Progress window shows additional
information when a GSC model is run.
GSC data in output
When the GSC module is active and goal seeking is enabled, the Outputwindow displays a GSC Variables tab and GSC Goals tab in the General
section (see Figure 2.8). If the goal seeking was successful, the GSCGoals tab (Figure 2.8 bottom) should show the “Actual Goal Value”(i.e., the result from the hydraulic solution) close or equal to the “UserGoal Value” specified in the Goal Seek and Control Manager.
If the Actual Goal Value and User Goal Value differ significantly, theuser is given a warning. This can occur for a variety of reasons, and isdiscussed in detail later in this chapter.
24 AFT Fathom 7.0 Modules User’s Guide
8/17/2019 Fathom 7 0 Modules Guide
38/202
The GSC Variable tab (Figure 2.8 top) shows the input values that mustexist in order to satisfy the goals.
Figure 2.8 Output window shows the solved variable values andthe user’s goal and actual solved goal values.
Changing input values to GSC results
As discussed previously, the Output window GSC Variables tab (Figure2.8 top) indicates how the input parameters must be varied to satisfy thegoals. Once you have these results, you may want to keep and use themin the model. There are two ways to do this: Transferring Results toInitial and generating a Disconnected Scenario.
Transferring results to initial
In general, the Output window supports a feature called “TransferResults to Initial Guesses”. This is available on the Edit menu. Whenused without the GSC module, it transfers calculated results for flow,
pressure and temperature to the initial guess values of the pipes and junctions. When used after a GSC run it gives you three options: totransfer the GSC Variable Data, the calculated results, or both (seeFigure 2.9).
If you choose either of the first two options that transfer GSC VariableData, the junction data on the Specifications window will be changed tothe GSC Variable results (i.e., Figure 2.8 top). This means that one could
Chapter 2 Using Goal Seek and Control 25
h h l ki h d l d b i h
8/17/2019 Fathom 7 0 Modules Guide
39/202
then choose to Ignore goal seeking, rerun the model, and obtain the sameresults as before.
Figure 2.9 Transfer Results window opened from the Output
window Edit menu allows users to transfer GSCVariable data back to the input fields
Generating a disconnected scenario
Scenarios and Scenario Manager are discussed in depth in the AFTFathom 7.0 User’s Guide. After a run is complete, a special type ofscenario can be created called a disconnected scenario. A disconnectedscenario itself breaks the inheritance of normal child scenarios so that itis a truly standalone scenario. This is ideal for GSC results in that it maynot make sense to save the GSC results for future use if the model canotherwise be changed in arbitrary ways. For if it were changed, the GSCresults would be invalidated, meaning the user would need to rerun GSC.
For example, assume a GSC run is made to find the valve open positionrequired to achieve a certain flow. If this result is saved, and then the
pipe size is later changed, the valve open position would no longersupply the desired flow. The pipe size could be changed, for instance,within the particular scenario or perhaps in an ancestral scenario.
What one may want in such cases is to preserve the GSC results and allinput data that accompanied it. That is the purpose of the disconnectedscenario. Disconnected scenarios cannot be changed by other scenarios,but only in the disconnected scenario itself.
26 AFT Fathom 7.0 Modules User’s Guide
T t di t d i i th O t t i d h
8/17/2019 Fathom 7 0 Modules Guide
40/202
To create a disconnected scenario, in the Output window chooseGenerate Disconnected Scenario from the View menu or Toolbar.
When goals cannot be achieved
In some cases the GSC module may not be able to achieve a goal. Thiscan happen for the following reasons:
1. A goal is not physically realistic
2. A better starting point is needed for the input values assigned asGSC Variables
3. Hydraulic solution tolerances or optimizer numerical parametersrequire adjustment
In such cases, the goal will not be satisfied in the results. In other words,the Actual Goal Value and User Goal Value will differ (Figure 2.8bottom).
In all cases the user will be warned when goals were not met. Figure2.10 shows the Output window with such a warning.
Figure 2.10 Warning display in Output window when a goalcannot be met.
Chapter 2 Using Goal Seek and Control 27
Physically unrealistic goals
8/17/2019 Fathom 7 0 Modules Guide
41/202
Physically unrealistic goals
It may be possible that a goal is not achievable because it is notphysically possible. For example, a pump may be too small to satisfy aflowrate goal at some pipe.
To determine whether a goal is unrealistic, try changing the goal andrerunning the model. If the goal can be met in some cases and not others,this is an indicator that the original goal was unrealistic.
Better starting point needed
In some cases the goal may be so far away from the original model thatthe GSC module has difficulty finding a solution. This is not common,but it is worth trying to adjust the starting point of parameters which arebeing varied.
Changing control parameters
The Numerical Optimizer determines goal search directions byapproximating a gradient based on perturbed variable values. By defaultit uses a central difference approximation, but forward difference canalso be used. If the hydraulic solution is not converged to a sufficientlysmall tolerance, the gradient approximation will not be sufficientlyaccurate and hence a good search direction cannot be obtained. The endresult is that the goal seeking fails.
There are two general areas that can be changed in such cases: thehydraulic solution tolerances in Solution Control, and numerical controlparameters in the Goal Seek and Control Manager.
In the next few sections recommendations on how to manually changethese parameters will be given. However, before making a manualchange it is definitely worth trying the automated parameter adjustmentfeature.
Figure 2.10, bottom picture, shows the warning when a goal is not met,and also shows a recommendation and suggests pressing the “F2” key.When doing so, a window appears as shown in Figure 2.11. Thiswindow will offer up to three options for automatic parameteradjustment. It is typically a good idea to accept the default changes, clickOK, and rerun the model.
28 AFT Fathom 7.0 Modules User’s Guide
The purpose of the Figure 2 11 window is to simplify for the user
8/17/2019 Fathom 7 0 Modules Guide
42/202
The purpose of the Figure 2.11 window is to simplify for the usermaking common changes to resolve goal seeking problems.
Figure 2.11 When goal seeking fails, pressing the F2 key will show
this window which allows the user to automaticallyimplement recommend numerical parameteradjustments.
Caution: The user should be very cautious in manually changingparameters in Solution Control and the Goal Seek and Control Managernumerical control. Making changes without a good understanding of the
parameters involved can lead to incorrect results.
Changing tolerance in Solution Control
By default AFT Fathom uses Relative Tolerance criteria set to 0.0001(see Figure 2.12). Goal seeking convergence can sometimes be improvedby reducing these values to 0.00001 or 0.000001.
For a more in-depth discussion of Solution Control see the AFT Fathom7.0 User’s Guide, Chapter 8.
Chapter 2 Using Goal Seek and Control 29
8/17/2019 Fathom 7 0 Modules Guide
43/202
Figure 2.12 Reducing Solution Control tolerance criteria mayresolve goal seeking difficulties.
Changing goal seeking numerical control
Figure 2.13 shows the Numerical Control area of the Goal Seek andControl Manager, discussed earlier in this chapter. The most useful
parameter one can adjust is the Relative Finite Difference Step Size.Using values between 0.01 and 0.001 are recommended. In some casesusing a value as high as 0.1 may be tried.
What to do if the Solver gets stuck
Figure 2.1 depicts the logic of how the Hydraulic Solver and NumericalOptimizer work together. Discussed earlier is the issue of physicallyunrealistic goals. Occasionally the user may have specified a goal whichis in fact physically realistic, but in the process of going from aphysically realistic starting point to a similarly physically realistic goal,a physically unrealistic system may be proposed by the NumericalOptimizer. What happens in such cases?
30 AFT Fathom 7.0 Modules User’s Guide
8/17/2019 Fathom 7 0 Modules Guide
44/202
Adjusting finitedifference step
size can resolvedifficulties
Figure 2.13 Changing certain numerical control parameters in the
Goal Seek and Control Manager may resolve goalseeking difficulties.
When performing goal seeking with the GSC module, AFT Fathom hasbeen designed to gracefully handle such cases. One of two things will
typically happen:
1. The Hydraulic Solver will experience a computational error
2. The Hydraulic Solver will not be able to converge
In the first case, AFT Fathom does not stop and tell the user of the error,but instead sets an internal flag that the system used for the particulariteration that caused the error was a poor system and should not be
considered further by the Numerical Optimizer. In other words, it skipsthe system that caused the error. This will happen in a way which istransparent to the user and requires no intervention.
The second case is of more interest here. In this case the HydraulicSolver gets stuck on one of the systems proposed by the NumericalOptimizer and cannot progress. The Hydraulic Solver will continuetrying to converge until it reaches the iteration limit. Once it reaches that
Chapter 2 Using Goal Seek and Control 31
limit, it will react in a similar way to the first case above – it will set a
8/17/2019 Fathom 7 0 Modules Guide
45/202
yflag and skip that system.
However, the default maximum number of iterations is 50,000 (specified
in Solution Control, Figure 2.14). It is perfectly fine for one to wait untilthis limit is reached and allow the AFT Fathom to handle the situationautomatically, but depending on the size of the model it may take awhileto get to 50,000 iterations. In such cases it may be desirable to allowAFT Fathom to more quickly conclude the model will not converge byreducing the maximum iterations to something like 5,000.
Tip: If the Hydraulic Solver appears to get stuck while performing aGSC run, you can pause the Solver, open the Solution Control window,and reduce the Maximum Iterations. The default value is 50,000.Depending on the model size, a reduced value of 5,000 may beappropriate.
Figure 2.14 It may be desirable to reduce the Solution ControlMaximum Iterations when performing goal seeking.
32 AFT Fathom 7.0 Modules User’s Guide
GSC data differences across scenarios
8/17/2019 Fathom 7 0 Modules Guide
46/202
GSC variables and goals will appear in all scenarios. In other words, you
cannot create a variable or goal that will appear in some scenarios andnot others. However, the application of variables and goals can differfrom scenario to scenario. This allows you to perform goal seeking withdifferent variables and goals across scenarios.
Variable and goal
application can differbetween scenarios
Figure 2.15 Goal Seek and Control Manager allows one to applyand unapply variables and goals. The application of
goals and variables can be modified betweenscenarios.
C H A P T E R 3
8/17/2019 Fathom 7 0 Modules Guide
47/202
C H A P T E R 3
Goal Seek and Control Example
This example demonstrates the fundamental concepts of the Goal Seekand Control (GSC) add-on module by way of example. The exampleshows how GSC can be used to size pumps as part of a system designprocess.
A number of other GSC example model discussions are included in aHelp file distributed with AFT Fathom called FathomExamples.hlp. Itcan be opened from the Help menu by choosing “Show Examples”.
Note: This example can only be run if you have a license for the GSCmodule.
Topics covered
• Using Goal Seek and Control Manager
• Defining GSC Variables and Goals
• Using pump head rise as a GSC Variable
• Using Group Max/Min goals
Required knowledge
This example assumes that the user has some familiarity with AFTFathom such as placing junctions, connecting pipes, entering pipe and
34 AFT Fathom 7.0 Modules User’s Guide
junction specifications, global editing, and creating groups. Refer to theAFT F th U ' G id f i f ti th t i
8/17/2019 Fathom 7 0 Modules Guide
48/202
AFT Fathom User's Guide for more information on these topics.
Model file
This example uses the following file, which is installed in the Examplesfolder as part of the AFT Fathom installation:
• Pump Sizing and Selection with FCV.fth (GSC Example Scenario) –AFT Fathom model file
Problem statement
The piping for a heat exchanger system is being designed. The systemwill pump supply water from a tank pressurized to 10 psig with a liquidsurface elevation of 5 feet to a receiving tank with a pressure of 30 psig
and a liquid surface elevation of 10 feet. The heat exchangers operate inparallel. The flow through the heat exchangers is controlled to 100gal/min by two flow control valves. There is a design requirement thatthe control valves have a minimum pressure drop of 5 psid.
Use GSC to size the pump.
Step 1. Start AFT Fathom
From the Start menu, choose AFT Products and AFT Fathom.
Step 2. Specify system properties
1. Open the System Properties window by selecting System Propertiesin the Analysis menu
2. On the Fluid Data Tab, select the AFT Standard database and thenselect “water at 1 atm” in the fluids available window
3. Click “Add to Model” to select water for use in this model
4. Type in 70 degrees in the fluid temperature box
5. Click “Calculate Properties”
8/17/2019 Fathom 7 0 Modules Guide
49/202
36 AFT Fathom 7.0 Modules User’s Guide
Pipe Length
(feet)
Size Type
8/17/2019 Fathom 7 0 Modules Guide
50/202
(feet)
P1 20 2 inch Schedule 40
P2 50 2 inch Schedule 40
P3 60 2 inch Schedule 40
P4 20 2 inch Schedule 40
P5 100 2 inch Schedule 40
P6 20 2 inch Schedule 40P7 60 2 inch Schedule 40
P8 20 2 inch Schedule 40
P9 100 2 inch Schedule 40
C. Enter the junction data
J1 Reservoir
1. Name = Supply Tank
2. Tank Model = Infinite Reservoir (only visible if XTS module isenabled)
3. Liquid Surface Elevation = 5 ft4. Surface pressure = 10 psig
5. Pipe Depth (on Pipe Depth and Loss Coefficients tab) = 5 ft
J9 Reservoir
1. Name = Receiving Tank
2. Tank Model = Infinite Reservoir (only visible if XTS module isenabled)
3. Liquid Surface Elevation = 10 ft
4. Surface pressure = 30 psig
5. Pipe Depth (on Pipe Depth and Loss Coefficients tab) = 10 ft (forboth pipes)
Chapter 3 Goal Seek and Control Example 37
J3 Tee
1 Elevation = 0 feet
8/17/2019 Fathom 7 0 Modules Guide
51/202
1. Elevation = 0 feet
2. Loss Model = simple
J6 Elbow
1. Elevation = 0 feet
2. Type = standard
J4, J7 Control Valves1. Elevation = 0 feet
2. Valve Type = Flow Control
3. Flow rate = 100 gpm
Using the Groups tool on the Edit menu, add the control valves to agroup named Flow Control Valves.
J5, J8 Heat Exchangers
1. Elevation = 0 feet
2. Loss Model = Resistance Curve
3. Loss Curve Data = 10 psid @ 100 gal/min
J2 Pump
1. Elevation = 0 feet
2. Pump Model = Fixed Head Rise
3. Fixed Head Rise = 20 feet
D. Check if the pipe and junction data is completeTurn on Show Object Status from the View menu to verify that all thenecessary data is entered. If so, the “Define Pipes and Junctions”checklist item will have a check mark. If not, the uncompleted pipes or junctions will have their number shown in red. If this happens, go backto the uncompleted pipes or junctions and enter the missing data. Youcan also open the List Undefined Objects window from the View menu
to see what data is missing.
38 AFT Fathom 7.0 Modules User’s Guide
Step 4. Open the Goal Seek and Control Manager
8/17/2019 Fathom 7 0 Modules Guide
52/202
The GSC data is entered in the Goal Seek and Control Manager window.
Open the Goal Seek and Control Manager from the View Menu. Afteropening the Goal Seek and Control Manager, the user specifies all of thesystem variables, as well as the desired goals. The Goal Seek andControl Manager is shown in Figure 3.2 below.
Figure 3.2 The Goal Seek and Control Manager is used to defineGSC Variables and Goals.
Step 5. Add a variable
In the GSC module, variables are the parameters that AFT Fathom willmodify in order to achieve the specified goals. In general there should beone applied variable for each applied goal.
Select the Variables tab on the Goal Seek and Control Manager window.The Variables tab allows users to create and modify the systemvariables. The object and junction type are selected, then the name and
Chapter 3 Goal Seek and Control Example 39
number of the object to which the variable applies, and the objectparameter that is to be varied are specified on the Variables tab.
8/17/2019 Fathom 7 0 Modules Guide
53/202
For this example, you will be adding a variable for the Pump Fixed Head
Rise. Select the “Add Variable” button, and input the following variabledata:
1. Apply: Selected
2. Object Type: Junction
3. Junction Type: Pump
4. Junction Number and Name: J2 (Pump)5. Variable Parameter: Head Rise
6. Link To: (None)
7. Lower Bound: Leave Blank
8. Upper Bound: Leave Blank
The Apply column allows users to specify which of the variables thathave been defined will be used. This allows the flexibility of creatingmultiple variable cases, while only applying selected variables for anygiven run.
The Link To column allows users to apply the same variable to multipleobjects. This allows users to force parameters for several objects to bevaried identically.
Upper and lower bounds provide logical extremes during the goalsearch. For this case, leave the lower and the upper bounds blank.
After entering the data, the Variable tab should appear as shown inFigure 3.3.
Step 6. Add a goalGoals are the parameters you want to achieve. The goals are achieved asAFT Fathom modifies the variables. Typically, there should be oneapplied goal for each applied variable.
40 AFT Fathom 7.0 Modules User’s Guide
8/17/2019 Fathom 7 0 Modules Guide
54/202
Figure 3.3 GSC Variables are parameters that are changed by
AFT Fathom to achieve the defined goals.
Select the Goals tab on the Goal Seek and Control Manager window.The Goals tab allows users to create and modify the system goals. Thegoal type, object type, and the goal parameter are selected. A criterion
for determining if the goal has been met is then specified, along with avalue and units for the goal parameter. The user then selects the object towhich the goal applies, and, if applicable, the location on the object atwhich the goal applies (e.g., the inlet or outlet of a pipe object).
The Apply column allows users to specify which of the goals that havebeen defined will be used. This allows the flexibility of creating multiplegoal cases, while only applying selected goals for any given run.
A Group Max/Min goal allows a single goal to be applied to a group ofobjects. Fathom applies a Group Max/Min goal by ensuring the finalgoal value is either greater than or equal to (a Min goal) or less then orequal to (a Max goal) the specified value. For this example, a GroupMax/Min goal will be applied to ensure the minimum pressure dropacross the flow control valves is at least 5.0 psid.
Chapter 3 Goal Seek and Control Example 41
Create a new goal for the pressure drop across the flow control valves asdefined below (if the option for a group goal is not visible you may havef di d i S 3 b )
8/17/2019 Fathom 7 0 Modules Guide
55/202
forgotten to create a group as discussed in Step 3c above):
1. Apply: Selected
2. Goal Type: Group
3. Object Type: Group Max/Min
4. Goal Parameter: Pressure Loss
5. Criteria: >=
6. Goal Value: 5
7. Goal Units: psid
8. Object ID: Flow Control Valves (this is the name of the group)
9. Object Location: NA
After entering the data, the Goals tab should appear as shown in Figure
3.4.
Figure 3.4 GSC Goals are the parameter values the user wants toachieve.
42 AFT Fathom 7.0 Modules User’s Guide
As variables and goals are added to a model, AFT Fathom will displaysymbols beside the pipes and junctions that have variables or goals
li d t th Th d f lt i “V” f i bl d “G” f l
8/17/2019 Fathom 7 0 Modules Guide
56/202
applied to them. The default is a “V” for variables, and a “G” for goals.
The goal symbol is not displayed next to objects that are part of a groupgoal. This is illustrated in Figure 3.5. These symbols can be configuredon the Workspace Preferences window.
“V” symbol for a
GSC Variable.
“G” symbols for
GSC Goals arenot displayed for
Group goals.
Figure 3.5 AFT Fathom displays symbols next to objects on theWorkspace that have goals or variables defined.
Step 7. View GSC settings in Model Data
The Model Data window provides a summary of the GSC modulevariable and goal definitions. Once the variable and goal information hasbeen added in the Goal Seek and Control Manager, the information isdisplayed on the Goal Seek and Control tab in the General section of theModel Data Window. Figure 3.6 shows the GSC variable and goal
information as it was entered for this example.
Chapter 3 Goal Seek and Control Example 43
8/17/2019 Fathom 7 0 Modules Guide
57/202
Figure 3.6 The Goal Seek and Control parameters defined in theGoal Seek and Control Manager are displayed in theGeneral section of the Model Data window.
Step 8. Enable goal seeking
After the GSC goals and variables have been defined, goal seeking mustbe enabled using the Analysis menu, as shown in Figure 3.7.
Step 9. Run the modelSelect Run Model in the Analysis menu. This will open the SolutionProgress window. This window allows you to watch as the AFT FathomSolver converges on the answer.
Note: When using the GSC module there is an area displayed in
Solution Progress that shows the specific progress of the GSC module.As it makes progress, the Best (Lowest) value will decrease towardszero. The field in the far right displays how many complete hydraulicsolutions have been run.
After completion, click the View Output button at the bottom of theSolution Progress window.
44 AFT Fathom 7.0 Modules User’s Guide
8/17/2019 Fathom 7 0 Modules Guide
58/202
Figure 3.7 Select “Use” from the Goal Seek & Control menu itemon the Analysis menu to instruct AFT Fathom to dogoal seeking when it runs.
Step 10. Examine the results
The Output window contains all the data that was specified in the Ou