The Simulation Options dialog box is used to adjust some facets of a model prior to running it. Simulation options are usually associated with specific scenarios.
For example, suppose you would like to specify a global bulk chlorine decay of -0.5 for one simulation and have another simulation with a decay of -0.7. This can be accomplished through the Simulation Options, where one option can be tied to one scenario while another set of options is specified for a different scenario.
The Simulation Options dialog box, used to modify sets or instances of simulation options, can be accessed from the Operation tab of the Model Explorer or from the Simulation Options' Browse button in the Run Manager.
ID and Description
The Simulation Options ID and Description area shows the name and description of the defined options. The green tic on the ID folder indicates which set of options is currently active.
Hydraulics - The options in this group are related to physical variables and units used in the governing hydraulic equations.
Headloss Equation - Determines which headloss equation (Hazen-Williams, Darcy-Weizbach, Chezy-Manning) is used in pipes. The choice of equation also determines how the Roughness attribute of pipes is interpreted.
Convergence Criteria - The options in this group are related to the conditions under which the hydraulic solver is terminated.
Maximum Trials - The maximum number of iterations of the global gradient algorithm used to solve the nonlinear hydraulic equations for each time step of the simulation. The suggested value is 40. A more complex system may require more trials increase the simulation time.
If the system to be modeled consistently results in an unbalanced solution, it may be useful to adjust the maximum trials or the convergence criteria. If sensible convergence criteria cannot be met in 100 or 200 iterations, the model may not be solvable. Check the simulation report for warning and error messages.
Relative Flow Error - Main convergence criterion used to determine whether the hydraulic solver has found a satisfactory solution to the governing nonlinear equations. The relative flow error is the ratio between the change in the estimates of flow between the last two iterations of the algorithm, and the total aggregated flow in the network. If this error is smaller than or equal to the selected value, the simulation ends for that time step. The suggested value is 0.001 (0.1%).
A smaller value will provide a more accurate solution, but it will usually require more trials thus increasing run time. A larger number will result in less accurate solutions and will likely require fewer iterations.
Load/Save Hydraulic File - Used to indicate whether to save the hydraulic solution file for a posterior simulation, or to use previously saved hydraulic solution file in the upcoming simulation. If the Use or Save options are selected, the Hydraulic File (.hyd) path and name must be specified in the Hydraulic File field.
Hydraulic File - The external path and file name for the Hydraulic File (.hyd) file that is to be used for the Load/Save Hydraulic File option.
Working Folder - The working folder only applies when the Load/Save Hydraulic File option is set to None. It represents the network directory that is to be used for writing the model report. If an error occurs during a model run, useful information could be found in the output model report file in the directory specified here.
Global Demand Multiplier - The Global Demand Multiplier is used to assign a multiplier by which all demand is to be multiplied. For example, a MAXDAY model scenario may have a global demand multiplier of 2.5. All demands would be multiplied by a factor of 2.5.
Emitter Exponent - The value to be assigned as the pressure exponent (g gamma) for the emitter equation , where q is the emitter flow and C is the emitter coefficient at each junction. When modeling leaks, a value of 0.5 is common for rigid pipes, while a value of 0.7 can be used for flexible pipes (where the size of the orifices might change as pressure increases).
Demand Pattern Type - The type of pattern to be used for demand multipliers. Between time-steps, two options are available for representing usage factors between regular fixed periods in time:
Stepwise – A constant usage factor from one fixed period of time to the next is assumed.
Continuous – Multipliers are linearly interpolated between fixed time periods.
Default Demand Pattern - A default demand pattern that is to be applied to all junctions that do not have a specific pattern selected. Use the Browse button to enter the Pattern dialog box.
Run Energy Management Simulation - This box must be checked to run an energy management simulation.
Global Pump Efficiency - Use this value to assign a global efficiency to all pumps.
Global Energy Price - The energy rate is defined as the cost per unit of energy usage ($/kWh). Enter a $ value to represent the unit price of electricity.
Global Energy Price Pattern - The pattern defines the cost per unit of energy based on time of day. Specify the pattern for which energy is being purchased (electricity price schedule). Use the Browse button to select a pattern.
Global Demand Charge - Demand (or capacity) charge is defined as the cost associated with the maximum power consumed within the charging (billing) period ($/max. kW). This is a one-time charge due to peak power used during each billing period. Specify a cost for which energy penalties are being levied during peak conditions.
In order to run an Energy Management Simulation, you would need to check the Run Energy Management Simulation check box.
Status Check Frequency - The Status Check Frequency setting will check status of all control elements at every Check Frequency iterations (default value is 2).This sets the number of solution trials that pass during hydraulic balancing before the status of pumps, check valves, flow control valves and pipes connected to tanks are once again updated. The default value is 2, meaning that status checks are made every other trial. A value equal to the maximum number of trials would mean that status checks are made only after a system has converged. (Whenever a status change occurs the trials must continue since the current solution may not be balanced.) The frequency of status checks on pressure reducing and pressure sustaining valves (PRVs and PSVs) is determined by the Damping Limit option (see below).
Max. Status Check Iteration - The program will stop checking status of all control elements after Maximum Status Check Iterations setting is reached. The default value is 10. This is the number of solution trials after which periodic status checks on pumps, check valves flow control valves and pipes connected to tanks are discontinued. Instead, a status check is made only after convergence is achieved. The default value is 10, meaning that after 10 trials, instead of checking status every Status Check Frequency trials, status is checked only at convergence.
Relaxation Factor - This is a relaxation factor parameter for determining the new solution (flow rate) at each iteration as follows:
New Q = previous Q + Relaxation Factor * Delta Q
The default value is 1.
Note: The role of relaxation factor.
The new solution (flow rate) at each iteration of the solution engine is:
New Q = Previous Q + Relaxation Factor * Delta Q (Q increment).
Based on the Newton-Raphson (NR) solution method, this is exactly same idea with relaxation factor = 1. On comparison to the other numerical method, the main advantage of NR method is its speed and efficiency to converge upon a solution. However, it also has a disadvantage of a high level of divergence (where it can not find a solution). As a numerical aid to reduce the chance of divergence, we can add a relaxation factor (usually 0.6 to 1). This simply decreases the Delta Q (increment). By adding a small relaxation factor (decreasing Q increment), the model tends to provide a more stable solution, but, obviously, with a slower computational speed. Therefore, the relaxation factor is a trade off between computation speed and model stability. The reason we changed the default of relaxation factor as 1 is to provide faster computation times. However, it may increase the chance of reaching a simulation failure (in most cases, it should be fine). Currently, the EPANET engine uses 0.6 as a relaxation factor.
To summarize, if you have a simulation failure that used to run in a previous version, please consider changing the relaxation factor into 0.6. Also, consider doubling the Status Check Frequency to four and change the Maximum Status Check Iteration to a value between 4 and 20 to reach a solution.
Damping Limit - Must be equal to or greater than zero. This is the accuracy value at which solution damping and status checks on PRVs and PSVs should begin. Damping limits all flow changes to 60% of what they would otherwise be as future trials unfold. The default is 0 which indicates that no damping should be used and that status checks on control valves are made at every iteration. Damping might be needed on networks that have trouble converging, in which case a limit of 0.01 is suggested.
Frequent status checking; tends to produce solutions in the least number of iterations.
Example: Check Frequency = 2, Max Status Check = 10, Damping Limit = 0
Less frequent status checking; might be needed for networks that have difficulty in converging.
Example: Check Frequency = 10, Max Status Check = 100, Damping Limit = 0.01
Status checks made only after convergence is achieved; might produce convergence when other settings fail.
Example: Check Frequency = Max trials, Max Status Check = Max Trials, Damping Limit = Convergence Accuracy
Maximum Allocated Threads for WQ Simulation - This option controls the management of shared-memory and the synchronization of parallel computation processes (threads) for the water quality simulation. Multiple processing units (processors or cores) can now share the intensive computational demand often required by a water quality simulation. For computationally intensive simulations, the saving in computation time can be more than 30% for a dual-core processor machine. The Default setting allows the water quality simulation to utilize as many parallel threads as are currently available. You can limit the thread allocation by specifying the desired maximum number of the computational threads, from 1 to 8, in order to reserve the desired processing power for other applications.
Allow Disconnection Run: When this option is checked on, InfoWater Pro removes demands of disconnected junctions when disconnection occurs at certain hydraulic time step, therefore allowing the simulation run to continue. After a successful disconnection run InfoWater Pro will report the disconnection status on pipes and demand loss on junctions. By default this option is checked off.
Balance Model Element Continuity - This option allows you to perform comprehensive flow continuity check on individual model elements at the end of each hydraulic time step.
Continuity Check - Select this to enable the flow balance continuity check.
Flow Tolerance - Flow balance tolerance at individual model element.