What haql-coords does
haql-coords is a small Python library for the geometry that well records depend on: survey stations, true vertical depth, north/east displacement, dog-leg severity, UTM conversion and a certificate that recomputes the as-drilled path.
In one sentence: It gives the suite one checked geometry definition instead of a hundred inherited spreadsheet formulas.
Verify a path
Recompute TVD, displacement and dog-leg severity from survey stations.
Catch a shifted record
Flag a survey or coordinate that fails a basic geometry check.
Reuse a small library
Add well geometry without pulling in a full analysis stack.
Why it matters
A copied formula can be correct and still be the wrong convention. A coordinate shifted by one digit can quietly change the nearest-well calculation. A number is not proof; a round-trip and a reproducible certificate are.
- The spreadsheet formula came from someone who left years ago; its datum is unknown.
- One well coordinate is shifted by a digit and the geometry quietly changes.
- A distance cannot be inverted or checked, so a wrong answer looks like a right one.
- QC rules that compare wells need trustworthy geometry upstream.
A spreadsheet gives a plausible distance. Nobody can say which datum, sign convention or survey method produced it.
The survey is recomputed with a documented method, checked for depth order, range and dog-leg severity, and certified deterministically.
What goes in
The library takes survey stations and coordinate values directly in Python.
| What goes in | What it means |
|---|---|
| Survey stations | Measured depth, inclination and azimuth for the well path. |
| Coordinates | UTM or geographic values for conversion and offset calculations. |
| Python code | The library is imported into your own script; there is no portal or account. |
What comes out
The outputs are plain values and deterministic evidence, not a hosted report.
| What comes out | How to use it |
|---|---|
| Well-path values | True vertical depth (TVD), north/east displacement and dog-leg severity (DLS) per segment. |
| Survey check | Depth-order, inclination/azimuth range and dog-leg findings with stable rule IDs. |
| Survey certificate | Final TVD, horizontal closure, maximum DLS and a SHA-256 over the canonical station list. |
| UTM conversion | Coordinate conversion with an explicit method. |
What it checks
The checks are deliberately small and auditable.
| Check area | What it flags |
|---|---|
| Depth order | Survey stations that do not progress in measured depth. |
| Angle range | Inclination or azimuth outside the valid range. |
| Dog-leg severity | A dog-leg above the 2.0°/100 ft limit used by the library. |
| Round-trip geometry | A coordinate or distance that cannot be checked both ways. |
The certificate is deterministic: the same stations produce a byte-identical result and hash.
What it does not do
A useful tool should be clear about its boundaries. These are the current limits, not hidden caveats.
- It is a geometry library, not a full well-planning, anti-collision or drilling-engineering application.
- It depends on the quality and completeness of the survey stations you provide.
- A passing survey check is not a substitute for engineering review of the well design.
- The library does not replace a company's survey standards or regulatory requirements.
Findings are advisory. The tool names a contradiction or a risk with the evidence behind it. The engineering, legal or commercial judgement remains with you.
How to try it
Install it in seconds and try the geometry on a survey you already have.
pip install haql-coords- Build a minimum-curvature path from survey stations and inspect true vertical depth (TVD), displacement and dog-leg severity (DLS).
- Run
check_survey()andsurvey_certificate()on the same stations.
Nothing leaves your machine. The paid tools run offline. The free libraries have no account, cloud call or telemetry.
Common questions
Is it really free?
Yes. haql-coords is MIT-licensed, with no account, cloud call, seat count or telemetry.
Does it need a database?
No. It is a Python library; data is passed in code.
Can it plan a well?
No. It computes and checks geometry from survey data. Well planning and anti-collision are larger disciplines.
What is dog-leg severity?
How sharply the well path bends over a measured distance, usually expressed in degrees per 100 feet.