Well Details

Click a well in the Wells list to open its dashboard. One screen holds the whole well record, plus quick access to every app that uses it.

This page follows the dashboard from top to bottom:

---

The Dashboard

Tabs

The tab bar moves between the well's data and the apps that use it.

Section Navigation

Under Well Data, the record is one screen of stacked sections. When you scroll, a strip appears under the tabs: Overview, Casing, Perforations, Tubing, Rods, and Performance. Click a name to jump to that section.

Toolbar

The icons next to the well name:

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

The well record (Well Info, Well Details, Pumping Unit, Casing, Perforations, Tubing, and Rods) changes only in edit mode.

1. Click Edit. The fields become editable and the toolbar shows Cancel and Save.
2. Change values in any section.
3. Click Save and confirm.

To back out, click Cancel. Choose Keep Editing to stay, or Cancel Changes to discard your edits.

Saving updates the well permanently. Every new simulation reads the updated well, and the installed simulation updates automatically. Other existing designs keep their values. See How well edits reach a simulation.

Draft Recovery

PetroBench saves your edits in the browser as you work. If you leave mid-edit and come back, a Restore Previous Edits? prompt offers Restore Draft or Discard Draft.

Validation

If a value is invalid when you save, a Validation Error dialog lists the affected sections. Click a section to jump to the field, then click Back to Editing. Common errors are listed in Validation Errors.

Edit Locks

When edit locks are on for your organization, only one person edits a well at a time.

• While someone else edits, Edit is disabled and a banner shows who holds the lock, for example Alex is currently editing this well. You can view but not edit until they finish. Click Check Again when they are done.
• The well is also read-only while one of its simulations is running.
• Lock events appear under Locks in the Activity Log.

On the RodSim Inputs page, another user's lock can block autosave. Refresh and try again. See Creating a simulation.

---

Well Record

The first three panels describe the well itself. They seed 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.
2. For a branded unit, 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 is not in the catalog. See Custom Pumping Units.

---

Casing

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

Casing Summary

Four reference elevations sit at the top of the section. Set them first, because every other depth refers to them.

Casing Strings

Click Add Casing String and pick the type:

For each string, enter Set Depth, Set Tension, and OD. PetroBench shows the String Min Drift (the smallest drift across the string's rows) next to the Centralizers count. Click a string header to expand or collapse it.

Casing Rows

Inside a string, click Add Row for each joint, shoe, or other component.

---

Perforations

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

Click Add Interval for each perforated zone:

RodSim uses the mid-perforation depth for IPR pressure calculations. With several intervals, it averages the midpoints, weighted by interval length.

The date does not change a simulation. PetroBench uses it to split production history before and after a re-perforation, to place the event on the well timeline, and to tie production declines to perforation work.

---

Tubing

The most important section in the record. It sets PSN Depth, where the pump seats. Almost every downstream calculation depends on it.

PSN and Tubing Anchor

Tubing Sections

Click Add Tubing Section for each piece of pipe between surface and the bottom of the string.

---

Rods

The rod string installed in the well. RodSim uses it as the starting taper for new simulations.

Set the Polished Rod Diameter (1.0 to 2.0 in), then click Add Row for each taper section, from the top down.

Each row's menu can add above, add below, duplicate, or delete. Drag a row to reorder it.

Under the table, PSN Depth, Total Length, and Difference show whether the string reaches the pump. A difference of 0 means the rod string ends at PSN depth.

---

Performance

The last section holds what the well is doing: Well Performance, Fluid Level Data, and Production Data. Fluid level and production rows save one at a time, without edit mode.

Well Performance

An older fluid level file never overwrites values that came from a newer shot.

Fluid Level Data

Fluid level (fluid shot) measurements show how full the wellbore is and what the bottomhole pressure is. They are how you calibrate a simulation against the real well.

Add a Fluid Shot

Click Add Row:

Import Fluid Shots from Excel or CSV

For a history of fluid shots, import a spreadsheet with one shot per row.

1. Click Import, then download the Excel Template (or CSV Template).
2. Fill in one shot per row. Date is required, plus at least one reading: liquid level, fluid above pump, gas-free fluid above pump, PSN depth, casing pressure, PIP, PBHP, or SBHP. Time is optional.
3. Pick the File Unit System your values use: US (ft, psi), or International and Metric (m, kPa). PetroBench converts on import.
4. Drop the .xlsx, .xls, or .csv file. The file card shows how many rows it found, the columns PetroBench read, and the ones it ignored.
5. Pick Skip or Overwrite for shots that already exist, then click Import.

Your own export works too. Headers can be in any of the first 20 rows, on any sheet. Open Recognized header patterns in the dialog to see the accepted names, for example Fluid Level, FAP, CHP, or Pump Intake Pressure.

Import Fluid Shots from PDF

Fluid level readers usually produce a PDF report.

1. Click Import.
2. Drop one or more PDF files.
3. PetroBench reads the date, levels, pressures, and gas-free values.
4. Review the file list, then click Import.

If the reader misses a field, enter it by hand after the import. The other fields still come through.

Production Data

The well's production history.

Add Production

Click Add Row and choose a mode:

• Enter Production Data: a dated reading of Oil (bbl/day), Water (bbl/day), and Gas (mcf/day). PetroBench calculates Total Fluid, Water Cut (%), and GOR (scf/bbl).
• Enter Production Test: a timed well test with the test duration plus test oil, water, and gas.

Import Production from Excel or CSV

1. Click Import. Download the Excel Template (or CSV Template) if you need one.
2. Pick the File Unit System your values use. PetroBench converts on import.
3. Drop a .xlsx, .xls, or .csv file. It needs Date plus at least one of Oil, Water, or Gas. The file card lists the columns PetroBench read and ignored.
4. Pick Skip or Overwrite for dates that already exist, then click Import.

Headers can be in any row on any sheet. Open Recognized header patterns for the accepted names. If a value cannot be read, the message names the spreadsheet row and column.

Why Performance Data Matters

• Calibration: a fluid shot shows what the well is doing now. In RodSim's Simulation Preferences, click Fluid Shot Data: Most Recent / 30d Avg / 90d Avg to fill the target fluid level and target PIP from this section.
• IPR test points: each production row is a candidate point on the deliverability curve.
• Trends: production and fluid level history show declines and anomalies on the well overview.

One recent reading of each is enough to run a simulation. More history makes IPR and trend analysis better.

---

How Well Edits Reach a Simulation

Well Data is the source of truth. Simulations are apps that read from it.

Each simulation keeps its own copy of the well's rods, tubing, PSN depth, tubing anchor, pumping unit, and fluid properties. Saving Well Data does not rewrite every design:

---

Activity Log

Click the History icon in the well toolbar to open the Activity Log. It needs the audit logs capability on your plan (typically Enterprise) and permission to view well data. Otherwise the icon is hidden.

Filter chips narrow the list: All, Well, Simulations, Data, Locks, Tags, Shares, Reports, and Compare. Events include creates and updates, imports, simulation runs and installs, edit locks, tags, reports, and comparisons.

The organization-wide history in the Admin Panel is separate. See Audit Logs.

EventHub on a Well

When a well is synced from EventHub or a warehouse connector:

1. In a Well Data section header, click View source data to compare the source value with the mapped PetroBench field.
2. In the Wells list, open the row menu of a linked well. Choose Re-pull from source to fetch the latest values, or Reset from last sync to restore the last sync snapshot without a live pull.

Confirm each action in the dialog before it runs. Admins set up connections under Integrations.

Validation Errors

---

What's Next