Validation Errors
| Error | Fix |
|---|
"Total rod string length must be within 50 feet of PSN depth" | Adjust rod lengths to match PSN depth ±50 ft |
"Target [parameter] is required" | Fill in the target value for your selected parameter |
"API pump type is required" | Select a pump type in Well Data |
"Pump diameter must be greater than 0" | Enter pump diameter in Well Data |
"Fluid gradient must be between 0 and 0.65" | Enter a value in the valid range |
"When Full Pump is enabled, pump fill must be 100%" | Set Pump Fill to 100% or disable Full Pump toggle |
"No pumping unit selected" | Click Select Pumping Unit and choose one |
"Rod string is empty" | Add at least one rod segment |
"PSN depth is required" | Enter pump setting depth in Tubing Data |
"Polished rod diameter must be one of: 1.00, 1.25, 1.50, 1.75, 2.00" | Select a standard size |
Execution Errors
| Error | Fix |
|---|
"The simulation engine is taking longer than expected" | Wait and retry, or increase step length |
"The simulation engine is temporarily unavailable" | Wait a few minutes and retry |
"Unable to connect to the simulation engine" | Disconnect VPN if using one, then retry |
"The simulation calculation failed" | Verify configuration and retry |
"The simulation data could not be validated" | Check inputs for errors |
"An unexpected error occurred while running the simulation" | Retry, contact support if persistent |
If simulations keep failing, duplicate a working simulation and modify one parameter at a time to isolate the issue.
Equipment Not Found
Pumping unit not in library:
- Search by partial model number
- Try alternate naming (e.g., “C-228D-133-74” vs “C228D13374”)
- Create custom unit under Equipment > Pumping Units
Rod not in library:
- Select Rod Type first (filters the other dropdowns)
- Create custom rod under Equipment > Rods > Custom Rods
Missing Survey Data
PSN geometry fields (TVD, inclination, DLS) show blank or zero.
- Go to Well Details > Directional Surveys
- Create or import a survey
- Select the survey in Simulation Preferences
Getting Help
Email [email protected] with:
- Screenshot of the error
- Simulation and well name
- Steps to reproduce
See Report a Bug for detailed instructions on submitting issues.
