Shapely is a mature Python library for manipulation and analysis of planar geometric objects, serving as the computational geometry backbone for the geospatial Python ecosystem (GeoPandas, Fiona, etc.). It wraps the GEOS C++ library (the engine of PostGIS) and exposes both an object-oriented geometry interface (Point, LineString, Polygon, collections) and vectorized NumPy universal functions for high‑performance array operations on geometry arrays. Architecturally, the library consists of a C extension (`shapely.lib`) that provides a `Geometry` type and registers dozens of ufuncs, each wrapping a GEOS function. The Python modules in `shapely/` (constructive, predicates, measurement, set_operations, io, strtree, etc.) provide the public API, using decorators like `@multithreading_enabled` and `@requires_geos` to manage thread safety and version gating. The `STRtree` class (packed R‑tree) offers spatial indexing with `query`, `nearest`, and `query_nearest`. Key entry points include the top-level functions in `shapely/__init__.py` (e.g., `contains`, `intersection`, `buffer`, `from_wkt`), the geometry classes in `shapely/geometry/`, and the I/O and transformation utilities. The codebase is well-tested (300+ test files) and continuously integrated across GEOS 3.10–3.14 and multiple Python versions.
This repository is a Python application/library for generating 2D heatmaps from coordinate data. The core module src/heatmap77/heatmap.py implements a complete pipeline: file readers parse plain text, CSV, GPX, and ESRI Shapefile inputs; coordinate systems and projections (equirectangular, mercator) map lat/lon to pixel space; linear and gaussian kernels spread point mass; sparse matrix classes accumulate contributions with optional decay; and an ImageMaker renders the result to PNG/PPM, optionally compositing over OSM tiles or custom backgrounds. The package exposes both a CLI entry point (heatmap77) and a programmatic API used by the examples.