How chaitanyakumarai/pond_catchment_analysis works
AquaTerrain AI is a web-based pond-site and catchment planner. A user draws a parcel or uploads contour data; the API parses the input, builds or reuses terrain data, analyzes drainage and pond suitability, then returns mapped pond, catchment, and water-volume results. The README also documents whole-map analysis, coverage, plots/3D terrain, and a clustered runtime. The excerpts establish the main modules and load-balancer behavior; detailed API-to-analysis calls and several UI requests are not fully shown, so those links rely on README statements where applicable.
Main entry points: app.py Flask API · app.js Interactive map · terrain_analyzer.py Parcel hydrology · pond_lb.go Go load balancer
Components 14
Map experience
- Interactive map
static/app.js - Map page
templates/index.html
Analysis API
- Flask API
app.py - Model and result cache
app.py - KML/KMZ parser
kml_parser.py
Terrain analysis
- Terrain model
terrain_analyzer.py - Parcel hydrology
terrain_analyzer.py - Pond and catchment results
terrain_analyzer.py - Terrain plots and mesh
terrain_analyzer.py
Cluster runtime
- Go load balancer
cluster/pond_lb.go - Analysis workers
cluster/gunicorn.conf.py
Other components
- Land planner
- OpenStreetMap tiles
- Browser user
Connections 15
- Browser user → Interactive map: uses
README.md - Interactive map → Flask API: requests analysis
README.md - Flask API → Map page: renders
app.py - Flask API → KML/KMZ parser: parses contours
app.py - Flask API → Terrain model: builds terrain model
README.md - Flask API → Parcel hydrology: analyzes parcel
README.md - Parcel hydrology → Terrain model: uses terrain model
terrain_analyzer.py - Parcel hydrology → Pond and catchment results: returns results
README.md - Flask API → Model and result cache: caches results
app.py - Flask API → Terrain plots and mesh: serves plots and mesh
README.md - Interactive map → OpenStreetMap tiles: loads map tiles
static/app.js - Go load balancer → Analysis workers: proxies requests
cluster/pond_lb.go - Analysis workers → Flask API: serves API
README.md - Go load balancer → Analysis workers: checks health
cluster/pond_lb.go - Browser user → Go load balancer: uses cluster entry
README.md