geopfa.extrapolation.check_param_limits_hit_from_constraints

check_param_limits_hit_from_constraints(model, constraints)

Identify kernel parameters whose optimized values lie at or extremely near their constrained lower or upper bounds.

Parameters:

• model (GPy.core.GP) – Trained GPy model. Must expose parameter_names() and allow indexing parameters via model[name].

• constraints (dict) –

  Dictionary describing parameter bounds (e.g., from build_and_fit_gp or build_combined_kernel). Expected format:

  {
      "rbf": {
          "variance": {"value": ..., "lower": ..., "upper": ...},
          "lengthscale": {...},
      },
      "matern32": { ... },
      "Gaussian_noise": {
          "variance": {"value": ..., "lower": ..., "upper": ...}
      },
      ...
  }
  

Returns:

list of tuple – A list of entries like (parameter_name_in_model, current_value_array, (lower, upper)) Each item corresponds to a parameter whose value is at/near its bounds (\(|value - bound| \leq 10^{-6}\)). Returns an empty list if none.

Notes

• Uses substring-prefix mapping (e.g., “rbf” → “sum.rbf”) to resolve to GPy’s internal parameter names.

• Bounds must be present in constraints for comparison.