geointerpo 0.1.2

Spatial interpolation toolkit — boundaries, point data, 15 methods, export, validation

geointerpo

Spatial interpolation for Python — 15 algorithms, live data APIs, boundary clipping, and GEE validation.
Drop in point data, get a smooth interpolated raster out.

Fetch live weather, air quality, or precipitation data from Meteostat, OpenAQ, and Open-Meteo.
Define your study area by place name, polygon file, or bounding box — boundaries are resolved automatically.
Validate results against MODIS, CHIRPS, and Sentinel-5P satellite products via Google Earth Engine.
Export to GeoTIFF or NetCDF, run spatial cross-validation, and compare methods side by side.

📖 Documentation · Install · Quickstart · Methods · Examples

---

     

Ordinary Kriging · Natural Neighbor · Gaussian Process — same 60 stations, Alberta, Canada

---

Install

pip install "geointerpo[full]"

Quickstart

from geointerpo import Pipeline

result = Pipeline(
    data="stations.csv",               # CSV, GeoDataFrame, or live API
    boundary="Calgary, Alberta",       # place name, bbox, or polygon file
    method=["idw", "kriging", "spline"],
).run()

result.plot()            # side-by-side comparison
result.metrics_table()   # cross-validation RMSE / r
result.save("outputs/")  # GeoTIFF + PNG + CSV

---

Methods

geointerpo covers the full ArcGIS Spatial Analyst interpolation toolkit plus modern ML methods. All share the same interface — swap method= to compare.

Distance-based

The fastest methods — no statistical assumptions, exact at data points. Ideal as a quick baseline or when data is dense and evenly distributed.

     

idw · nearest · linear · cubic

Spline & Trend

Fit smooth continuous surfaces. Splines minimise curvature; RBF offers eight kernel choices; Trend fits a global polynomial for large-scale patterns.

     

spline · spline_tension · rbf · trend

Geostatistical

Account for spatial autocorrelation via a variogram model. Produce statistically optimal, unbiased estimates. Natural Neighbor uses Voronoi area-stealing weights — smooth and exact at data locations.

   

kriging (Ordinary) · uk (Universal) · natural_neighbor

Machine Learning

Capture non-linear spatial patterns. GP returns a full uncertainty surface alongside the mean prediction. Regression Kriging combines an ML trend with Kriging of the residuals.

     

gp (Gaussian Process) · rf (Random Forest) · gbm (Gradient Boosting) · rk (Regression Kriging)

---

References

• ArcGIS Pro — Interpolation Tools Overview
• 3 Best Methods for Spatial Interpolation — Towards Data Science
• GeoStat-Framework/PyKrige — Ordinary, Universal, and Regression Kriging
• GeoStat-Framework/GSTools — Covariance models, variograms, random fields
• mmaelicke/scikit-gstat — Variogram estimation and ordinary kriging
• DataverseLabs/pyinterpolate — IDW, kriging, Poisson kriging
• fatiando/verde — Machine-learning-style spatial gridding
• GeostatsGuy/GeostatsPy — GSLIB-based geostatistics