femic.hydrology_surrogate

Surrogate models for fast hydrologic response queries.

P114.7 provides a design-of-experiments surface, two dependency-free surrogate families (ridge linear and RBF Gaussian process), held-out validation, and an explicit applicability domain that refuses extrapolation.

Functions

attach_targets(design, targets, *[, ...])

Attach process-model targets to a design.

build_latin_hypercube_design(factors, *, ...)

Build a Latin-hypercube design over continuous factors.

cross_validate_surrogate(dataset, *[, ...])

Run deterministic k-fold cross-validation for one surrogate family.

evaluate_surrogate(model, dataset, *[, ...])

Evaluate a surrogate against held-out samples.

fit_surrogate(dataset, *[, family, ridge, ...])

Fit one of the dependency-free surrogate families.

load_surrogate(path)

Load a surrogate model from JSON.

save_surrogate(model, path)

Save a surrogate model as JSON.

train_validation_split(dataset, *[, ...])

Split a dataset into deterministic train/validation subsets.

Classes

ApplicabilityDomain(feature_names, ...)

Bounded feature envelope plus standardized-distance guard.

ApplicabilityResult(inside[, ...])

Whether a query lies inside a surrogate's validated domain.

DesignFactor(name, low, high)

One continuous factor in a surrogate design.

DesignPoint(features)

One feature vector from a surrogate design.

GaussianProcessSurrogate(feature_names, ...)

RBF-kernel Gaussian-process surrogate.

HydrologySurrogateError

Raised when a surrogate design, model, or query is invalid.

LinearSurrogate(feature_names, mean_values, ...)

Standardized ridge-linear surrogate.

SurrogateDataset(feature_names, target_name, ...)

A validated surrogate training or validation dataset.

SurrogateDesign(design_id, generated_utc, ...)

Latin-hypercube design over continuous hydrologic factors.

SurrogateModel(*args, **kwargs)

Protocol for a validated surrogate model.

SurrogateSample(features, target)

One feature/target training or validation sample.

SurrogateValidation(model_family, ...[, ...])

Validation metrics for a surrogate against held-out targets.