& Construction
![architecture engineering and construction collection logo](https://damassets.autodesk.net/content/dam/autodesk/www/universal-header/flyout/architecture-engineering-construction-collection-uhblack-banner-lockup-364x40.png)
Integrated BIM tools, including Revit, AutoCAD, and Civil 3D
& Manufacturing
![product design manufacturing collection logo](https://damassets.autodesk.net/content/dam/autodesk/www/universal-header/flyout/product-design-manufacturing-collection-uhblack-banner-lockup-364x40.png)
Professional CAD/CAM tools built on Inventor and AutoCAD
Integrated BIM tools, including Revit, AutoCAD, and Civil 3D
Professional CAD/CAM tools built on Inventor and AutoCAD
Transcript
00:04
Info Water Pro offers many simulation types
00:07
including standard simulation of hydraulics and water quality
00:10
pipe break analyses,
00:12
firef flow and multi fire flow analysis. SCADA data integration,
00:16
hydrant capacity assessments
00:18
and pump capacity analyses.
00:21
You can perform these simulations in the run manager and all
00:24
of them are based on the EPA A net engine.
00:27
While using Info
00:28
Water Pro,
00:29
it can be useful to learn why your simulation
00:31
ran successfully or failed to converge to a solution.
00:35
There are settings messages and reports that can help
00:38
you to fix errors and run better simulations.
00:43
A good starting tip is to keep a design log of all your simulations.
00:46
So you can refer back to it when similar issues occur.
00:50
The more models you build the easier these errors are to resolve.
00:55
The run manager provides a color coded stoplight as a
00:57
visual reference to know the status of your run simulation
01:02
depending on the color of the spotlight.
01:04
There are different ways you can go about troubleshooting failed simulations.
01:09
A green stoplight represents a good run of your simulation.
01:12
You did not receive any warnings.
01:15
A gray stoplight indicates that your simulation did not run at all.
01:18
No output was produced.
01:21
This usually occurs when info
01:23
water pro is unable to create the EPA net input file due to bad or missing data.
01:29
You can start troubleshooting by looking at any pop-up
01:31
messages and reviewing the message board for errors,
01:35
error messages indicate the key data ids of elements to fix.
01:40
You may see the message missing input data which includes common error, 200 codes.
01:45
If so you may have illegal or missing data.
01:48
For example,
01:49
pipe roughness length and diameter must be non zero.
01:54
The tank initial level must be less than maximum level and more than minimum level.
02:00
The valve pump tank or reservoir type field may not be specified
02:06
if you see the message object refers to undefined element.
02:10
This is often a pipe with an inactive node
02:13
missing pattern or curve referenced means that you should change
02:16
the curve or pattern used or create the missing one.
02:19
If you see bad input data, then you should check your object data such as
02:25
invalid pump curve. The curve values must decrease in head as flow increases
02:31
missing tanker reservoir.
02:33
The model must have at least one water source
02:35
control on a check valve pipe.
02:37
No controls or initial status should be found on a check valve
02:42
orphan node.
02:43
Make sure the node is connected to the system
02:47
direction of pipes connected to pumps or valves.
02:50
Make sure that both pipes are in the direction of flow.
02:53
A red stoplight indicates that your simulation failed to converge to a solution.
02:58
You need to reconfigure your simulation for it to run correctly.
03:02
There are multiple possible reasons why the model did not solve.
03:06
If you see input data issues,
03:08
these issues may be similar to the missing or
03:10
bad data errors that result in a gray stoplight.
03:13
Review the message board to see the element ids. You need to fix
03:18
model. Convergence issues may result in a max trial's exceeded warning.
03:23
Convergence failure is often due to
03:26
elements fighting for control of the hydraulic grade line H G L
03:30
pressure reducing valves, prvs or other elements fighting
03:35
switching check valves and unstable simple controls,
03:40
changing convergent settings can help a model converge
03:44
in the run manager on the standard tab click simulation options
03:49
in the simulation options.
03:50
Dialogue on the general tab, adjust the convergence criteria settings,
03:56
maximum trials
03:57
generally if no solution is found in 200 trials, it will not solve
04:03
relative flow error. Epa net accuracy
04:07
keep between 0.1 and 0.1.
04:12
After max trials, epa net unbalanced
04:16
choose stop to stop the run completely or continue to allow extended trials,
04:22
extended run trials set as 10 to 50 max
04:26
in the advanced tab.
04:28
There are other settings that may help solve convergence issues.
04:32
Relaxation factor.
04:34
A value of 0.6 is better to use if you have convergence issues.
04:38
As this is the EPA net default
04:40
stamping limit
04:42
set at 10 times the relative flow error setting
04:45
status check and max status check,
04:48
leaving these of their default values is recommended
04:51
if these are changed, it can cause unexpected run issues
04:55
allow a disconnected run
04:56
check to see the results from connected elements
05:00
to research and resolve simulation failures.
05:03
It is also helpful to view the full hydraulic status report
05:07
in the run manager on the standard tab. Click the report options, browse button
05:13
in the simulation report,
05:14
dialogue set the hydraulic status to full so that the status
05:17
report includes information from each trial of each hydraulic analysis.
05:22
This level of detail is useful for
05:24
debugging networks that become hydraulically unbalanced.
05:28
It is also useful to leave generate
05:30
network summary table and generate warning messages selected
05:35
after a successful or failed run.
05:37
Click the report icon to open the full hydraulic status report.
05:41
Here you can view the following
05:43
a summary of the run settings.
05:45
Details of each trial and relative flow change per trial
05:49
element status changes
05:52
a summary of supply demand and storage and a list of statuses at the end of a run
05:59
to debug or troubleshoot failed simulations.
06:01
Search for warning and caution in the report.
06:05
Investigate each warning and caution message by the element id.
06:09
Some common messages include maximum trials exceeded the
06:13
program was unable to reach its convergence goal.
06:15
Pump can't deliver head.
06:17
A
06:17
pump is at shut off
06:19
pump can't deliver flow.
06:22
A pump is past the last point of a multi point curve.
06:25
Disconnected nodes
06:27
it cannot satisfy the demand.
06:28
As closed elements are cutting the nodes off from a known head.
06:31
FCV can't deliver flow.
06:34
There is not enough head to drive flow
06:37
in the report,
06:38
you can also look for repeated status changes of elements such as open to closed,
06:43
closed to active and active to open.
06:47
Depending on the elements that have been identified. You can investigate further
06:51
valdes.
06:53
This often indicates which elements are fighting for control.
06:57
Pump I DS
06:58
can indicate instability or pump curve issues.
07:01
Make sure that the pump curve has a shut off head
07:04
at zero flow or it may keep turning on and off.
07:07
PRV I DS.
07:09
Instability may only be seen at higher flows.
07:12
Check the valve setting HGL for each valve
07:15
check valve ids
07:17
investigate why these are opening and closing
07:20
other keywords to search for
07:23
temporarily closed.
07:25
This could be a tank that is switching between empty and full
07:28
review the tank filling controls and investigate if there
07:31
are zone interface elements that were accidentally opened,
07:35
disconnected nodes,
07:37
either demand cannot be met or there is no path to a known HGL.
07:43
A yellow stoplight indicates your run did not
07:45
meet the standards of a good simulation.
07:48
You need to review and potentially fix the warning messages
07:51
found on the warnings pop up or message board.
07:54
In
07:54
this case,
07:55
you can troubleshoot using the partial output
07:57
found in the full hydraulic status report.
08:01
Look at the last hour and other key areas to diagnose why the run did not complete.
08:06
A simple test is to add all tanks into a domain and use a tank group graph on the domain
08:12
tanks going 0% or 100% full.
08:15
Just before run failure indicate where the issue resides.
08:19
Review the controls for the elements that are
08:21
draining and filling those tanks for errors.
Video transcript
00:04
Info Water Pro offers many simulation types
00:07
including standard simulation of hydraulics and water quality
00:10
pipe break analyses,
00:12
firef flow and multi fire flow analysis. SCADA data integration,
00:16
hydrant capacity assessments
00:18
and pump capacity analyses.
00:21
You can perform these simulations in the run manager and all
00:24
of them are based on the EPA A net engine.
00:27
While using Info
00:28
Water Pro,
00:29
it can be useful to learn why your simulation
00:31
ran successfully or failed to converge to a solution.
00:35
There are settings messages and reports that can help
00:38
you to fix errors and run better simulations.
00:43
A good starting tip is to keep a design log of all your simulations.
00:46
So you can refer back to it when similar issues occur.
00:50
The more models you build the easier these errors are to resolve.
00:55
The run manager provides a color coded stoplight as a
00:57
visual reference to know the status of your run simulation
01:02
depending on the color of the spotlight.
01:04
There are different ways you can go about troubleshooting failed simulations.
01:09
A green stoplight represents a good run of your simulation.
01:12
You did not receive any warnings.
01:15
A gray stoplight indicates that your simulation did not run at all.
01:18
No output was produced.
01:21
This usually occurs when info
01:23
water pro is unable to create the EPA net input file due to bad or missing data.
01:29
You can start troubleshooting by looking at any pop-up
01:31
messages and reviewing the message board for errors,
01:35
error messages indicate the key data ids of elements to fix.
01:40
You may see the message missing input data which includes common error, 200 codes.
01:45
If so you may have illegal or missing data.
01:48
For example,
01:49
pipe roughness length and diameter must be non zero.
01:54
The tank initial level must be less than maximum level and more than minimum level.
02:00
The valve pump tank or reservoir type field may not be specified
02:06
if you see the message object refers to undefined element.
02:10
This is often a pipe with an inactive node
02:13
missing pattern or curve referenced means that you should change
02:16
the curve or pattern used or create the missing one.
02:19
If you see bad input data, then you should check your object data such as
02:25
invalid pump curve. The curve values must decrease in head as flow increases
02:31
missing tanker reservoir.
02:33
The model must have at least one water source
02:35
control on a check valve pipe.
02:37
No controls or initial status should be found on a check valve
02:42
orphan node.
02:43
Make sure the node is connected to the system
02:47
direction of pipes connected to pumps or valves.
02:50
Make sure that both pipes are in the direction of flow.
02:53
A red stoplight indicates that your simulation failed to converge to a solution.
02:58
You need to reconfigure your simulation for it to run correctly.
03:02
There are multiple possible reasons why the model did not solve.
03:06
If you see input data issues,
03:08
these issues may be similar to the missing or
03:10
bad data errors that result in a gray stoplight.
03:13
Review the message board to see the element ids. You need to fix
03:18
model. Convergence issues may result in a max trial's exceeded warning.
03:23
Convergence failure is often due to
03:26
elements fighting for control of the hydraulic grade line H G L
03:30
pressure reducing valves, prvs or other elements fighting
03:35
switching check valves and unstable simple controls,
03:40
changing convergent settings can help a model converge
03:44
in the run manager on the standard tab click simulation options
03:49
in the simulation options.
03:50
Dialogue on the general tab, adjust the convergence criteria settings,
03:56
maximum trials
03:57
generally if no solution is found in 200 trials, it will not solve
04:03
relative flow error. Epa net accuracy
04:07
keep between 0.1 and 0.1.
04:12
After max trials, epa net unbalanced
04:16
choose stop to stop the run completely or continue to allow extended trials,
04:22
extended run trials set as 10 to 50 max
04:26
in the advanced tab.
04:28
There are other settings that may help solve convergence issues.
04:32
Relaxation factor.
04:34
A value of 0.6 is better to use if you have convergence issues.
04:38
As this is the EPA net default
04:40
stamping limit
04:42
set at 10 times the relative flow error setting
04:45
status check and max status check,
04:48
leaving these of their default values is recommended
04:51
if these are changed, it can cause unexpected run issues
04:55
allow a disconnected run
04:56
check to see the results from connected elements
05:00
to research and resolve simulation failures.
05:03
It is also helpful to view the full hydraulic status report
05:07
in the run manager on the standard tab. Click the report options, browse button
05:13
in the simulation report,
05:14
dialogue set the hydraulic status to full so that the status
05:17
report includes information from each trial of each hydraulic analysis.
05:22
This level of detail is useful for
05:24
debugging networks that become hydraulically unbalanced.
05:28
It is also useful to leave generate
05:30
network summary table and generate warning messages selected
05:35
after a successful or failed run.
05:37
Click the report icon to open the full hydraulic status report.
05:41
Here you can view the following
05:43
a summary of the run settings.
05:45
Details of each trial and relative flow change per trial
05:49
element status changes
05:52
a summary of supply demand and storage and a list of statuses at the end of a run
05:59
to debug or troubleshoot failed simulations.
06:01
Search for warning and caution in the report.
06:05
Investigate each warning and caution message by the element id.
06:09
Some common messages include maximum trials exceeded the
06:13
program was unable to reach its convergence goal.
06:15
Pump can't deliver head.
06:17
A
06:17
pump is at shut off
06:19
pump can't deliver flow.
06:22
A pump is past the last point of a multi point curve.
06:25
Disconnected nodes
06:27
it cannot satisfy the demand.
06:28
As closed elements are cutting the nodes off from a known head.
06:31
FCV can't deliver flow.
06:34
There is not enough head to drive flow
06:37
in the report,
06:38
you can also look for repeated status changes of elements such as open to closed,
06:43
closed to active and active to open.
06:47
Depending on the elements that have been identified. You can investigate further
06:51
valdes.
06:53
This often indicates which elements are fighting for control.
06:57
Pump I DS
06:58
can indicate instability or pump curve issues.
07:01
Make sure that the pump curve has a shut off head
07:04
at zero flow or it may keep turning on and off.
07:07
PRV I DS.
07:09
Instability may only be seen at higher flows.
07:12
Check the valve setting HGL for each valve
07:15
check valve ids
07:17
investigate why these are opening and closing
07:20
other keywords to search for
07:23
temporarily closed.
07:25
This could be a tank that is switching between empty and full
07:28
review the tank filling controls and investigate if there
07:31
are zone interface elements that were accidentally opened,
07:35
disconnected nodes,
07:37
either demand cannot be met or there is no path to a known HGL.
07:43
A yellow stoplight indicates your run did not
07:45
meet the standards of a good simulation.
07:48
You need to review and potentially fix the warning messages
07:51
found on the warnings pop up or message board.
07:54
In
07:54
this case,
07:55
you can troubleshoot using the partial output
07:57
found in the full hydraulic status report.
08:01
Look at the last hour and other key areas to diagnose why the run did not complete.
08:06
A simple test is to add all tanks into a domain and use a tank group graph on the domain
08:12
tanks going 0% or 100% full.
08:15
Just before run failure indicate where the issue resides.
08:19
Review the controls for the elements that are
08:21
draining and filling those tanks for errors.
Learn why your InfoWater Pro simulation ran successfully or failed to converge to a solution. There are settings, messages, and reports that can help you to fix errors and run better simulations.
TIP: Keep a design log of all your simulations, so you can refer back to it when similar issues occur. The more models you build, the easier these errors are to resolve.
The Run Manager provides a color-coded stoplight as a visual reference to know the status of your run simulation.
A green stoplight represents a good run of your simulation. You did not receive any warnings.
A gray stoplight indicates that your simulation did not run at all; no output was produced due to bad or missing data. Review any popup messages and the Message Board for errors. Error messages indicate the key data IDs of elements to fix.
A red stoplight indicates that your simulation failed to converge to a solution. You need to reconfigure your simulation for it to run correctly. There are multiple possible reasons why the model did not solve.
Changing convergence settings can help a model converge.
To research and resolve simulation failures, view the full Hydraulic Status Report:
After a successful or failed run:
A yellow stoplight indicates your run did not meet the standards of a good simulation. Review and potentially fix the warning messages found on the Warnings popup or Message Board:
How to buy
Privacy | Do not sell or share my personal information | Cookie preferences | Report noncompliance | Terms of use | Legal | © 2025 Autodesk Inc. All rights reserved
Sign in to start learning
Sign in for unlimited free access to all learning content.Save your progress
Take assessments
Receive personalized recommendations