A powerful, privacy-first web application for designing, visualizing, and exporting directional well trajectories. Built specifically for drilling engineers, well planners, and geologists to rapidly iterate on well profiles using an integrated Pareto solver, realistic DLS ramp modeling, and 3D formation intersections — entirely within the browser.
🔒 No data ever leaves your computer. All calculations and rendering happen client-side.
🔗 Live App: https://geoharkat.github.io/Directional-Well-Planner/
- 100% Client-Side — Runs entirely in your browser. Your proprietary well data and geological interpretations are never uploaded to any server.
- Pareto Target Solver — Instantly find the optimal build rate and inclination to hit your target. Generates a full Pareto curve (Min DLS vs. Max Reach), auto-detects the "Knee" point, and allows fine-tuning via a slider or exact target inputs (Inclination or Horizontal Departure).
- Realistic DLS Profiles — Model real-world BHA behavior with trapezoidal rate profiles (ramp-up / ramp-down) on build/drop segments. The planner automatically extends the segment length so the target inclination is still hit exactly.
- Advanced Formation Tops — Input formation tops as TVD or MD, with Dip and Strike. The planner calculates apparent dip in the Vertical Section plane and renders dipping planes as 3D meshes and 2D lines with volume fill.
- Minimum Curvature Method — Industry-standard survey calculation algorithm used for all trajectory computations.
- 3D Well Path (Cropped View) — The 3D view starts 50m above the KOP, removing the uninformative vertical section and focusing the camera on the directional geometry. A labeled marker indicates the 3D start point.
- Interactive 3-Window Plots — Synchronized Plan View, Vertical Section, and 3D well path with spread-out, non-overlapping annotations for KOP, EOB, EOD, TD, etc.
- Customizable Annotations — Toggle which markers (KOP, EOB, Formations, Wellhead) appear on each specific plot (Plan, VS, 3D) and in the PDF report.
- Professional Exports — Export high-resolution PNGs of any plot, a fully formatted Excel survey (with selectable MD step), or a multi-page PDF report complete with plots, survey tables, solver summary, and copyright/disclaimer.
-
Open the App — Navigate to the live app or open
index.htmlin any modern web browser. -
Solve the Target (Optional but Recommended) — In the "Target Solver" panel, enter your KOP MD, Target TVDs, and Azimuth. Click Compute & Generate to instantly build a balanced well plan based on the Pareto Knee point, or specify a target inclination/horizontal departure.
-
Adjust Segments — Modify the generated segments (Vertical, Build, Hold) or add your own (Drop, Turn). Use the sliders for Build Rate and Target Inclination. Enable Realistic DLS Profile if you need ramp-up/ramp-down behavior.
-
Add Formation Tops — Click + Add Formation Top. Enter Depth (TVD or MD), Dip, and Strike. Formations will appear as dashed/solid lines in the VS plot and as 3D planes in the 3D view.
-
Configure View — Set the Vertical Section Azimuth (or use Auto), adjust annotation toggles, and set your preferred MD step for the survey table.
-
Export — Use the top-right buttons to export the Survey Table to Excel or generate a comprehensive PDF Report. Use the "PNG" buttons on individual plots for high-res images.
| Feature | Details |
|---|---|
| Well Types | J-Type (Build & Hold), S-Type (Build, Hold, Drop), Horizontal (Build to 90° & Hold), Custom multi-segment |
| Survey Calculation | Minimum Curvature Method (standard ratio factor) |
| Build/Drop Rate | Constant DLS or Trapezoidal Profile (Ramp Up → Hold → Ramp Down) |
| Turn Segment | Azimuthal turning at constant turn rate while maintaining inclination |
| Solver Modes | Auto-Knee (Pareto balanced), Target Inclination, Target Horizontal Departure (bisection) |
| Formation Projection | 3D plane intersection, Apparent Dip calculation for VS projection |
| 3D View Start | Cropped 50m above KOP for optimal camera focus on directional section |
This is a zero-build, single-file web application leveraging powerful open-source libraries:
| Library | Purpose |
|---|---|
| Plotly.js | 2D (Plan, VS) & 3D Interactive Plotting |
| SheetJS (XLSX) | Excel (.xlsx) Survey Export |
| jsPDF + AutoTable | PDF Report Generation |
| Vanilla JS / CSS | Core Logic, UI, & Styling (No framework dependencies) |
Ismail Harkat
Wellsite & Operations Geologist
📧 geoharkat@gmail.com
If you find this tool useful in your drilling engineering or geological workflow, feel free to reach out!
This project is licensed under the MIT License — see the LICENSE file for details.