How seababy-i/soil_analysis works
This repository is a soil analytics project: image classification and structured nutrient-deficiency models produce complementary assessments, with SHAP and Grad-CAM explanations and a hybrid assessment. It also contains a standalone soil recommendation engine. The README documents the ML stages and hybrid flow; the sampled engine excerpt confirms its knowledge-base read. Notebooks and model artifacts are represented at their existing paths; unsampled implementation details are not inferred.
Main entry points: 08_Hybrid_Soil_Analysis.ipynb Late-fusion assessment · 05_Structured_Soil_ML.ipynb Nutrient modeling · efficientnet_soil_classifier_finetuned.keras Fine-tuned classifier · N_deficiency_gradient_boosting.pkl Nitrogen model
Components 18
Image Classification
- Fine-tuned classifier
models/efficientnet_soil_classifier_finetuned.keras - Image modeling
notebooks/04_CNN_Soil_Image_Classification.ipynb - Grad-CAM explanations
notebooks/07_GradCAM_Explainability.ipynb - Grad-CAM outputs
Outputs/GradCAM
Nutrient Assessment
- Nutrient modeling
notebooks/05_Structured_Soil_ML.ipynb - Nitrogen model
models/N_deficiency_gradient_boosting.pkl - Phosphorus model
models/P_deficiency_gradient_boosting.pkl - Potassium model
models/K_deficiency_gradient_boosting.pkl - SHAP explanations
notebooks/06_SHAP_Explainability.ipynb - SHAP plots
Outputs/SHAP
Hybrid Assessment
- Late-fusion assessment
notebooks/08_Hybrid_Soil_Analysis.ipynb - Hybrid results
Outputs/Hybrid/hybrid_results.csv
Soil Advisory
- Recommendation engine
recommendation/recommendation_engine.py - Agricultural knowledge
recommendation/agricultural_knowledge_base.json - Crop suitability data
recommendation/crop_suitability.json
Other components
- Soil analyst
- Soil image
- Soil measurements
Connections 19
- Soil analyst → Soil image: provides image
README.md - Soil analyst → Soil measurements: provides measurements
README.md - Soil image → Fine-tuned classifier: classifies image
README.md - Image modeling → Fine-tuned classifier: trains model
README.md - Soil measurements → Nitrogen model: predicts deficiency
README.md - Soil measurements → Phosphorus model: predicts deficiency
README.md - Soil measurements → Potassium model: predicts deficiency
README.md - Nutrient modeling → Nitrogen model: trains model
README.md - Nutrient modeling → Phosphorus model: trains model
README.md - Nutrient modeling → Potassium model: trains model
README.md - SHAP explanations → SHAP plots: generates plots
README.md - Grad-CAM explanations → Grad-CAM outputs: visualizes regions
README.md - Fine-tuned classifier → Late-fusion assessment: supplies soil type
README.md - Nitrogen model → Late-fusion assessment: supplies nutrient status
README.md - Phosphorus model → Late-fusion assessment: supplies nutrient status
README.md - Potassium model → Late-fusion assessment: supplies nutrient status
README.md - Late-fusion assessment → Hybrid results: records results
README.md - Soil analyst → Recommendation engine: submits soil data
- Recommendation engine → Agricultural knowledge: loads guidance
recommendation/recommendation_engine.py