WinnieMG-111/HydroSense-Kenya

# HydroSense-Kenya **ICS 2207 Scientific Computing — Capstone Project** A scientific computing system for smart irrigation, water balance simulation, and climate-aware decision support for Kenyan smallholder farms. --- ## Project Overview HydroSense-Kenya models soil-water balance, estimates evapotranspiration, simulates future soil-moisture trajectories, and recommends optimized irrigation schedules using data from three farm zones (Zone_A: tomato, Zone_B: kale, Zone_C: maize). ### Central Scientific Question > Given weather and soil-sensor data, how can we model water availability, estimate water deficit, simulate future soil moisture, and recommend an efficient irrigation plan that minimizes water use without exposing crops to moisture stress? --- ## Repository Structure ``` HydroSense-Kenya/ ├── data/ │ ├── raw/ │ │ ├── weather_daily.csv │ │ ├── soil_sensor_data.csv │ │ └── crop_zone_parameters.csv │ └── processed/ │ └── cleaned_irrigation_dataset.csv ├── notebooks/ │ ├── Level_1_Problem_Framing.ipynb │ ├── Level_2_Vectorization_and_Error.ipynb │ ├── Level_3_Numerical_Methods.ipynb │ ├── Level_4_Data_Analysis_and_Visualization.ipynb │ ├── Level_5_Simulation_and_Optimization.ipynb │ └── Level_6_Final_Integration.ipynb ├── src/ │ ├── data_cleaning.py │ ├── numerical_methods.py │ ├── simulation.py │ ├── optimization.py │ └── visualization.py ├── tests/ │ ├── test_root_finding.py │ ├── test_integration.py │ ├── test_linear_systems.py │ └── test_simulation.py ├── reports/ │ ├── final_scientific_report.pdf │ └── presentation_slides.pdf ├── AI_USE_LOG.md ├── README.md ``` --- ## Setup ```bash # 1. Clone the repository git clone cd HydroSense-Kenya # 2. Create and activate a virtual environment (recommended) python -m venv venv venv\Scripts\activate # 3. Install dependencies pip install # 4. Place raw datasets in data/raw/ # weather_daily.csv, soil_sensor_data.csv, crop_zone_parameters.csv # 5. …