sigmap-pytools#
A Python package for downloading and manipulating geometries by subdividing them using geohash. This package provides efficient tools for spatial processing, geohash-based polygon subdivision, and visualization.
What is sigmap-pytools?#
sigmap-pytools is a Python package that enables efficient spatial processing by subdividing polygon geometries using geohash encoding. It provides tools for:
Geohash-based Polygon Subdivision: Generate adaptive or fixed-level geohash coverage for any polygon geometry
GADM Integration: Download country geometries directly from the GADM database
Coordinate Encoding: Convert coordinates to geohash strings and vice versa
Flexible Coverage Algorithms: - Adaptive coverage with multi-level refinement - Single-level coverage for uniform tiling
Visualization Tools: Plot geohash coverage with customizable styling
Installation#
Install from PyPI:
pip install sigmap-pytools
Requirements#
Python >=3.12
geopandas >=1.1.1
shapely >=2.1.2
numpy >=2.3.3
pandas >=2.3.3
matplotlib
Quick Start#
import sigmap.polygeohasher as polygeohasher
from shapely.geometry import Point
import geopandas as gpd
# Download a country geometry
belgium = polygeohasher.download_gadm_country("BEL", level=0)
# Generate adaptive geohash coverage
coverage = polygeohasher.adaptive_geohash_coverage(
belgium.geometry.iloc[0],
max_level=5,
threshold=0.95
)
# Plot the results
polygeohasher.plot_geohash_coverage(
belgium.geometry.iloc[0],
coverage,
style='adaptive'
)