femic.hydrology_validation

P114.9 validation, public-gauge pilot, model card, and close-out.

This module does not add a new hydrologic model. It records published benchmark expectations, runs bounded public-gauge frequency backcasts, audits full-pilot readiness, and emits the validation report and model card that accompany a FEMIC response bundle.

Functions

assess_return_period_ratios(benchmark, ...)

Compare return-period ratios with one published expectation.

audit_pilot_readiness(*[, ...])

Audit whether a full two-watershed process pilot can be run.

build_benchmark_reviews([assessments])

Attach available assessments to the published benchmark catalogue.

build_model_card(*, pilot_run, ...[, ...])

Build the response-layer model card.

build_p1149_closeout(*, gauges_path, ...[, ...])

Run the bounded pilot and write the closeout records.

build_pilot_sample(gauge, rows)

Build a validated flood sample for one pilot gauge.

build_validation_report(pilot_run, *, readiness)

Build the deterministic validation report and linked model card.

load_pilot_annual_maxima(path)

Load annual maxima from the bounded pilot CSV.

load_pilot_gauges(path)

Load the bounded pilot gauge metadata fixture.

published_benchmarks()

Return the reviewed directional benchmark catalogue.

run_gauge_backcast(gauge, rows, *[, ...])

Fit GEV and LP3 to one public gauge and run a split-sample check.

run_public_gauge_pilot(gauges_path, ...[, ...])

Run the bounded P114.9 public-gauge pilot.

write_model_card(model_card, path)

Write a model card as JSON.

write_pilot_run(pilot_run, path)

Write a pilot run as JSON.

write_validation_report(report, path)

Write a validation report as JSON.

Classes

BenchmarkAssessment(case_id, is_consistent, rows)

Directional/order-of-magnitude assessment of one paired response.

BenchmarkCaseReview(case, assessment, ...)

Review status for one published benchmark case.

BenchmarkRow(return_period, observed_ratio, ...)

One return-period comparison against a published expectation.

CloseoutResult(output_dir, pilot_run, ...)

Paths and records produced by the P114.9 closeout run.

HydrologyValidationError

Raised when pilot or validation evidence is invalid.

ModelCard(model_card_id, model_id, ...[, ...])

Versioned model card for the P114 response layer.

PilotAnnualMaximum(station_number, year, ...)

One public annual maximum daily discharge value.

PilotGauge(station_number, station_name, ...)

Public gauge metadata for the bounded P114.9 pilot.

PilotGaugeBackcast(gauge, generated_utc, ...)

Public-gauge frequency backcast and data-quality record.

PilotReadiness(domain_available, ...[, gaps])

Full-pilot readiness and data-gap audit.

PilotRun(run_id, generated_utc, gauges, ...)

Serialized bounded public-gauge pilot.

PublishedBenchmark(case_id, regime, ...[, ...])

One directional/order-of-magnitude expectation from published work.

SplitSampleBackcast(split_year, ...[, ...])

Early/late split-sample frequency stability check.

TailCheck(method, shape, q100, observed_max, ...)

Screening plausibility check for one fitted tail.

ValidationReport(validation_id, ...[, ...])

P114.9 validation report and consumer handoff.