Variables Panel
(GSC Module Only) The Variables panel is where variables are defined and applied for use with the GSC module (Figure 1). Variables are input parameters that the GSC module will change to achieve the user's desired goals. Generally, there must be one variable applied for each goal that is applied.
Figure 1: GSC Variables are input parameters to be automatically varied
Types of Variables
All variables are junction or pipe parameters. The variables that are available for each object type are shown in Table 1. There are over 30 types of variables.
Table 1: List of object types with available variables
Object Type | Variables | Restrictions |
Pipes |
Design Factor Friction ID Reduction (Scaling) Insulation Thickness |
|
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 Setpoint | |
General Component | Loss Factor | |
Heat Exchanger |
Loss Factor Heat Rate Discharge Temperature Temperature Rise Enthalpy Rise Heat Transfer Area Overall Heat Transfer Coefficient Secondary Flow Secondary Inlet Temperature |
Only with Heat Transfer Only with Heat Transfer Only with Heat Transfer Only with Heat Transfer Only with Heat Transfer Only with Heat Transfer Only with Heat Transfer Only with Heat Transfer |
Orifice |
Diameter/Area Loss Factor Elevation |
|
Pump |
Speed Flow Head 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 (Fire Sprinkler) Number Sprinklers Number Sparger Holes Elevation |
|
Three-Way Valve | Open Percentage | |
Valve |
Loss Value Elevation (Exit Valves) |
Only for Exit Valves |
Creating and Deleting Variables
To create a variable, click the New Variable button on the Variables panel (Figure 1). This will insert a new item into the variable list. After the variable has been added, the variable data is defined by entering the necessary data in each of the data columns.
Variables may also be added by duplicating an existing variable, then modifying the data for the new variable. To duplicate a variable, select the 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 appropriate row in the variable list. After selecting the variable to be deleted, click the Delete Variable button. If you want to delete all of the variables in the list, click the Delete All Variables button.
Defining Variables
For each variable the following settings can be defined:
-
Object type - The Object Type defines whether the variable applies to a pipe or a junction.
-
Junction type - The Junction Type column is used to define the type of junction to which the variable is being applied.
-
Object number and name - The specific junction to vary is selected in the Junction Number and Name column. The list will only display junctions of the type selected in the Junction Type column.
-
Variable parameter - Each junction type has a specific set of parameters that are available as variables (Table 1). The list will only display parameters that are available for the junction type selected in the Junction Type column.
-
Linking variables - The Link To column is used to force a variable on multiple junctions of the same type to solve to the same value.
-
Variable bounds - During a goal search, the GSC module will modify the values for the defined 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 lower and upper bounds on valve open percentage of 0% and 100%, respectively.
An example where this would be desirable would be when using pump impeller trim as a variable for several pumps in parallel. It is often desirable to solve for a condition where the pump impeller trim is the same for all of the pumps. This can be accomplished by using variable linking. A pump impeller trim variable would be defined for each of the pumps. Then, one of the pumps would be selected as the basis pump, which just means no linking is specified for this pump. The other pumps would be linked to the basis pump by selecting the basis pump from the list in the Link To column.
Note that bounds can have engineering units, but these units are not displayed. It is assumed the units are the same as the junction input parameter Properties Window.
Organizing Content
The lower left corner of the panel features options for rearranging and selecting variables and goals. All will select all available variable or goals. None will deselect all variables or goals. Invert will invert which variables and goals are selected. There are also options to show all variables or goals and to show only the applied variables or goals. The goals and variables can also be reordered using the turquoise arrows to change their position.
The Same As Parent button allows the variables, goals, numerical control, or all of the parameters (in regards to the Goal Seek and Control group) of the parent scenario to be copied down to the child scenario.
Reviewing Pipe/Junction Data
Data for the selected objects in the Variables panel can be reviewed and edited without having to close the Analysis Setup window.
-
Reviewing object input data - If you would like to see the input data for the junction selected as a variable, press the right mouse button on the far left column in the Variables table. The inspection window will display, showing you the input data.
-
Editing object input data - Similar to the inspection feature just described, you can open the Pipe or Junction Properties window by double-clicking the far left column in the Variables table. From there you can change any data desired.
Applying Variables
Once a variable has been created, the user must specify if a variable is to be used when the GSC module is run. To apply a variable, select the checkbox in the Apply column.
Using the Apply feature allows the user to define multiple variables that can be used in alternate cases or analyses. Any of the variables that are not being used for a particular analysis can remain in the list for later use. Click the Apply checkbox for the variables that are to be used in the current analysis.