petropy

Analyzes well logs to compute shale volume, porosity, water saturation, and permeability.

46|3|Updated Jan 26, 2026
One-click install
npx skills add https://github.com/SteadfastAsArt/geoscience-skills --skill petropy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: petropy
Source: https://github.com/SteadfastAsArt/geoscience-skills/tree/main/petropy
Command: npx skills add https://github.com/SteadfastAsArt/geoscience-skills --skill petropy

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires petropy, numpy, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Extract actionable petrophysical insights from well logs by automatically computing shale volume, porosity, water saturation, and permeability for formation evaluation.

Core Features & Use Cases

  • Shale volume from Gamma Ray (GR) to identify clay-rich zones.
  • Porosity estimation from density, neutron, and sonic logs, with shale correction.
  • Water saturation and permeability calculations using Archie/Simandoux across single or multi-well projects.
  • Automatic pay flag identification and net pay estimation for hydrocarbon assessment.
  • Quick visualization and export of PHIT, SW, VSH, and PERM for reporting.

Quick Start

Load your LAS file (for example, well.las) with petropy and run the complete formation evaluation to produce shale volume, porosity, saturation, permeability, and pay zones.

Frequently Asked Questions about petropy

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I calculate water saturation and porosity from well logs?

You can calculate water saturation and porosity from well logs by loading your LAS file and running an automated formation evaluation to compute shale volume, porosity, saturation, and permeability.

What is the best way to identify net pay zones from petrophysical data?

Identifying net pay zones from petrophysical data is done by applying an automatic pay flag identification process after computing shale volume, porosity, water saturation, and permeability.

Can I run formation evaluation across multiple wells simultaneously?

Yes, you can run formation evaluation across multiple wells simultaneously, as the workflow supports single or multi-well projects for calculating petrophysical properties and pay flags.

Does petrophysical analysis with petropy require specific log types for shale volume estimation?

Petrophysical analysis for shale volume estimation requires Gamma Ray logs to identify clay-rich zones, while porosity calculations utilize density, neutron, and sonic logs with shale correction.

How do I visualize and export petrophysical properties like PHIT and SW for reporting?

You can visualize and export petrophysical properties like PHIT, SW, VSH, and PERM by using the built-in plotting and summary generation features to quickly generate reports.

Which water saturation models are applied during well log formation evaluation?

Well log formation evaluation applies Archie and Simandoux water saturation models to compute saturation and permeability across single or multi-well projects.