unityaaron/value-chain-exclusion-simulator

🌾 Interactive microeconomic policy simulation tool mapping smallholder certification barriers, structural value chain exclusion, and behavioral climate adoption dynamics using primary field data from Edo State, Nigeria. Built with a Predictive Random Forest Regressor backend. # 🌾 Value Chain Exclusion & Behavioral Adoption Simulator ### Developed by Unity Osagie-Aaron 🔗 **Live Interactive Application:** Launch the Live Simulator An end-to-end data science and machine learning application engineered to analyze, predict, and optimize smallholder farmer crop yields, market tier integration, and climate practice adoption constraints in Edo State, Nigeria. This repository integrates a predictive Random Forest backend with an interactive policy laboratory mapping multi-market relationships using primary smallholder field data. --- ## 📊 Project Architecture & System Overview The simulator is structured to handle behavioral variables, production economics, and macro institutional parameters smoothly: * **Predictive ML Backend (`machine_learning_model/`)**: Houses the trained, cross-validated Random Forest Regressor asset (`.pkl`) calibrated on our 50-farmer primary cohort. * **Microeconomic Engine (`app.py`)**: Houses the value chain classification tiers and margin gap logic mapping farm-gate prices to consumer willingness-to-pay (WTP) metrics. * **Behavioral Architecture**: Computes a composite Behavioral Adoption Score based on model-derived feature weights to isolate the tipping point where structural constraints block climate adaptation. --- ## 🧠 Key Analytical Discoveries & Performance Metrics ### 1. The Capacity-Building Nudge (Causal Robustness) Through multiple linear regression modeling, the intervention isolated the standalone impact of extension training. The training treatment effect remained statistically robust ($p < 0.05$) delivering an absolute yield jump (+15.68% to +16.5%), proving that yield gains are actively driven by behavioral capacity building rather than baseline farmer resource wealth. ### 2. Feature Engineering & Choice Architecture By tracking interactions between physical inputs and knowledge networks, the Random Forest model isolated the combined impact of physical resources and technical execution. * **Prim …