A browser-based, zero-dependency tool for well log correlation, formation top picking, and geosteering QC — deployed as a single HTML file on GitHub Pages.
WellCorr Pro is a professional-grade well correlation and geosteering analysis tool that runs entirely in the browser. Load Gamma Ray logs from two wells (a type well and a current well), interactively pick formation tops and match pairs, apply depth corrections with per-segment vertical shift and stretch/squeeze, then validate the correlation quality — all without installing any software.
| Mode | Description |
|---|---|
| General | Side-by-side split-track view for picking match pairs between the type and current well |
| Detailed | Overlay view for fine-tuning each depth segment's offset and scale |
| Validation | QC dashboard with correlation score, formation table, dip angles, and depth query |
- Accepts CSV, TXT, and LAS file formats
- Interactive column-mapping dialog — choose your depth and GR columns
- Configurable null value threshold (default
-999.25) - Optional smoothing applied at load time
- Match pair picker — click a type-well peak, then a current-well peak to pair them
- Auto-Match — automatically detects and pairs GR peaks across both wells
- Auto-Correlation — generates a segmented depth model from your match pairs with per-segment linear depth transformation (offset + scale)
- Segment editor — add, delete, rename, and reorder depth segments; drag split points directly on the canvas
Three algorithms available per track:
- Triangular weighted average
- Simple moving average
- Savitzky-Golay (2nd order polynomial)
- Correlation score (0–100) based on windowed GR cross-correlation at each top
- Formation table — type/current depths, ΔMD, formation thickness, thickness ratio, and apparent dip angle
- Depth query — convert any type-well MD to current-well MD and vice versa
- Well spacing input for dip calculation
- Session auto-saved to
localStorage— resume your work after closing the browser - Export correlation to JSON for reproducibility
- Import a previously saved JSON correlation
No build step needed. Just open the file:
git clone https://github.com/your-username/wellcorr-pro.git
cd wellcorr-pro
open correlation.html # macOS
# or
xdg-open correlation.html # Linux
# or double-click the file in Windows Explorer- Fork or push this repo to your GitHub account.
- Go to Settings → Pages.
- Set source to
mainbranch, root (/) folder. - Your app will be live at
https://your-username.github.io/wellcorr-pro/.
Click Load Type Well or Load Current Well and select a CSV / LAS file. Map the depth and GR columns in the dialog that appears. Repeat for the second well.
Enable the Picker (or press P), click a characteristic GR peak on the type track, then click the corresponding peak on the current track. Repeat for 2–5 representative horizons. Click Apply Auto-Correlation to generate the depth model.
Switch to Detailed mode. Select a segment on the canvas and adjust its Vertical Shift (depth offset in metres) and Stretch / Squeeze ratio with the sliders. Click Update Correlation to preview the result. Add split points as needed.
Switch to Validation mode to inspect the correlation score, formation thicknesses, and depth differences. Enter the well spacing to compute apparent dip angles.
WellCorr Pro reads any delimited text file with at least a depth column and a GR column. Example CSV:
DEPTH,GR,RHOB
100.0,45.2,2.31
100.5,48.7,2.29
101.0,52.1,2.27
...
LAS files are parsed the same way — select DEPTH (or MD) and your GR curve in the column mapper.
| Key | Action |
|---|---|
P |
Toggle point picker |
F |
Fit view to full depth range |
V |
Cycle through modes (General → Detailed → Validation) |
Esc |
Cancel current action |
↑ / ↓ |
Scroll depth |
Ctrl + Scroll |
Stretch / squeeze selected segment |
Shift + Drag |
Box zoom |
| Action | Result |
|---|---|
| Left-click curve | Select segment / pick point |
| Left-drag on curve | Move segment vertically |
| Left-drag on empty area | Pan depth |
| Middle scroll | Zoom depth |
| Middle drag | Pan depth |
| Right-click | Context menu (add split, add top, flatten, zoom, reset, remove) |
| Double-click | Add formation top |
wellcorr-pro/
└── correlation.html # Entire application — self-contained, no build required
All rendering is done on an HTML5 <canvas> element. No frameworks, no bundler, no server required.
Any modern browser with ES5 and Canvas 2D support:
- Chrome / Edge 90+
- Firefox 90+
- Safari 14+
- Multi-well panel view (3+ wells)
- LAS 3.0 export
- Resistivity / RHOB track support
- Dip vector overlay
- PDF / PNG export of the correlation panel
Ismail Harkat geoharkat@gmail.com
MIT © Ismail Harkat