mplstereonet

name	mplstereonet
description	Stereonet plots for structural geology using matplotlib. Create lower-hemisphere stereographic projections for orientation data. Use when Claude needs to: (1) Create stereonet plots for structural data, (2) Plot planes as great circles or poles, (3) Plot lineations with trend/plunge, (4) Generate density contours for orientations, (5) Calculate mean orientations and statistics, (6) Analyze fold axes with pi-diagrams, (7) Convert between strike/dip and trend/plunge formats.
version	1.0.0
author	Geoscience Skills
license	MIT
tags	["Structural Geology","Stereonet","Orientation Data","Matplotlib","Visualization"]
dependencies	["mplstereonet>=0.6","matplotlib","numpy"]
complements	[]
workflow_role	visualization

mplstereonet - Stereonets for Matplotlib

Quick Reference

import mplstereonet
import matplotlib.pyplot as plt

# Create stereonet
fig, ax = mplstereonet.subplots()

# Plot plane and pole (strike/dip, right-hand rule)
ax.plane(315, 45, 'b-')          # Great circle
ax.pole(315, 45, 'ko')           # Pole to plane

# Plot lineation (trend/plunge)
ax.line(120, 30, 'r^')

ax.grid()
plt.savefig('stereonet.png', dpi=150)

Key Functions

Function	Purpose
mplstereonet.subplots()	Create stereonet figure and axes
ax.plane(strike, dip)	Plot great circle
ax.pole(strike, dip)	Plot pole to plane
ax.line(trend, plunge)	Plot lineation point
ax.density_contourf()	Filled density contours
mplstereonet.fit_girdle()	Best-fit great circle
mplstereonet.find_mean_vector()	Mean orientation

Essential Operations

Multiple Measurements with Contours

import numpy as np

strikes = [45, 52, 38, 48, 55, 41, 50, 43]
dips = [, , , , , , , ]

fig, ax = mplstereonet.subplots()


ax.density_contourf(strikes, dips, measurement=, cmap=)
ax.pole(strikes, dips, , markersize=)

ax.grid()
ax.set_title()
plt.savefig(, dpi=)