geopfa.extrapolation.report_model_fit

report_model_fit(model_assessment, report_metrics=True)[source]

Report (or warn about) model performance diagnostics.

This function interprets the dictionary produced by assess_gp_model_fit() and prints metrics that fall within acceptable ranges. If metrics exceed pre-defined thresholds for poor fit, warnings are raised instead.

Parameters:

  • model_assessment (dict) – Dictionary of GP regression metrics as returned by assess_gp_model_fit(). Expected keys include: 'RMSE', 'R2', 'Coverage_95', and 'Params_at_bounds'.

  • report_metrics (bool, optional) – If True (default), metrics that do not trigger warnings are printed. If False, only warnings are emitted.

Notes

Thresholds used:

  • HIGH_RMSE = 0.1

  • LOW_R2 = 0.8

  • LOW_COVERAGE = 0.90

  • HIGH_COVERAGE = 0.98

If any parameter lies at (or extremely near) its constraint bounds, a warning is raised regardless of report_metrics.