Installed Simulation
Mark a RodSim simulation as the well's installed, as-built design. Only one per well, and installing syncs its pumping unit, rods, and tubing back to Well Data.
Marking a simulation as installed records it as the design that's actually in the field for that well. A well can have only one installed simulation at a time.
Set a Simulation as Installed
- Open the well's RodSim list
- Flip the Installed toggle on the simulation you want
- Confirm in the dialog
Installing a simulation uninstalls whatever was installed before on that well, and resets the current simulation result. The confirmation spells this out before you commit.
When Well Data Changed Since the Design Was Built
If Well Data was edited after the design was built, PetroBench asks which side to keep before it installs. The dialog lists each differing value side by side:
| Choice | What happens |
|---|---|
| Keep Well Data | The design is updated from Well Data first (same as Sync from well), then installed. Your well edits stay. |
| Use this design | The design is written onto the well. Well edits made after the design are replaced by the design's values. |
The REST API and the MCP manage-simulation tool ask the same question: set-installed returns 409 INSTALL_REQUIRES_CHOICE until you pass source=design or source=well.
Which Direction Does Data Flow
| Action | Direction | What moves |
|---|---|---|
| Install a design | Design onto the well | Pumping unit, rod string, PSN depth, tubing anchor, fluid gradient, polished rod diameter, primary survey. The design becomes the as-built record. |
| Save Well Data while a design is installed | Well into the installed design | Rods, tubing, pumping unit, and well details are projected into the installed design automatically. |
| Sync from well on a design's Inputs page | Well into that design | Updates only the parts that changed on the well. Works on any design, installed or not. |
| New Simulation | Well into the new design | Physical inputs from the well; design settings from the installed or latest design. |
Install pushes the design onto the well. If you edited Well Data after the design was built, the install dialog asks whether to Keep Well Data or Use this design. Pick Keep Well Data to keep your edits.
What Installing Syncs
When the installed design differs from the well's current data, PetroBench overwrites parts of Well Data with the simulation's, so the well reflects what's actually run downhole. It writes:
- The simulation's pumping unit onto the well (replacing the existing one)
- The simulation's rod string onto the well (replacing the existing rods)
- Well details: PSN depth, tubing anchor settings, fluid gradient, and polished rod diameter
- The simulation's survey as the well's primary directional survey
The well's tubing string is not overwritten (the simulation carries a simplified version of it, so the full tubing table on the well is preserved).
The overwrite only runs on the first install, or when the design differs from the current well data. If the simulation already matches the well, installing just marks it as installed.
Sync From the Well Into the Design
Installing pushes the design onto the well. The other direction is Sync from well on the simulation Inputs page. It works on every design, installed or not.
When Well Data has changed since the design was built, the Inputs page shows a callout. The muted line lists what changed on the well (rods, tubing, pumping unit, or well data). The buttons on the right open the docs, open Well Data, or start the sync.
Sync from well asks you to confirm, then:
- Updates only the parts that changed on the well. Parts the well has no data for (for example, no tubing string on the well) are left as they are.
- Keeps your design settings: targets, damping, step length, pump fill, and PSN limits.
- Saves a version first, so you can restore the earlier state from the version history.
- Clears the current result. Re-run the simulation afterwards.
A Synced from well toast confirms success. The callout disappears once the design matches Well Data again.
Saving Well Data also projects rods, tubing, pumping unit, and well details into the installed simulation automatically. Other designs only change when you click Sync from well.
Uninstall
Flip the Installed toggle off to clear the installed flag. Uninstalling happens immediately, with no confirmation, and does not change the simulation's inputs or results.
From some list views the toggle is read-only, with the hint "Go to well to change install status." Open the well's RodSim list to change it there.
Permissions
Setting or clearing the installed simulation requires the install permission. If your role doesn't have it, the toggle stays disabled.