Dashboard walkthrough¶
/dashboard is a map with a guided selection bar above it and a detail panel to
its right. Signing in is required.
Making a selection¶
The bar above the map asks for four things in order. The map shows only WRUA outlines, with no data colouring, until the first three are answered, and a banner on the map says so.
| Step | Control | Notes |
|---|---|---|
| 1 | WRUA | A type-to-filter combobox over the 116 modelled WRUAs. Clearing it returns to the whole study area. |
| 2 | Month | One of the twelve calendar months. There is no annual option and no year selector: the data is a single 12-month climatology, so a month is the only meaningful time filter. |
| 3 | Scenario | Reallocation only, Storage only, or Reallocation + Storage. |
| 4 | Sub-watershed | Disabled until a WRUA is chosen. A type-to-filter combobox, or click a polygon on the map. |
Step 4 is optional for the map but required for the reallocation and storage metrics. Those figures are only meaningful for one sub-watershed at a time, because the routing columns describe water moving along a cascade and summing them across sub-watersheds would count the same water twice. The panel therefore shows them only once a sub-watershed is selected.
The map¶
A Leaflet map of the Central Highlands Ecoregions Foodscape (CHEF) in central Kenya.
Layers, from the layers button at the top right of the map:
| Layer | Default | Shows |
|---|---|---|
| WRUA boundaries | on | Every WRUA outline in the study area |
| Sub-watersheds | off | The sub-watershed polygons, coloured by the mode chosen below |
| Reallocation flow direction | on | For the selected sub-watershed, inflow from upstream and surplus passed downstream |
| Crop zones | off | Agro-ecological production-type polygons |
Colour sub-watersheds by offers two modes that are always available, Deficit and Surplus, plus a group that changes with the scenario:
- Under Reallocation or Reallocation + Storage: % deficit resolved, % deficit remaining, Reallocation priority.
- Under Storage or Reallocation + Storage: Recommended ponds, Priority class.
The legend at the bottom left changes with the mode. The deficit and surplus ramps are fixed across all twelve months, so one month can be compared against another.
Hover a sub-watershed for its id, elevation and figures. Click one to select it, which is the same as choosing it in step 4.
Three WRUA outlines have no cropland and therefore no modelled sub-watersheds. They are drawn for context and are not selectable.
The detail panel¶
The panel appears once a selection is made. With a sub-watershed chosen it shows, in order:
- Recommendation. The headline and narrative for the selected scenario and month, with the evidence behind them. The text is precomputed offline, not composed in the browser.
- Selection summary. Area, elevation and the cropland split into deficit, optimum and surplus.
- Reallocation metrics. Local surplus and deficit, what came in from upstream, what was met, what was passed downstream, and the share of the deficit resolved.
- Storage metrics. Ponds possible, needed and recommended, pond depth and area, suitability, reliability and retained fraction.
- Pond simulation charts. Typical water level per pond, cropland deficit volume, total stored volume across the watershed's ponds, and runoff against retained fraction.
- Monthly Water Balance. Surplus up and deficit down, per month, for the selected sub-watershed.
- Export. CSV and PDF for the current selection.
With no WRUA selected the panel shows the basin view instead: the study-area totals, the twelve sub-watersheds with the largest peak monthly deficit anywhere in the study area, and the priority intervention sites basin-wide, each labelled with its WRUA because sub-watershed ids repeat between WRUAs.
The Monthly Water Balance chart is scoped to a sub-watershed, so at basin scope it shows a prompt rather than a chart.
Reading the deficit¶
The deficit plotted under Reallocation and under Storage is the gross figure: the volume that has to be abstracted at the intake to satisfy the crop, including what is lost on the way. It is the crop requirement divided by the overall irrigation efficiency, so it is materially larger than the crop requirement alone. Under Reallocation + Storage the chart shows the residual left unmet after reallocation, which is smaller.
For the same reason, Reallocation and Storage plot the same deficit bars: storage is applied to the full gross deficit, so its demand curve is the gross deficit.
Tooltips¶
Hover any control, stat tile or chart heading for a one-line explanation of what it is and how it is aggregated. Several of them state the month scoping explicitly, which matters where a figure deliberately does not follow the month selector, such as Peak Deficit Area.