Fire-regime risk summaries ========================== Purpose ------- ``ws4.fire.risk`` summarizes simulated fire events as a risk distribution. It reuses the P187 scfm formulas but reports the behaviour of a process run rather than validating a published toy case. Inputs ------ The summary reads event-log-like records with ``year``, ``event_type``, ``area_ha``, and ``metadata.scenario_id``. Only ``fire`` events with an area contribute. A fire event without an area is an error. Outputs ------- The summary reports: - annual burned area, fire count, escaped count, and sizes; - total, mean, median, 90th-percentile, and maximum annual burned area; - burn probability and annual burn rate; - fire return interval; - fire counts and escaped fires per year; - mean, median, 90th-percentile, and maximum fire size; - optional P187 target diagnostics when a target and historical sample are supplied. A fire return interval is ``None`` when nothing burned. Reference case -------------- ``tests/test_fire_risk.py`` uses four years, 1000 ha, 10 ha cells, and fire sizes 5, 20, 100, 1, and 2 ha. It asserts total burned 128 ha, mean annual burned 32 ha, median 14 ha, 90th-percentile 77.5 ha, burn probability 0.75, FRI 31.25 years, mean fire size 25.6 ha, median 5 ha, and 90th-percentile 68 ha. Limits ------ - Deterministic summary only; no fire-growth simulation or calibration. - Target diagnostics need an explicit historical size sample. - Separate from event-perimeter validation. - LandMine FRI/reburn invariants remain a follow-up. - Process ensemble integration: ``ProcessEnsembleResult.fire_regime_summaries``. - Optimizer account bridge: ``ws4.opt.fire_risk.fire_regime_account_values``. - Process risk report: ``ws4.opt.fire_risk.evaluate_process_fire_risk``. - Report artifact: ``ProcessFireRiskReport.write`` (values, aggregated, JSON). - Train/validation: ``evaluate_process_fire_risk_validation`` and ``ProcessFireRiskValidation.write``. - Combined bundle: ``write_risk_verification_bundle``. - Existing optimizer output: ``bundle_existing_risk_verification``. - Explicit account comparison: ``ws4.opt.account_compare.compare_accounts``. - Shared-schedule integration test: ``tests/test_process_estate_shared_schedule.py``.