geombox 0.1.0

A unified python package to parse geospatial data formats and compute typed bounding boxes.

geombox

A unified, typed Python library to parse geospatial geometries from various formats (WKT, GeoJSON, Shapefiles) and compute their bounding boxes (BBox) and geometries in a target Coordinate Reference System (reprojecting to EPSG:4326 by default).

Installation

You can install geombox using pip:

# Build the wheel
pip wheel --no-deps -w dist .

# Install the built wheel
pip install dist/geombox-*.whl

Features

• Unified API: Parse multiple geometry representations (WKT, GeoJSON, Shapefiles) with a single function call.
• Typed Representation: Bounding boxes are returned as a typed, immutable dataclass (with helpers to export to tuple or GeoJSON dictionary formats).
• Automatic Reprojection: Safely handles coordinates reprojection using pyproj and shapely. High precision bounding box calculation reprojects the entire geometry prior to computing the bounds to prevent edge curvature errors.
• Robust Exception Handling: Custom, descriptive error types for parsing errors, reprojection failures, or invalid geometries.

Usage

import geombox

# Calculate a bounding box from a WKT string (automatically reprojected to EPSG:4326)
wkt_input = "POLYGON ((30 10, 40 40, 20 40, 10 20, 30 10))"
bbox = geombox.get_bbox(wkt_input)
print(bbox)
# BoundingBox(min_x=10.0, min_y=10.0, max_x=40.0, max_y=40.0, crs='EPSG:4326')

# Convert the bounding box representation
print(bbox.as_tuple())    # (10.0, 10.0, 40.0, 40.0)
print(bbox.as_geojson())  # GeoJSON dict polygon

# Parse and reproject to UTM zone 14N
utm_bbox = geombox.get_bbox(wkt_input, target_crs="EPSG:32614")
print(utm_bbox)

# Get the full reprojected shapely geometry
geom = geombox.get_geometry(wkt_input, target_crs="EPSG:4326")
print(geom.wkt)