femic.hydrology_flood

Stochastic flood-frequency response surfaces.

P114.5 provides screening/decision-support frequency fits, paired-watershed response ratios, and nonstationary GEV response surfaces. It does not replace hydrologist review, public-gauge calibration, or regulatory flood analysis.

Functions

build_response_surface(fit, scenarios, *[, ...])

Build a return-period-specific response surface from scenarios.

evaluate_frequency_benchmark(pairing, benchmark)

Compare paired return-period ratios with a benchmark envelope.

extract_annual_maxima(events, *, station_id)

Extract one annual maximum per calendar year from event records.

extract_peaks_over_threshold(events, *, ...)

Extract declustered peaks over a threshold.

fit_flood_frequency(sample, *[, method, ...])

Fit a stationary GEV or LP3 frequency distribution.

fit_nonstationary_gev(sample, covariates, *)

Fit a GEV whose location is linear in time-varying covariates.

fit_pot_frequency(sample, *[, ...])

Fit a Poisson-GPD peaks-over-threshold frequency model.

paired_frequency_response(baseline, treatment, *)

Compare baseline and treatment return levels by return period.

predict_nonstationary_quantiles(fit, ...[, ...])

Predict return levels for one covariate scenario.

write_flood_frequency_report(fit, path)

Write a stationary frequency fit as JSON.

write_response_surface(surface, path)

Write a flood response surface as JSON.

Classes

FloodBenchmark(name, return_periods, ...[, ...])

Published or reviewed return-period ratio envelope.

FloodBenchmarkCheck(benchmark_name, is_pass, ...)

Benchmark comparison outcome.

FloodBenchmarkRow(return_period, ...)

One benchmark comparison row.

FloodEvent(event_date, value)

One observed peak-flow event.

FloodFrequencyFit(station_id, method, ...[, ...])

Stationary flood-frequency fit and return-level interval.

FloodResponseSurface(surface_id, ...[, ...])

Return-period-specific response surface.

FloodResponseSurfaceRow(scenario, ...)

One scenario/return-period response row.

FloodSample(station_id, years, values[, regime])

Annual-maximum peak-flow sample for one station.

FloodScenario(name, covariates)

One covariate scenario for a response surface.

FrequencyPairingResult(baseline, treatment, ...)

Baseline/treatment frequency pairing and return-period ratios.

HydrologyFloodError

Raised when a flood sample, fit, or response surface is invalid.

NonstationaryGevFit(station_id, ...[, ...])

Nonstationary GEV with a linear location model in covariates.

PotSample(station_id, events, threshold, ...)

Declustered peaks-over-threshold sample.