femic.hydrology_disturbance

Annual harvest/road/retention disturbance ledgers.

P114.3 converts spatial harvest and road schedules into a complete annual ledger by unit and year. It is an accounting layer, not a hydrologic response.

Functions

build_disturbance_ledger(*, domain_id, ...)

Build a complete annual unit/year disturbance ledger.

load_disturbance_ledger(path)

Load a disturbance ledger from JSON.

load_disturbance_units_csv(path)

Load units from a CSV with unit_id, area_ha, watershed_id, hru_id.

load_harvest_events_csv(path)

Load harvest events from a CSV schedule.

load_road_events_csv(path)

Load road events from a CSV schedule.

validate_disturbance_ledger(ledger)

Validate ledger structure, completeness, and row conservation.

write_disturbance_ledger(ledger, path)

Write a disturbance ledger as pretty-printed JSON.

write_disturbance_ledger_csv(ledger, path)

Write one CSV row per unit/year for review and downstream joins.

Classes

DisturbanceLedger(ledger_id, generated_utc, ...)

Complete annual disturbance ledger for a hydrology domain.

DisturbanceLedgerRow(year, unit_id, ...[, ...])

One unit/year disturbance state.

DisturbanceLedgerValidation(is_valid, ...)

Validation outcome for a disturbance ledger.

DisturbanceUnit(unit_id, area_ha, watershed_id)

One spatial unit in the disturbance ledger.

HarvestEvent(event_id, unit_id, year, area_ha)

One harvest or retention event on a spatial unit.

HydrologyDisturbanceError

Raised when a disturbance schedule or ledger is invalid.

RoadEvent(event_id, road_id, unit_id, year, ...)

One road build, use, maintenance, or decommission event.