ESFEX v0.1.4
Added
- Reservoir hydropower modelling overhaul (#4) — hydroelectric generators
are now dispatched against an explicit water-energy budget in both the
operational dispatch and the capacity-expansion master, instead of being
treated as firm capacity. Five behaviours, each independently optional and
fully wired into the Studio GUI (en/es/ja):- Energy budget — water balance (inflow, turbining, pumping, spillage,
evaporation) modelled in the master, correcting hydro that was previously
over-credited as firm MW. - Minimum environmental flow — a mandatory ecological release floor.
- Seasonal storage — reservoir level chained chronologically across
representative periods (TSAM inter-period linking), so water banked in a wet
season is available in a later dry one. - Hydraulic cascade — an upstream reservoir's release feeds a downstream
reservoir, with an optional travel delay. - Head dependence — a depleted reservoir delivers less peak power, via a
linear (LP-friendly) level-dependent power limit.
- Energy budget — water balance (inflow, turbining, pumping, spillage,
Fixed
- Deleting a system left orphan inter-system links (#5) — links whose
endpoints referenced a deleted system survived in the project and were
silently dropped by the runner. Deletion now removes every link touching the
system. - Grid Builder country detection (#6) — step 3 reverse-geocoded the
bounding-box centroid via Nominatim, folding territories into their sovereign
state (Puerto Rico to United States), finding only one country per region
(Haiti was missed), and returning localized names. Detection is now offline
and territory-aware: grid nodes are tested against bundled country polygons,
surfacing every country the region intersects with correct ISO3 codes.
Documentation
- New reservoir-hydropower formulation page documenting the water balance and
all five behaviours as LP constraints; reservoir config/GUI fields and the
constraint catalogue updated. - README links the companion repositories and uses Harvey-ball icons in the
feature comparison table.
Full changelog: v0.1.3...v0.1.4