env-able 0.2.0

AI-ready GIS toolkit for energy and subsurface workflows.

env-able

An open source spatial analysis library built for AI-driven GIS workflows. Designed to give AI systems like Claude reliable, hallucination-free tools for spatial operations in energy and subsurface contexts.

Install

pip install env-able

Functions

e.Intersect(input_layer, intersect_layer, output=None)

Computes geometric intersection of input features against a polygon boundary.

• input_layer — point, line, or polygon (file path or GeoDataFrame)
• intersect_layer — polygon layer defining the intersection boundary
• output — file path to save result (.gpkg, .shp, etc.) — omit to return a GeoDataFrame

import env_able as e
e.Intersect("wells.shp", "boundary.shp", "result.gpkg")

---

e.Buffer(input_layer, distance, unit="meters", output=None)

Buffers input features by a given distance and unit.

• input_layer — point, line, or polygon (file path or GeoDataFrame)
• distance — numeric buffer distance
• unit — meters, km, miles, feet, usfeet, nautical miles
• output — file path to save result — omit to return a GeoDataFrame

e.Buffer("wells.shp", 1, "miles", "wells_buffer.gpkg")

---

e.Clip(input_layer, clip_layer, output=None)

Clips input features to the extent of a polygon clip boundary.

• input_layer — point, line, or polygon (file path or GeoDataFrame)
• clip_layer — polygon layer defining the clip boundary
• output — file path to save result — omit to return a GeoDataFrame

e.Clip("roads.shp", "county.shp", "roads_clipped.gpkg")

---

e.morph(input_path, output_path, **kwargs)

Universal format translation. Converts between shp, gpkg, gdb, csv, xlsx, xls, dbf, geojson, json with automatic CRS handling, field name fixes, and multi-layer support.

• input_path — source file or geodatabase
• output_path — destination file. Extension sets the format. Use trailing / for directory output (one file per layer). Use dot notation for named layers: roads.parcels.gpkg
• x_col, y_col — column names for X/Y coordinates (auto-detected if not provided)
• wkt_col — column containing WKT geometry (auto-detected if not provided)
• crs — coordinate reference system e.g. EPSG:4326 (required for tabular → spatial)

e.morph("roads.shp", "roads.gpkg")
e.morph("county.gdb", "county.gpkg")
e.morph("county.gdb", "output_folder/")
e.morph("owners.csv", "owners.geojson", crs="EPSG:4269")
e.morph("owners.csv", "owners.shp", x_col="LONGITUDE", y_col="LATITUDE", crs="EPSG:4269")
e.morph("roads.gpkg", "roads.parcels.gpkg")
e.morph("data.json", "data.gpkg")

Smart behavior:

• GDB / GPKG with multiple layers → detects all layers automatically
• CRS mismatch → auto-reprojects
• Shapefile field name limit (10 chars) → auto-truncates with warnings
• Invalid output path → plain English error
• Empty layers → skipped with a warning, not a crash

---

Changelog

v0.1.0 — 2026-07-14

• Initial release of env-able
• Intersect(), Buffer(), Clip() with full guardrails
• morph() — universal format translation
• Smart geometry detection for WKT and lat/lon columns
• GeoJSON, JSON support with auto WGS84 reprojection
• Multi-layer GDB/GPKG support