petropy

name	petropy
description	Petrophysical analysis and formation evaluation from well logs. Calculate porosity, water saturation, permeability, and lithology. Use when Claude needs to: (1) Calculate shale volume from gamma ray, (2) Compute porosity from density/neutron/sonic logs, (3) Estimate water saturation using Archie or Simandoux, (4) Calculate permeability from porosity and saturation, (5) Perform pay zone identification, (6) Conduct multi-mineral analysis, (7) Generate petrophysical summation plots.
version	1.0.0
author	Geoscience Skills
license	MIT
tags	["Petrophysics","Formation Evaluation","Water Saturation","Porosity","PetroPy","Well Logs","Permeability","Archie"]
dependencies	["petropy>=0.1.6","lasio","numpy"]
complements	["lasio","welly","striplog"]
workflow_role	analysis

PetroPy - Petrophysical Analysis

Quick Reference

import petropy as pp

# Load and inspect
log = pp.Log('well.las')
print(log.keys())              # Available curves
depth, gr = log['DEPT'], log['GR']

# Calculate properties
log.shale_volume(gr_curve='GR', gr_clean=20, gr_shale=120)
log.formation_porosity(rhob_curve='RHOB', rhob_matrix=2.65, rhob_fluid=1.0)
log.water_saturation(method='archie', rt_curve='RT', porosity_curve='PHIT', rw=0.05)
log.permeability(method='timur', porosity_curve='PHIT', sw_curve='SW')

Key Classes

Class	Purpose
Log	Main well log container, extends lasio.LASFile
electrofacies	Facies classification utilities
Formations	Zone/formation management

Essential Operations

Shale Volume (Vsh)

log.shale_volume(
    gr_curve='GR',
    gr_clean=20,           # GR of clean sand (API)
    gr_shale=120,          # GR of shale (API)
    method='linear'        # or 'larionov_young', 'larionov_old', 'clavier'
)
vsh = log['VSH']

Porosity

# Density porosity with shale correction
log.formation_porosity(
    rhob_curve=,
    rhob_matrix=,      
    rhob_fluid=,        
    rhob_shale=,       
    vsh_curve=        
)
phi = log[]