Validation Errors (Before Running)
When you click Run Simulation, PetroBench checks your inputs. If something’s wrong, you’ll see error messages.Rod Length Mismatch
Error: “Rod string length doesn’t match PSN depth” Your total rod length needs to be close to your pump setting depth. PetroBench allows some tolerance, but if you’re way off, it won’t run. Fix:- Go to Rod Details tab
- Add up your rod section lengths
- Compare to your PSN depth in Tubing Data
- Adjust rod lengths or PSN to match
Missing Required Fields
Error: “Required field is empty” or red highlighting on fields Some fields must have values before you can run. Fix:- Look for red-highlighted fields across all tabs
- Check each tab: Simulation Preferences, Rod Details, Tubing Data
- Fill in any empty required fields
- Click Save All and try again
Values Out of Range
Error: “Value must be between X and Y” You entered a number that’s outside the acceptable range. Common culprits:- Pump fill > 100%
- Negative depths
Pumping Unit Not Selected
Error: “Select a pumping unit” You can’t run without specifying equipment. Fix:- Go to Simulation Preferences
- Click Select Pumping Unit
- Choose a unit from the library
- Save and try again
No Rod String Configured
Error: “Add at least one rod section” You need at least one rod taper defined. Fix:- Go to Rod Details tab
- Click Add Rod
- Configure at least one section with type, grade, diameter, and length
- Save and run
Runtime Errors (During Simulation)
The simulation started but failed partway through.”Simulation failed” Generic Error
This usually means something unexpected happened. Try:- Refresh and run again — Sometimes it’s a temporary glitch
- Check your inputs — Look for unusual combinations (extreme values, conflicting settings)
- Simplify — Remove optional features (IPR data, rod guides) and try again
- Contact support — If it keeps failing, there might be a bug
| Error | Likely Cause | Fix |
|---|---|---|
| ”PSN depth required” | Tubing Data tab incomplete | Enter pump setting depth |
| ”Invalid rod configuration” | Rod sections have gaps or overlaps | Review rod lengths |
| ”Pumping unit capacity exceeded” | Design exceeds unit ratings | Choose a larger unit or reduce loads |
| ”Survey data invalid” | Directional survey has issues | Check/reimport survey |
| ”Fluid properties invalid” | Fluid gradient or other values wrong | Review fluid inputs |
When to Contact Support
Reach out to [email protected] if:- The same simulation worked before but now fails
- The error message doesn’t make sense
- You’ve tried everything and it still won’t run
- Results are clearly wrong despite correct inputs
- Well name and simulation name
- Screenshot of the error
- What you’ve already tried