logSuite

Petrophysical well-log analysis in Python. Load LAS files, set a project palette once, fit per-facies regressions, and export deliverable-ready SVGs — without writing matplotlib glue.

Why logSuite

The library aims to stop you from writing the boilerplate that usually surrounds a reservoir-engineering notebook:

• No per-well loops. manager.PHIE.filter("Facies").data(weighted=True) returns one DataFrame across every well, with depth-interval weights for pooled percentiles.
• No monkey-patching. xplot.add_regression_per("Facies", "exponential") fits one line per facies; the line colours come from manager.Facies.colors automatically.
• No matplotlib glue. xplot.add_table_panel(stats); xplot.save("deliverable.svg") produces the SCAL/DG3 figure as one file.
• No equation rewriting. equation_format="petrel" renders fitted exponentials as pow(10, c1*x + c0) — paste straight into Petrel.

Installation

pip install logsuite

Requires Python 3.10+, numpy, pandas, scipy, matplotlib.

Quick start

from logsuite import Crossplot, WellDataManager, set_quiet

set_quiet(True)                                    # silence broadcast prints
manager = WellDataManager()
manager.load_las("12_3-2_B.las").load_las("12_3-2_C.las")
manager.Facies.colors = {0: "#999999", 1: "#3b82f6", 2: "#10b981"}

xplot = Crossplot(manager, x="PHIE", y="PERM", color="Facies", y_log=True,
                  equation_format="petrel", decimals=3)
xplot.add_regression_per("Facies", "exponential", legend_loc="upper left")
xplot.save("poroperm.svg")

Seven lines. One regression line per facies in the manager palette, legend equations in Petrel syntax, ready for Word.

What's in the box

Common workflows

Each is a runnable script in story_tests/ and a how-to guide in the docs:

Documentation

logsuite.readthedocs.io

• Quick start
• How-to guides — task-focused recipes
• User guide — topical reference
• API reference

Architecture

The library follows a strict layered-dependency rule documented in ARCHITECTURE.md. Lower layers do not know consumers exist; data flows up — never down. The design exists to keep the API small and predictable as features are added.

License

MIT — see LICENSE.