MnemonicsPetrophysicsData Management

Why Your LAS Files Have 50 Names for Gamma Ray (And What To Do About It)

The single most persistent data management problem in petrophysics — and why semantic matching beats string matching and hand-curated alias tables.

PetroCurve Team7 min read

Every petrophysicist has lived this moment. You receive a batch of LAS files from a new field, open the first one, and find a curve called ECGR. The next file has GR_EDTC. The third just says GAMMA. A fourth has GRD. They're all measuring gamma ray — probably — but good luck proving that to your software, your database, or the new hire who just asked which one to use for shale volume.

This isn't a minor inconvenience. It's the single most persistent data management problem in petrophysics, and it's been compounding for forty years.

How We Got Here

The Log ASCII Standard was introduced by the Canadian Well Logging Society in 1989 to standardize the storage of digital well log data. It succeeded — wildly — at standardizing the file structure. Every LAS file has the same sections: ~V, ~W, ~C, ~P, ~A. Any text editor can open one. The format became the lingua franca of well log data exchange worldwide.

But the LAS specification made a critical design choice: it standardized the container, not the contents. The ~C section defines what curves are in the file, but the spec places no constraints on what you name them. The mnemonic field is freeform text. You can call your gamma ray curve GR, GAMMA, NATURAL_GAMMA_RAY, or BOB. The file will parse just fine.

This wouldn't be a problem if one company made one tool that produced one curve. But the well logging industry doesn't work that way.

The Scale of the Problem

Schlumberger's Curve Mnemonic Dictionary — their own internal catalog — contains descriptions of more than 50,000 tool, curve, and parameter names. That's one vendor. Add Baker Hughes, Halliburton, Weatherford, and dozens of smaller service companies, each with their own naming conventions, and the total number of unique mnemonics in active use across the industry is staggering.

Even for the most basic measurement in petrophysics — the gamma ray log — the variation is remarkable. Here's a sampling of mnemonics you'll encounter in real LAS files, all representing some form of gamma ray measurement:

Total / Standard Gamma Ray: GR, GR1, GR2, GR3, GAMMA, GRD, GRS, HSGR, SGR, GRA, GRB, SGRC, SGRD, DGR

Computed / Corrected Gamma Ray: CGR, HCGR, ECGR, GR_EDTC, GRC, GCOR

Spectral Components: THOR, TH, URAN, POTA, K40, SGR, CGR

That's roughly 20 mnemonics for gamma ray alone, and this list isn't exhaustive. Some of those names are syntactically similar (GR vs GR1), some are completely different strings (HSGR vs GAMMA), and — critically — some of them measure fundamentally different things.

The Dangerous Subtlety

This is where the mnemonic problem graduates from annoying to dangerous. Not all "gamma ray" curves are interchangeable.

SGR (Standard Gamma Ray) records the total natural radioactivity from all sources — potassium, thorium, and uranium. CGR (Computed Gamma Ray) subtracts the uranium contribution, giving you only the potassium-plus-thorium response. The difference matters enormously: uranium salts can precipitate in porous reservoir rock near the wellbore, making clean sands appear shaly on a total gamma ray log. If you're calculating shale volume from what you think is a standard gamma ray but is actually a computed gamma ray — or vice versa — your reservoir model has a systematic error baked into it.

The spectral gamma ray tool was developed precisely because this distinction is important enough that companies will pay extra to run it. But when that data lands in a LAS file, the only thing distinguishing SGR from CGR from GR from HCGR from ECGR is a few letters in the mnemonic field — letters that follow no enforced convention and vary by vendor, vintage, and sometimes by the individual engineer who configured the logging run.

Why Existing Solutions Fall Short

The industry hasn't ignored this problem. Several approaches exist, and each has real limitations.

The PWLS Standard

The Practical Well Log Standard, maintained by Energistics, provides an industry-agreed hierarchical list of property names designed to classify well log measurements. PWLS v3.0, released in 2021, was a major update driven by the need for automation-friendly disambiguation of branded and legacy mnemonics. It integrates with Energistics' WITSML, RESQML, and PRODML transfer standards.

PWLS is well-designed and genuinely useful as a classification taxonomy. The challenge is adoption. PWLS defines what curves should be called, but it can't retroactively rename the millions of LAS files already in existence. It's a prospective standard applied to a retrospective problem. If you're working with legacy data — which in petrophysics means anything from last month to 1989 — PWLS gives you a target vocabulary but no automated way to get there.

Vendor Dictionaries

