README.md

metadata

title: AquiScore
emoji: 💧
colorFrom: blue
colorTo: indigo
sdk: docker
app_port: 7860
pinned: false
license: mit
short_description: Groundwater Security Scoring Engine v2.0

AquiScore — Groundwater Security API v2.0

Fuses NASA GRACE-FO satellite gravity x USGS NWIS well measurements x GLHYMPS hydrogeology to produce auditable groundwater security scores.

v2.0 Scientific Enrichments

• CCME Water Quality Index (F1/F2/F3 replaces linear quality scoring)
• DRASTIC groundwater vulnerability framework (EPA 7-parameter assessment)

v1.x Foundation

• Batch scoring (up to 500 sites per request)
• Response caching with content-hash keys
• GRACE seasonal decomposition (STL)
• Kriging spatial interpolation for wells

API Endpoints

Method	Path	Description
POST	/v1/score	Run aquifer security score (v2.0 enriched)
POST	/v1/score/batch	Batch score multiple aquifers
POST	/v1/certificate	Generate security certificate
POST	/v1/grace/decompose	GRACE TWS signal decomposition
POST	/v1/wells/interpolate	Kriging well field interpolation
POST	/v1/wqi	Standalone CCME Water Quality Index
POST	/v1/drastic	Standalone DRASTIC vulnerability
GET	/v1/aquifer-types	List aquifer types
GET	/v1/extraction-regimes	Extraction regime multipliers
GET	/v1/quality-thresholds	WHO/EPA water quality thresholds
GET	/v1/grace-hotspots	GRACE-FO depletion hotspots
GET	/v1/grace-regions	GRACE regional references
GET	/v1/presets/{name}/score	Run canonical preset
GET	/v1/cache/stats	Cache performance statistics
GET	/v1/health	Health check
GET	/docs	Interactive Swagger UI

Quick Start

curl https://YOUR-SPACE.hf.space/v1/health
curl https://YOUR-SPACE.hf.space/v1/presets/pristine/score