dayeon603-pixel/harvestguard-models

Open engineering models for solar cold storage serving smallholder horticulture in sub-Saharan Africa, and the signed-event trust rail built on them. Design and validation only — no pod has been built. # HarvestGuard — models and trust rail Open engineering models for solar-powered cold storage serving smallholder horticulture in sub-Saharan Africa, and the payment-and-record layer that runs on top of them. Everything here is reproducible offline: climatology is cached, so the same input gives the same number on any machine. > **Status.** These are design and validation models. **No physical pod has been built.** > Every figure below is what the physics says should happen; none of it is a field measurement. > Each write-up ends with an explicit boundaries section stating what its model cannot support. --- ## `sim/` — the engineering models | Module | What it does | |---|---| | `ghana_energy_model.py` | Steady-state monthly energy balance: PV supply against conduction, infiltration, produce pull-down and respiration, with a condition-dependent COP | | `ghana_sensitivity.py` | Swings eight assumptions independently and reports whether the conclusion survives | | `ho_dynamic_sim.py` | 8,784-hour dynamic run on real hourly weather, integrating box temperature and battery state of charge as coupled states | | `pod_thermal_3d.py` | 8,925-cell finite-volume model of the pod interior, backward Euler on a prefactorised sparse operator | | `pod_loading_policy.py` | How much field-hot produce the pod can absorb per cycle | | `africa_sizing_engine.py` | Sizes array and battery for any site, then partitions 33 regions into a minimal SKU set by exact dynamic program | | `ghana_circularity.py` | Material loop and emissions, with an internal consistency check | | `fetch_africa_sites.py` | Fetches and caches NASA POWER climatology | | `africa_atlas.py`, `pod_thermal_figure.py` | Figures | **Write-ups:** `GHANA_SITE_TRANSFER.md`, `DYNAMIC_VALIDATION.md`, `THERMAL_3D.md`, `AFRICA_DEPLOYMENT.md` ### Three findings worth reading **A pod sized for one African site fails at another.** Moved unchanged from an East African highland baseline to Ho, Volta Region, the design runs an …