Schlumberger publishes their Curve Mnemonic Dictionary. SPWLA maintains a Mnemonics Data Search tool (members-only). Baker Hughes and Halliburton publish their own mnemonic reference documents. These are useful if you know which vendor logged the well, but they're siloed. There's no single lookup that spans all vendors, and even within a single vendor's dictionary, the same measurement type can have dozens of entries depending on the tool generation and processing workflow.

Manual Alias Tables

The most common real-world solution is a spreadsheet. Every petrophysics team maintains some version of a hand-curated mnemonic mapping table — "if you see ECGR, map it to GR_corrected." These alias tables work until they don't. They can't keep up with new tools, they diverge between teams, and they silently fail on mnemonics nobody's seen before. The institutional knowledge lives in one person's head and leaves when they do.

Fuzzy String Matching

Some tools attempt programmatic matching using string similarity algorithms — Levenshtein distance, Jaccard similarity, and similar approaches. This works for the easy cases (GR1 is probably gamma ray) but fails on the hard ones. ECGR and CALI have similar string lengths and character distributions, but one is a gamma ray and the other is a caliper. Conversely, HSGR and GAMMA have almost zero string similarity but measure the same thing. Syntactic similarity is a poor proxy for semantic similarity when mnemonics are essentially abbreviations of full English phrases.

A Better Approach: Semantic Matching

The mnemonic matching problem is fundamentally a semantic similarity problem disguised as a string matching problem. The question isn't "do these character sequences look alike?" — it's "do these abbreviated names refer to the same physical measurement?"

Modern natural language processing offers a direct solution: text embeddings. An embedding model converts text into a dense numerical vector that captures its meaning. Two phrases with similar meanings produce vectors that are close together in the embedding space, regardless of whether they share any characters.

When you compute embeddings for mnemonic descriptions — not just the short codes, but their full names and measurement descriptions — the semantic relationships emerge naturally. "Environmentally Corrected Gamma Ray" maps close to "Standard Gamma Ray" in embedding space because the model understands these are variations of the same underlying measurement. Meanwhile, "Caliper" maps far away, even though CALI and ECGR are both four-character strings.

This approach handles the hard cases that string matching can't:

  • Vendor-specific branding (HSGR vs GR vs GAMMA) — the descriptions all reference gamma ray, so the embeddings converge.
  • Subtle measurement differences (SGR vs CGR) — the descriptions differ ("total gamma ray" vs "computed gamma ray minus uranium"), so the embeddings are close but distinguishable.
  • Novel mnemonics — a mnemonic you've never seen before can be matched to its nearest semantic neighbor, even without a lookup table entry.

The key advantage is that this approach degrades gracefully. A lookup table either has an entry or it doesn't. An embedding-based system always returns a ranked list of candidates with confidence scores, letting a human make the final call on ambiguous matches.

What This Means for Your Workflow

If you're a petrophysicist or data manager dealing with mnemonic standardization today, here's the practical takeaway:

For small-scale work (a handful of wells), manual alias tables remain fine. The effort of setting up anything more sophisticated isn't justified.

For medium-scale work (multi-well studies, field-level data loading), you need an automated first pass. Whether that's a comprehensive lookup database, an embeddings-based matcher, or both, the goal is the same: reduce the manual review burden to only the genuinely ambiguous cases.

For enterprise-scale work (basin-wide databases, ML training datasets), you need all of the above plus a feedback loop. Every manual correction should update your mapping database. Over time, your system learns your organization's specific conventions and edge cases.

The mnemonic problem isn't going away. New tools produce new curves with new names. Legacy data doesn't rename itself. But the tools for dealing with the problem have gotten dramatically better — and they no longer require you to maintain a spreadsheet that only one person understands.


PetroCurve maps the mnemonics in your LAS files to industry-standard naming conventions in seconds, with intelligent suggestions ranked against a curated curve and tool database. Drop a LAS file, review the matches, export a clean LAS 2.0 file — all in your browser, no data leaves your machine. Try it free →

More posts

LASFile FormatPetrophysics

The Complete Guide to LAS File Format: Structure, Versions, and Common Pitfalls

Everything you need to know about LAS files: how the format is structured, how the three versions differ, where real files deviate from the spec, and what to do about it.

LASDLISFile Format

LAS vs DLIS: When to Use Each Format and How to Convert Between Them

Two formats dominate well log data storage. Understanding when each is the right choice — and how to move data between them without losing information — is essential for managing well log data at scale.