sup3r.utilities.loss_metrics.GeothermalObsLoss

class GeothermalObsLoss(gen_features='all', true_features=None)

Bases: Sup3rLoss

Masked loss for geothermal observed quantities

This loss performs the masked observation matching described in [1]. It compares predicted geothermal channels against observed targets while ignoring missing observations. Units are inherited from the paired features, such as temperature in C, thermal conductivity in W/m-K, and heat flow in mW/m^2.

References

[1]

Aljubran, M. J., and Horne, R. N., “Thermal Earth model for the conterminous United States using an interpolative physics-informed graph neural network,” Geothermal Energy, vol. 12, no. 1, article 25, 2024. doi:10.1186/s40517-024-00304-7.

Initialize the loss with given input features

Parameters:

• gen_features (list | str) – List of generator output features that the loss metric will be calculated on. If ‘all’, the loss will be calculated on all generator features. Otherwise, the loss will be calculated on the features specified in the list. The order of features in the list will be checked to determine the order of features in the generator output tensor.

• true_features (list | str) – List of true features that the loss metric will be calculated on. If None, this will be the same as gen_features. The order of features in the list will be checked to determine the order of features in the ground truth tensor.

Methods

call(x_true, x_gen)	Evaluate the masked geothermal observation loss
from_config(config)
get_config()

Attributes

LOSS_METRIC
dtype

__call__(y_true, y_pred, sample_weight=None)

Call self as a function.

call(x_true, x_gen)

Evaluate the masked geothermal observation loss

The feature dimensions of x_true and x_gen must align with the configured generated and true features. Observed values may contain NaNs, which are ignored when computing the loss.