Skip to content

← Projects

Python · Scanned well logs

pyLogDigitizer

pyLogDigitizer turns scanned paper well logs (TIFF) into LAS files, with a local browser app to check and fix every step. Nothing leaves your machine.

Version0.1.1
LicenseAGPL-3.0 or later

Overview

pyLogDigitizer turns scanned paper well logs (TIFF) into LAS files. Lots of older wells only exist as paper scans, and digitizing them by hand is slow and hard to check. So I built a tool that does the tedious parts (finding tracks and grids, reading depth labels, tracing curves) and gives you a local browser app to check and fix every step. Curves that run off the track and come back on a backup scale get unwrapped automatically. Everything runs on your own machine and nothing is uploaded.

A scanned paper log traced into a LAS curve — The whole idea in one picture: a scanned paper log going in and a LAS curve coming out.

Examples

Example scans and LAS files are from the Kansas Geological Survey.

Tracing step in the browser app — The guided app with a traced curve laid over the scan, ready for you to review and fix.

Digitized curve against a reference LAS — A curve digitized with the assisted workflow, checked against the paired Kansas Geological Survey (KGS) LAS.

ML and conventional cost maps compared — On held-out Kansas wells, correlation and error against the reference LAS for the conventional and the ML cost map.

Key features

01

Layout and scales

Automatic track, grid and depth-label detection, plus scale calibration.

02

Curve tracing

Fast curve tracing with click-to-fix anchors and backup-scale unwrapping.

03

Optional ML

Optional U-Net cost map that learns from your corrections.

04

Check and export

QC against a reference LAS and LAS 2.0 export.

Installation

pip install pylogdigitizer

The browser app, the faster tracer, and the ML model are optional add-ons; the README lists them.

Citation

Lai, L.S.-H. (2026) pyLogDigitizer. Zenodo, https://doi.org/10.5281/zenodo.23832013

pyLogDigitizer is under the GNU Affero General Public License 3.0 or later.

Next project pyBasinSubs Backstrip a basin's layers to rebuild how it sank and filled. A Python package extending the original BasinSubs R code from the 2022 paper.