Royaltie-byte/HydroSense-Kenya

```markdown # HydroSense-Kenya A Scientific Computing System for Smart Irrigation, Water Balance Simulation, and Climate-Aware Decision Support. **Course:** ICS 2207: Scientific Computing | February–May 2026 Semester **Language:** Python --- ## Project Overview HydroSense-Kenya models soil-water balance, detects water stress, simulates future soil moisture under uncertainty, and recommends efficient irrigation decisions for a university demonstration farm in Kenya. The system uses 30 days of real weather and soil-sensor data across three crop zones (tomato, kale, maize). --- ## Folder Structure ``` HydroSense/ ├── data/ │ └── Kenya/ │ ├── 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 └── requirements.txt ``` --- ## Setup Instructions ### 1. Clone the repository ```bash git clone github.com cd HydroSense-Kenya ``` ### 2. Install dependencies ```bash pip install -r requirements.txt ``` ### 3. Run the notebooks in order Open Jupyter and run each notebook from Level 1 to Level 6 in sequence: ```bash jupyter notebook ``` ### 4. Run the tests ```bash pytest tests/ -v ``` --- ## Core Scientific Models ### Evapotranspiration ``` …