Tier 0 Hydrology Screening Contract
Purpose
This page is the short source-of-truth contract for FEMIC P114.4 Tier 0 screening metrics. It defines the metric grain, ECA semantics, road/crossing metrics, exposure context, regime flags, caveats, and output schema.
Tier 0 is a screening diagnostic, not a hydrologic response model.
Quick Contract
Schema:
femic.hydrology.screening.v1.Grain: one row per watershed per year.
Inputs: disturbance ledger, hydrology domain, optional regimes, optional unit exposure contexts, optional recovery period.
ECA is diagnostic and may be undiscounted or linearly discounted.
Road metrics are active-state density metrics.
Exposure metrics are context-weighted fractions, not geometry intersections.
No instance-specific threshold or operational decision.
Metric Definitions
Per watershed/year:
harvest_area_ha,retention_area_ha,effective_harvest_area_ha;harvest_fraction;eca_area_haandeca_fraction;road_active_kmandroad_connected_km;road_density_km_per_km2andconnected_road_density_km_per_km2;road_connected_fraction;crossing_countandcrossing_density_per_km2;riparian_effective_harvest_ha;snow_transient_effective_harvest_ha;high_elevation_effective_harvest_ha.
ECA Semantics
ECA uses the most recent harvest per unit. Without recovery_years it is
undiscounted and the report carries a warning. With recovery_years the last
effective harvest area declines linearly to zero over that period.
ECA is explicitly not a frequency-based peak-flow response and not a substitute for P114.5.
Road And Crossing Metrics
Active road length is the disturbance-ledger active length sum.
Connected road length is the active length flagged connected to streams.
Road density uses watershed area in km².
Crossing density uses active crossings and watershed area in km².
A zero active road length produces a null
road_connected_fraction.
Exposure Context
UnitExposureContext carries reviewed fractions in [0, 1]:
riparian_fraction;snow_transient_fraction;high_elevation_fraction.
The metrics multiply current-year effective harvest area by these fractions. They are not geometry intersections and do not imply a spatial buffer or elevation model.
Regimes
Allowed regimes are rain, rain_on_snow, snowmelt,
snow_transient, and unknown. Missing regimes default to unknown and
produce a warning. Regime is a metadata flag, not a model.
Caveats
Tier 0 metrics are screening diagnostics, not a flood response.
ECA is not a substitute for frequency-based hydrologic analysis.
Context-weighted exposure is not a geometry intersection.
No instance-specific threshold or operational decision is applied.
The report does not replace hydrologist or field review.