geotech-references

Digitized geotechnical reference library: callable Python functions for NAVFAC DM7 and FHWA GEC series equations, figures, and tables.

Installation

pip install geotech-references

Overview

This package provides 559 digitized functions from major geotechnical engineering references, turning published figures, tables, and equations into callable Python code.

from geotech_references.dm7_1.chapter1 import table_1_4_uscs_classification

result = table_1_4_uscs_classification(
    gravel_pct=25, sand_pct=55, fines_pct=20,
    liquid_limit=35, plasticity_index=12
)
print(result)  # {'symbol': 'SC', 'description': 'Clayey sand'}

Contents

NAVFAC DM7 (382 functions, 2,008 tests)

FHWA GEC Series & Micropile (95 functions, 802 tests)

FEMA, NOAA & UFC Standards (54 functions, 489 tests)

Text Retrieval

Structured chapter text is available for GEC-6, GEC-7, GEC-10, GEC-12, GEC-13, and Micropile references:

from geotech_references._retrieval import search_sections

results = search_sections("gec_12", "pile setup")
for section in results:
    print(section["title"], "-", section["body"][:100])

Agents

Pre-built Foundry-style agent wrappers are included for all 14 references in the agents/ directory. These are standalone files for Palantir Foundry AIP Agent Studio — they are not part of the pip-installable geotech-references package. Copy them into your Foundry function repository as needed.

from agents.dm7_agent import dm7_agent, dm7_list_methods

# List available methods
print(dm7_list_methods("chapter1"))

# Call a specific function
result = dm7_agent("table_1_4_uscs_classification", '{"gravel_pct": 25, "sand_pct": 55, "fines_pct": 20, "liquid_limit": 35, "plasticity_index": 12}')

License

MIT