Well Details

Click a well from the Wells list to open its dashboard: one screen for the whole well record, with quick access to every app that uses it.

Navigating a Well

The tab bar moves between the well's data and apps:

Under the Well Data tab the record is a single screen of stacked sections. A section-navigation strip jumps you to any one, and a Data Completeness checklist shows what's still missing, including what's required to run a simulation.

Favorite & Tags

• Favorite: click the bookmark icon to add the well to your Favorites.
• Tags: use the tag input under the well name to apply an existing tag, remove one, or create a new tag inline.

Editing a Well

Click Edit to make the record editable; the toolbar switches to Cancel and Save.

1. Click Edit
2. Change values across any panel
3. Click Save and confirm

To back out, click Cancel: choose Keep Editing to stay, or Cancel Changes to discard.

Draft Recovery

Edits are saved locally as you work. Leave mid-edit and return, and a Restore Previous Edits? prompt offers Restore Draft or Discard Draft.

Validation

If something is invalid on save, a Validation Error dialog lists the affected sections; click one to jump to and highlight the field, then Back to Editing.

Edit Locks

Only one person edits a well at a time. While someone else is editing, Edit is disabled and a banner shows who holds the lock; the page refreshes once they release it. The well is also read-only while one of its simulations is running.

Archived Wells

An archived well opens read-only with a banner. Click Restore Well to make it editable again.

---

The rest of this page is the Well Data record itself: the physical well, where fluid enters, what it produces, and how full the wellbore is.

Well Data vs Simulations

Well Data is the source of truth about the well. Simulations are apps that read from it. Update once and every new run sees it.

• Update once, used everywhere
• Existing simulation results are snapshots, re-run to pick up changes
• One well's data can support many designs at the same time

Record Panels

Three summary panels sit at the top of the record. They read from the well and feed every simulation and calculator.

Well Info

Identity and location.

Well Details

Fluid and pressure properties that seed simulation defaults.

Pumping Unit

The surface unit installed on the well.

1. Set Pumping Unit Type: Branded, Custom, or Create Custom to build one.
2. For branded units, pick the Manufacturer Line (searchable), then the Model.
3. Set Rotation, Crank Hole Number, and Motor Type.

Choose Create Custom to define a unit that isn't in the catalog. See Custom Pumping Units.

---

Data Sections

The record is a stacked screen with a section-navigation strip: Casing, Perforations, Tubing, Rods, and Performance (production and fluid level data). Minimums are called out in each.

---

1. Casing

The casing section describes the steel strings cemented in the ground. PetroBench uses these for the pressure boundary, drift diameters, and where the pump can sit.

1.1 Casing Source Data

Four reference elevations sit at the top of the section. Get these right first because every other depth is referenced to them.

1.2 Add a Casing String

Click Add Casing String and pick the type:

For each string, fill in Set Depth (ftKB), Set Tension (lb), and OD (in). Each string also shows a String Min Drift (auto-calculated as the smallest drift across its rows) and a Centralizers count.

1.3 Add Casing Rows

Inside each string click Add Row to add joints, shoes, and other components.

---

2. Perforations

The holes shot through casing into the formation. They control where fluid enters the wellbore.

Click Add Interval for each perforated zone:

2.1 Why the Date Matters

The date does not affect the simulation directly, but PetroBench uses it to:

• Filter production history before vs after a re-perforation
• Show on the well timeline alongside fluid shots and workovers
• Help diagnose production declines tied to perforation events

---

3. Tubing

The most important section in the record. It sets PSN Depth: where the pump seats. That number drives almost every downstream calculation.

3.1 PSN Depth

PSN = Pump Seating Nipple.

3.2 Tubing Anchor

This toggle changes how stretch and rod loads are calculated.

3.3 Tubing Sections

Click Add Tubing Section for each piece of pipe between surface and PSN.

---

4. Rods

The rod string installed in the well. RodSim reads this as the starting taper for new simulations.

4.1 Rod Source Data

A read-only summary shows the string's PSN Depth, Total Length, and the Difference against PSN depth.

4.2 Rod Table

Click Add Row for each taper section, from the top down. Key columns:

Per row, use the menu to add above, add below, duplicate, drag to reorder, or delete.

---

5. Production

The well's production history, grouped with fluid level data under the Performance section. Each row saves on its own, independent of the record's edit mode.

5.1 Manual Entry

Click Add Row. The dialog has two modes:

Enter Production Data - a dated rate reading:

PetroBench auto-calculates Total Fluid, Water Cut (%), and GOR (scf/bbl).

Enter Production Test - a timed well test: test duration plus test oil, water, and gas.

5.2 Bulk Import

For a few months or years of history, use Import.

1. Click Import
2. Drop a .xlsx, .xls, or .csv file
3. Required columns: Date plus at least one of Oil, Water, or Gas
4. Pick Skip or Overwrite for duplicate dates
5. Review the preview, then Import

5.3 Why Production Data Matters

Production history feeds three things downstream:

• Fluid shot calibration: PetroBench cross-checks fluid level changes against rate changes
• IPR test points: each row is a candidate point on the deliverability curve
• Decline curves: visualised on the well overview to spot anomalies

You only need one recent reading to run a simulation. More rows make IPR and trend analysis better.

---

6. Fluid Level Data

Fluid level (fluid shot) measurements tell PetroBench how full the wellbore is and what the bottomhole pressure looks like. This is how you calibrate against the real well. Like production, each reading saves on its own under the Performance section.

6.1 Manual Entry

Click Add Row:

6.2 Import from PDF

If you use a fluid level reader, the equipment usually outputs a PDF report.

1. Click Import
2. Drop the PDF file
3. PetroBench parses date, level, pressures, and gas-free values
4. Review and Import

6.3 Why Fluid Shots Matter

A fluid shot tells you what the well is actually doing right now. It is the only way to calibrate a simulation against reality.

In RodSim's Simulation Preferences, click Fluid Shot Data: Most Recent / 30d Avg / 90d Avg to auto-fill target fluid level and target PIP from this section. Without fluid shots you are guessing at those numbers.

---

Saving and Validation

The well record (Well Info, Well Details, Pumping Unit, Casing, Perforations, Tubing, and Rods) is edited after you click Edit and saved together by the single Save in edit mode. Production and Fluid Level rows are the exception: each row is added and saved on its own, and via Import, independent of edit mode.

Common errors:

---

What's Next