Troubleshooting “Network Build Error” and “Unable to Prepare Network”
Learn how to quickly resolve 'Network Build Error' and 'Unable to Prepare Network' issues in FluidFlow with our step-by-step troubleshooting guide.
Introduction
When FluidFlow displays "Network Build Error" or "Unable to Prepare Network," it typically indicates a connectivity or data-initialization issue in the model. These errors commonly occur after delete or undo operations, when node connections aren't properly snapped, or when internal tracking fields get out of sync with actual connectivity. While frustrating, these issues can usually be resolved quickly without losing your work.
This guide provides proven, step-by-step solutions to restore your model's integrity and get your calculations running again with minimal disruption to your workflow.
Solution Methods
Method 1: Re-initialize by Copying to a New Flowsheet (Recommended)
This is the most reliable solution for most users. It forces FluidFlow to re-initialize all internal fields without altering your intended model structure.
Step-by-Step Instructions:
-
Note Zoom Level: Take note of the exact zoom percentage of your current flowsheet.

-
Select All: Go to Edit → Select → Select All.
-
Copy: Select Edit → Copy (or press
Ctrl+C). -
Create New Flowsheet: Select File → New.
-
Match Zoom: Set the new flowsheet's zoom percentage to exactly match the original.
-
Paste: Select Edit → Paste (or press
Ctrl+V). -
Calculate: Click the Calculate button and check Messages for any remaining warnings.
⚠️ IMPORTANT: Always match zoom percentages exactly between source and destination flowsheets. Different zoom levels will cause component misalignment and distortion of your model.
Method 2: Run the Fix Node Connections Script (Advanced)
This targeted solution corrects the specific issue where a node's internal "connection count" doesn't match the actual number of connected pipes.
Installing the Script:
-
Download the "Fix Node Connections.psc" script file:
-
Copy this file to your FluidFlow3 Scripts folder (typically located at:
C:\\Program Files (x86)\\Flite\\FluidFlow3.XX\\FluidFlow3\\Scripts) -
Restart FluidFlow to load the new script, or go to Tools → Scripts → Refresh List.
Running the Script:
- Open your problem model.
- Select Tools → Scripts → Fix Node Connections.
- Click Calculate and review Messages.
TIP: Always save a backup of your model before running scripts.
Additional Connectivity Checks
If errors persist after trying both solutions above:
- Gently drag suspicious nodes to confirm they properly snap to connections.
- Remove any stray or orphaned components outside the main network.
- Ensure all endpoints terminate correctly at boundaries or equipment.
- Address any remaining fundamental warnings in the Messages tab.
If errors persist after implementing all recommended fixes, please send your model to support@fluidflowinfo.com for specialized technical assistance.
FAQs
Q: What is the quick fix for a Network Build Error?
A: Copy the entire model to a new flowsheet, click Calculate, and review the Messages panel. This approach is typically the fastest and most reliable solution for most users.
Q: Will these fixes change my calculation results?
A: No. These methods only re-initialize or correct internal fields without changing your model structure or input values.
Q: Why does matching Zoom matter when copying?
A: Mismatched zoom levels can cause the pasted model to appear crowded or distorted, making it difficult to work with and potentially creating alignment issues between components.
Q: What if neither solution works?
A: Review Messages for fundamental issues, then contact FluidFlow Technical Support with your model file, version, OS, and recent actions.
Conclusion
Most "Network Build Error" and "Unable to Prepare Network" issues stem from connection problems or internal fields that failed to initialize properly. Re-initializing your model through copy/paste to a new flowsheet or running the Fix Node Connections script typically restores normal calculation functionality quickly.
When troubleshooting these errors, begin with the simplest and most reliable solution (copying to a new flowsheet), and only advance to more specialized fixes if necessary. Always maintain consistent zoom levels and follow clean connectivity practices to prevent these issues from recurring.
Resolving network build errors promptly ensures reliable calculations, prevents rework caused by hidden connectivity problems, and maintains project momentum by reducing workflow disruptions.