When the Fluidstream Simulation does not behave as expected, the issue typically falls into one of two categories:
|
Issue Source |
Who Can Fix It |
Action |
|---|---|---|
|
First Time Setup (object classification) |
AseptSoft development team |
Contact support โ classes and object assignments need to be reconfigured |
|
Layers or Mapper Settings |
You (the user) |
Follow the troubleshooting examples below to diagnose and fix |
๐ก Before troubleshooting, always check the Neighbours Map (Show Neighbours Map on the Module Ribbon) โ it shows exactly how AseptSoft connected all entities and which mapper rule was used for each connection. This is your primary diagnostic tool.
๐ Troubleshooting Workflow
Follow this general approach for any Fluid Stream problem:
|
Step |
Action |
What to Look For |
|---|---|---|
|
1 |
Show the Neighbours Map |
Check if the expected connections exist (blue lines between objects) |
|
2 |
Check mapper labels |
Read the green/yellow text to see which mapper created each connection |
|
3 |
Check layer settings |
Verify that pipe layers are enabled and non-pipe layers (walls, instruments) are disabled |
|
4 |
Adjust mapper tolerances |
If objects are too far apart for the current settings, increase the relevant tolerance |
|
5 |
Use AseptSoft Connector |
Add custom connection points for objects that cannot be automatically detected |
|
6 |
Clear Cache and re-run |
After making changes, rebuild the connectivity graph |
๐ Example 1: Unrecognised Component
Problem: You encounter an AutoCAD component that has not been set up during the First Time Setup. For example, when a new P&ID is loaded that contains an object type that was not present in the original PIDs used for the initial configuration.
Symptom: Fluid stops at or flows through the component incorrectly because AseptSoft does not know what class (Valve, Clamp, Tank, etc.) to assign it.
Solution: This requires the AseptSoft development team to update the First Time Setup. Contact support and provide:
-
The P&ID file containing the new component
-
A description or screenshot of the unrecognised object
-
The expected behaviour (should it block fluid? allow? generate?)
๐ Example 2: Fluid Jumping Between Lines
Problem: Fluid appears to jump from a vertical line to a horizontal line unexpectedly.
Symptom: Two vertical lines end on the same horizontal line. The Endpoint Proximity Mapping connects all three endpoints together, creating an unintended junction.
Solution: Either:
-
Create a gap between the two vertical lines and the horizontal line so they are no longer within the Tolerance Distance
-
Make the horizontal line continuous instead of having two separate vertical lines ending on it
-
Adjust the Tolerance Distance if the false connection occurs at a very small distance
โน๏ธ Why this happens: When two line endpoints are within the Tolerance Distance of the same entity, they all become connected. Ensure that lines that should be separate have sufficient spacing.
๐ Example 3: Fluid in Non-Pipe Lines
Problem: Fluid is visible in lines that are not pipe lines โ for example, wall lines or instrumentation signal lines.
Symptom: Coloured overlay appears on lines that represent walls, signal paths, electrical connections, or construction geometry.
Solution:
-
Identify the layer โ Use AutoCAD's Q-Select (Quick Select) to determine which layer these lines are on
-
Check impact first โ Before disabling the layer, use Q-Select to review what other entities share the same layer. You do not want to accidentally exclude pipe lines
-
Disable the layer โ Open the Layer Settings from the Module Ribbon โ Simulations panel and set the problematic layer to Forbidden
-
Clear Cache and re-run the simulation
โ ๏ธ Caution: Always check the full impact of disabling a layer using Q-Select before making changes. Some PIDs place both pipes and non-pipe elements on the same layer.
๐ Example 4: Lines Not Connecting (Fluid Won't Jump a Gap)
Problem: Two pipe lines are close to each other but the fluid does not jump between them.
Symptom: The Neighbours Map shows no blue connection line between the two pipes.
Solution: Check which mapping strategy should handle this gap:
|
Situation |
Mapper to Check |
Setting to Adjust |
|---|---|---|
|
Lines are co-linear with a gap |
Line Gap Bridging (#7) |
Increase Max Absolute Gap Length or Max Gap Ratio |
|
Lines end near each other |
Endpoint Proximity Mapping (#1) |
Increase Tolerance Distance |
|
A clamp should bridge them |
Sticky Block References (#4) |
Verify the block is classified as Clamp |
|
Lines are far apart |
AutoCAD Group Connectivity (#9) |
Place both entities in the same AutoCAD named Group |
If no mapper can handle the gap, use the AseptSoft Connector to manually create connection points.
๐ Example 5: Coloured Objects in Black-and-White Viewport
Problem: Even though the AseptSoft viewport is set to black and white, some coloured objects remain visible in the drawing, making it hard to see the Fluid Stream overlay.
Symptom: Non-simulation colours interfere with the visual readability of the fluid flow overlay.
Solution: This is an AutoCAD display setting issue:
-
Check your Visual Style settings in AutoCAD
-
Ensure the viewport's colour override is properly configured
-
The Fluid Stream overlay uses its own layers (AseptSoft FluidFlow and AseptSoft Empty FluidFlow) โ these are always coloured regardless of viewport settings
-
Use the
LWEIGHTcommand and enable Display Lineweight for improved overlay visibility
๐ Example 6: New Object Type Not Handled
Problem: A P&ID contains a component type that AseptSoft has never encountered before, and the Fluid Stream either ignores it or connects to it incorrectly.
Symptom: The object was not part of the original First Time Setup classification.
Solution: Contact the AseptSoft development team to add the new object type to the classification. Provide:
-
The P&ID drawing file
-
The block name of the unrecognised component
-
The expected fluid behaviour (Allow, Deny, Generate, etc.)
Until the classification is updated, you can use the AseptSoft Connector command to manually define connection points for the unrecognised object.
๐ ๏ธ Quick Reference: Diagnostic Tools
|
Tool |
Where to Find It |
What It Does |
|---|---|---|
|
Show Neighbours Map |
Module Ribbon โ Simulations |
Shows all connections and which mapper created them |
|
AseptSoft Connector |
Command line |
Inspect and modify connection points on any object |
|
Q-Select |
AutoCAD standard |
Select entities by property (layer, type, etc.) to check impact |
|
LIST |
AutoCAD standard |
Shows an entity's Handle value for matching against Neighbours Map labels |
|
Select Upstream Path |
Module Ribbon โ Simulations |
Traces all nodes that feed fluid into a selected item |
|
Select Downstream Path |
Module Ribbon โ Simulations |
Traces all nodes that receive fluid from a selected item |
|
Clear Cache |
Module Ribbon โ Simulations |
Rebuilds the connectivity graph from scratch |
๐ Related Pages
-
Fluidstream Simulations โ Main overview of how the simulation works
-
Fluidstream Mapping Strategies โ Detailed description of all mapping algorithms and their tolerance settings
-
First Time Setup โ Initial configuration performed by the development team
-
Module Ribbon โ Simulations panel controls
-
Engineering Items โ Valves, instruments, and fittings
-
State โ Determines how each item responds to fluid