How vedsongire/ground_water_intelligence works
This is a deterministic groundwater monitoring and early-warning platform for India and Maharashtra. Its principal workflow ingests heterogeneous observations, normalizes and quality-flags them, derives analytical products, serves read-only API responses, and presents site and regional intelligence in a geospatial dashboard. The README documents major analytical capabilities beyond the sampled implementation excerpts; those are represented as distinct subsystems, with documented but unverified artifact production links marked dashed. Data ingestion and API wiring are more directly evidenced in source excerpts.
Main entry points: pipeline.py Ingestion pipeline · App.tsx Dashboard shell · quality.py Quality control · analytics.py Analytics endpoints
Components 28
Data preparation
- Ingestion pipeline
src/data/pipeline.py - Dataset loaders
src/data/loaders.py - Normalization
src/data/normalization.py - Quality control
src/data/quality.py
Hydrological analytics
- Temporal analysis
src/features/temporal.py - Seasonal analysis
src/features/seasonal.py - Spatial analysis
src/features/spatial.py - Historical baselines
src/features/baselines.py - Condition classification
src/features/conditions.py - Statistical alerts
src/alerting/engine.py - Persistence forecast
src/models/persistence_forecast.py - Drought intelligence
src/features/drought_intelligence.py - Flood potential
src/features/flood_intelligence.py - Groundwater stress
src/features/groundwater_stress.py - Advanced analytics
src/features/advanced_analytics.py - Trend analysis
src/features/trends.py
Read-only service
- DuckDB access
src/api/dal.py - Site endpoints
src/api/routes/candidate_sites.py - Analytics endpoints
src/api/routes/analytics.py - FastAPI service
src/api/main.py
Dashboard
- Dashboard shell
frontend/src/App.tsx - API client
frontend/src/services/api.ts - Site map
frontend/src/components/MapView.tsx - Site investigation
frontend/src/components/InvestigationPanel.tsx - Analytics view
frontend/src/components/AdvancedAnalytics.tsx
Other components
- Observation data
- Processed artifacts
- Dashboard user
Connections 32
- Observation data → Ingestion pipeline: supplies observations
- Ingestion pipeline → Dataset loaders: loads datasets
src/data/pipeline.py - Ingestion pipeline → Normalization: normalizes data
src/data/pipeline.py - Ingestion pipeline → Quality control: assesses quality
src/data/pipeline.py - Normalization → Quality control: flags records
- Ingestion pipeline → Processed artifacts: writes Parquet
src/data/pipeline.py - Quality control → Temporal analysis: enables features
- Quality control → Seasonal analysis: enables features
- Quality control → Spatial analysis: enables features
- Processed artifacts → Historical baselines: feeds analytics
- Processed artifacts → Condition classification: feeds analytics
- Processed artifacts → Statistical alerts: feeds analytics
- Processed artifacts → Persistence forecast: feeds analytics
- Processed artifacts → Drought intelligence: feeds analytics
- Processed artifacts → Flood potential: feeds analytics
- Processed artifacts → Groundwater stress: feeds analytics
- Processed artifacts → Advanced analytics: feeds analytics
- Processed artifacts → Trend analysis: feeds analytics
- Processed artifacts → DuckDB access: read by DuckDB
src/api/dal.py - FastAPI service → Site endpoints: registers routes
src/api/main.py - FastAPI service → Analytics endpoints: registers routes
src/api/main.py - Site endpoints → DuckDB access: queries data
src/api/routes/candidate_sites.py - Analytics endpoints → DuckDB access: queries data
src/api/routes/analytics.py - Analytics endpoints → Advanced analytics: uses analytics
src/api/routes/analytics.py - Analytics endpoints → Trend analysis: uses trends
src/api/routes/analytics.py - Dashboard user → Dashboard shell: uses dashboard
- Dashboard shell → API client: fetches sites
frontend/src/App.tsx - Dashboard shell → Site map: renders map
frontend/src/App.tsx - Dashboard shell → Site investigation: renders panel
frontend/src/App.tsx - Site investigation → API client: fetches site data
frontend/src/components/InvestigationPanel.tsx - Dashboard shell → Analytics view: renders analytics
- API client → FastAPI service: requests JSON