geotech-staff-engineer 3.0.0

Python toolkit for LLM-based geotechnical engineering agents — 30 analysis modules covering foundations, piles, slopes, seismic, and more

GeotechStaffEngineer

Python toolkit for LLM-based geotechnical engineering agents. 30 analysis modules covering foundations, piles, slopes, seismic analysis, ground improvement, and more.

Installation

# Core package (numpy + scipy + geotech-references)
pip install geotech-staff-engineer

# With all optional agent libraries
pip install geotech-staff-engineer[full]

# Or install individual extras
pip install geotech-staff-engineer[plot,groundhog,opensees]

Quick Start

from bearing_capacity import Footing, SoilLayer, BearingSoilProfile, BearingCapacityAnalysis

footing = Footing(width=2.0, length=10.0, depth=1.5, shape="strip")
layer = SoilLayer(phi_deg=30.0, c_kPa=10.0, gamma_kNm3=18.0, thickness_m=10.0)
profile = BearingSoilProfile(layers=[layer], gwt_depth_m=5.0)

analysis = BearingCapacityAnalysis(footing=footing, soil=profile)
result = analysis.calculate()
print(result.summary())

Modules

All units are SI (meters, kPa, kN, degrees). Every module returns dataclasses with .summary() and .to_dict() methods for easy LLM integration.

Core Analysis (15 modules)

Module	Purpose
bearing_capacity	Shallow foundations — Vesic, Meyerhof, Hansen
settlement	Consolidation and immediate settlement
axial_pile	Driven pile capacity — Nordlund, Tomlinson, Beta
sheet_pile	Cantilever and anchored sheet pile walls
lateral_pile	Lateral pile analysis — COM624P, 8 p-y models
pile_group	Rigid-cap pile groups — 6-DOF, efficiency factors
wave_equation	Smith 1-D wave equation — bearing graph, drivability
drilled_shaft	Drilled shaft capacity — GEC-10 alpha/beta/rock socket
seismic_geotech	Site classification, M-O pressures, liquefaction
retaining_walls	Cantilever and MSE retaining walls
ground_improvement	Aggregate piers, wick drains, vibro-compaction
slope_stability	Fellenius, Bishop, Spencer — circular slip surfaces
downdrag	Neutral plane method, dragload estimation
geotech_common	Shared soil profile, adapters, plotting utilities
calc_package	Calculation package report generation

Library Wrapper Agents (15 modules)

Each agent wraps a third-party geotechnical library with a dict-based API for LLM tool use.

Module	Library	Purpose
opensees_agent	OpenSeesPy	PM4Sand cyclic DSS, BNWF pile, 1D site response
pystrata_agent	pystrata	1D equivalent-linear site response
seismic_signals_agent	eqsig + pyrotd	Earthquake signal processing
liquepy_agent	liquepy	CPT-based liquefaction triggering
pygef_agent	pygef	GEF/BRO-XML CPT and borehole parsing
hvsrpy_agent	hvsrpy	HVSR site characterization
gstools_agent	gstools	Geostatistical kriging and random fields
ags4_agent	python-ags4	AGS4 data format reading and validation
salib_agent	SALib	Sobol and Morris sensitivity analysis
pyseismosoil_agent	PySeismoSoil	Nonlinear soil curve calibration
swprocess_agent	swprocess	MASW surface wave dispersion
geolysis_agent	geolysis	Soil classification and SPT corrections
pystra_agent	pystra	FORM/SORM/Monte Carlo reliability
pydiggs_agent	pydiggs	DIGGS 2.6 XML validation
groundhog_agent	groundhog	Site investigation and soil mechanics

Optional Extras

Extra	Libraries
plot	matplotlib
calc	jinja2
groundhog	groundhog
opensees	openseespy
pystrata	pystrata
seismic-signals	eqsig, pyrotd
liquepy	liquepy
pygef	pygef
hvsrpy	hvsrpy
gstools	gstools
ags4	python-ags4
salib	SALib
pyseismosoil	PySeismoSoil
swprocess	swprocess
geolysis	geolysis
pystra	pystra
pydiggs	pydiggs
full	All of the above

Related Package

geotech-references — Digitized NAVFAC DM7 and FHWA GEC reference library (installed automatically as a dependency).

License

MIT