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_ha and eca_fraction;

  • road_active_km and road_connected_km;

  • road_density_km_per_km2 and connected_road_density_km_per_km2;

  • road_connected_fraction;

  • crossing_count and crossing_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.

Cross-References