supply-shed-change-brazil
unverified
v0.1.0
National (all-Brazil) profile of supply-shed-change: 319 sugar mills -> capacity-weighted sourcing sheds -> cane land-use-change per shed, cane-masked to real MapBiomas cane. Straight- line; a drive-time profile adds the OSRM distances table.
The contract
governed folia/0.1
Read from this recipe's own declarations — parameters:,
outputs:, requires:, and the ops its layers name. Not from its
style blocks and not from any benchmark: a colour ramp is not a contract, and a measured
run is evidence about one AOI rather than a domain.
Parameters
| parameter | type | domain | default | what it does |
|---|---|---|---|---|
facilities_uri |
string | local://inputs/mills_brazil.geojson |
Facility points (GeoJSON) with an optional capacity column. | |
transitions_uri |
string | local://inputs/transitions_national.parquet |
National per-H3 cane transitions (GeoParquet: h3, prior, post, area_ha; post==cane only). | |
distances_uri |
string | local://inputs/drivetime_stub.parquet |
Drive-time cost table (facility, h3, minutes) for distance=drivetime. Straightline loads but ignores it; this default is a one-row placeholder. | |
bbox |
array | of number, exactly 4 items | [-60.6,-24.5,-34.4,-1.5] |
National allocation-universe bbox [w, s, e, n] (mill extent + a haul margin). |
method |
string | huff |
Allocation rule — huff (capacity-weighted gravity) or voronoi (nearest). | |
distance |
string | straightline |
Distance metric — straightline (in-engine haversine km) or drivetime (OSRM table). | |
unit |
string | h3:6 |
Allocation unit (h3:N). Res-6 (~36 km2) is the national overview default. | |
haul_km |
number | >= 1 | 60 |
Haul bound (km) for distance=straightline. |
haul_min |
number | >= 1 | 90 |
Haul bound (drive-time MINUTES) for distance=drivetime. |
beta |
number | >= 0 | 2 |
Huff distance-decay exponent (assign to argmax capacity/dist^beta). |
capacity_field |
string | capacity_tc |
Per-facility capacity column (tonnes cane/season). | |
target_class |
number | 20 |
The commodity class transitions are screened INTO (MapBiomas 20 = sugar cane). | |
native_forest |
array | of number | [1,3,5,6,49] |
Native-forest prior classes (MapBiomas Collection 10). |
native_veg |
array | of number | [4,10,11,12,13,50] |
Native non-forest vegetation prior classes (savanna, wetland, grassland...). |
Outputs
| output | kind | layer | what it is |
|---|---|---|---|
shed |
table | shed |
Per-cell facility assignment. |
transitions_matrix |
table | transitions_matrix |
From-class -> to-class area (ha) per shed. |
shed_summary |
table | shed_summary |
Per-shed target area, new conversion, native slices. |
Capabilities it requires
Declares no requires: block, so it asks nothing of a host beyond the engine itself.
Where it runs
- Browser preview does not run here distances: source cannot be resolved without a server; facilities: source cannot be resolved without a server; shed: op "supply_shed_allocate" has no browser kernel; and 3 more
- Local CLI (folia run) runs here runs locally through the governed folia/0.1 parser
- Operated fleet (POST /plan, /run) runs here binds to a canonical digest, so a lock is checked by digest equality
open in Workbench
from
registry/recipes/supply-shed-change-brazil/folia.yaml