stage_damage

stage_damage(
    structures,
    occupancy_types,
    hydraulics,
    stage_frequency,
    stages,
    impact_area_id=1,
    deterministic=True,
)

Stage-damage curves from a structure inventory (ported ImpactAreaStageDamage).

See the R documentation for the field-by-field spec; shapes are identical with dicts in place of named lists and a dict of column lists in place of the data frame.

Scope note: the deterministic path is the oracle-validated one (upstream TractableStageDamageTests); occupancy types support structure and content curves plus CSVR/FFE/structure-value uncertainty (the subset the existing bindings marshal); the flow-frequency + discharge-stage input path stays internal (C++-validated only).

Returns

Name	Type	Description
	list of dict	One row per (damage_category, asset_category, stage): {"damage_category", "asset_category", "stage", "damage"}.