VRI to FBP fuel-type mapping
Purpose
VRI attributes describe a stand; they are not a fuel model. ws4.fire.vri maps a
VRI-style description to a Canadian FBP fuel type and records why. The mapping is a
deterministic WS4 modelling decision, not a measurement, and every assignment carries its
rule, version, source fields, and confidence.
Input contract
VriStand carries:
stand_id;leading_speciesas a BC species code or common name, such asPlorLodgepole pine;conifer_fractionanddeciduous_fractionin [0, 1];crown_closure_percentin [0, 100];optional
age_yearsandheight_m;land_cover(defaultforest);optional explicit
fuel_type;optional
treatmentsuch asslashormatted grass.
Species aliases are normalized to two-letter codes. A slash-separated label such as
Pl/Sx uses the first code. An unknown species raises rather than guessing.
Rule order
The rules are applied in this order. The first match wins.
Rule id |
Condition |
FBP type |
|---|---|---|
|
The stand carries an explicit FBP fuel type. |
That type. |
|
The explicit type is |
None. |
|
Land cover is non-forest, water, urban, rock, or ice. |
None. |
|
Wetland with at least 50 percent conifer / otherwise. |
|
|
Land cover is slash. |
|
|
Grass, shrub, or agriculture, with or without a matted treatment. |
|
|
A forest stand carries a slash treatment. |
|
|
Crown closure below 5 percent or total tree cover below 5 percent. |
None. |
|
Conifer and deciduous fractions are both at least 30 percent and the stand is young or short. |
|
|
Conifer and deciduous fractions are both at least 30 percent. |
|
|
The leading species is deciduous, or deciduous cover is at least 70 percent with conifer below 30 percent. |
|
|
Pine leading, age at least 40 years / younger or unknown. |
|
|
Douglas-fir leading. |
|
|
Larch leading. |
|
|
Spruce, fir, cedar, or hemlock leading, crown closure below 40 percent / at least 40 percent. |
|
An unmapped leading species raises VriError. A forest stand with no leading species
also raises. The mapping never silently invents a fuel type.
Provenance
FbpFuelAssignment records:
fuel_type: the canonical FBP type, or None for an explicit non-fuel stand;rule_id: the first rule that matched;version:ws4.vri-fbp.v1;confidence: a rule-level value in [0, 1];source_fields: the VRI fields the rule used;notes: a short explanation.
map_vri_table returns one row per stand with the same fields and an is_burnable
flag.
Example
from ws4.fire.vri import VriStand, map_vri_stand
stand = VriStand(
stand_id="stand-1",
leading_species="Pl",
conifer_fraction=0.9,
deciduous_fraction=0.1,
crown_closure_percent=55.0,
age_years=75,
height_m=22.0,
)
assignment = map_vri_stand(stand)
print(assignment.fuel_type, assignment.rule_id, assignment.confidence)
# C3 pine-mature 0.8
Validation
The fixture tests/fixtures/fire/vri_fbp_stands.csv contains representative stands for
pine, Douglas-fir, spruce, deciduous, mixedwood, grass, slash, explicit fuel types, non-fuel,
and an unknown species. The tests assert the expected type and rule for every record, the
provenance fields, the unknown-species failure, and the table output.
The fixture is synthetic and representative. It is not a copy of a private VRI inventory.
Limits
The mapping is not a regional calibration. The rules are transparent defaults, and a regional fuel map should replace or tune them with local evidence.
Species codes and rule thresholds are BC-oriented.
Crown fire and growth consume the mapped type but do not feed back into the mapping.
A non-fuel assignment returns None; it must not be passed to the FBP kernel.
Confidence is a rule-level indicator, not a probability calibrated against observed fire behaviour.