class EquilibriumClimateSensitivity(ESMValToolDiagnostic):
"""
Calculate the global mean equilibrium climate sensitivity for a dataset.
"""
name = "Equilibrium Climate Sensitivity"
slug = "equilibrium-climate-sensitivity"
version = 2
base_recipe = "ref/recipe_ref_ecs.yml"
variables = (
"rlut",
"rsdt",
"rsut",
"tas",
)
data_requirements = (
(
DataRequirement(
source_type=SourceDatasetType.CMIP6,
filters=(
FacetFilter(
facets={
"variable_id": variables,
"experiment_id": "abrupt-4xCO2",
"table_id": "Amon",
},
),
),
group_by=("source_id", "member_id", "grid_label"),
constraints=(
RequireOverlappingTimerange(group_by=("instance_id",)),
AddParentDataset.from_defaults(SourceDatasetType.CMIP6),
RequireContiguousTimerange(group_by=("instance_id",)),
RequireFacets(
"variable_id",
required_facets=variables,
group_by=("source_id", "member_id", "grid_label", "experiment_id"),
),
AddSupplementaryDataset.from_defaults("areacella", SourceDatasetType.CMIP6),
),
),
),
(
DataRequirement(
source_type=SourceDatasetType.CMIP7,
filters=(
FacetFilter(
facets={
"branded_variable": (
"rlut_tavg-u-hxy-u",
"rsdt_tavg-u-hxy-u",
"rsut_tavg-u-hxy-u",
"tas_tavg-h2m-hxy-u",
),
"experiment_id": "abrupt-4xCO2",
"frequency": "mon",
"region": "glb",
},
),
),
group_by=("source_id", "variant_label", "grid_label"),
constraints=(
RequireOverlappingTimerange(group_by=("instance_id",)),
AddParentDataset.from_defaults(SourceDatasetType.CMIP7),
RequireContiguousTimerange(group_by=("instance_id",)),
RequireFacets(
"variable_id",
required_facets=variables,
group_by=("source_id", "variant_label", "grid_label", "experiment_id"),
),
AddSupplementaryDataset.from_defaults("areacella", SourceDatasetType.CMIP7),
),
),
),
)
facets = ("grid_label", "member_id", "source_id", "region", "metric")
series = (
SeriesDefinition(
file_pattern="ecs/calculate/ecs_regression_*.nc",
dimensions={
"statistic": ("global annual mean anomaly of rtnt vs tas"),
},
values_name="rtnt_anomaly",
index_name="tas_anomaly",
attributes=[],
),
)
files = (
FileDefinition(
file_pattern="plots/ecs/calculate/*.png",
dimensions={"statistic": "global annual mean anomaly of rtnt vs tas"},
),
FileDefinition(
file_pattern="work/ecs/calculate/ecs.nc",
dimensions={"metric": "ecs"},
),
FileDefinition(
file_pattern="work/ecs/calculate/lambda.nc",
dimensions={"metric": "lambda"},
),
)
test_data_spec = TestDataSpecification(
test_cases=(
TestCase(
name="cmip6",
description="Test with CMIP6 data.",
requests=(
CMIP6Request(
slug="cmip6",
facets={
"experiment_id": ["abrupt-4xCO2", "piControl"],
"source_id": "CanESM5",
"variable_id": ["areacella", "rlut", "rsdt", "rsut", "tas"],
"frequency": ["fx", "mon"],
},
remove_ensembles=True,
),
),
),
TestCase(
name="cmip7",
description="Test with CMIP7 data.",
requests=(
CMIP7Request(
slug="cmip7",
facets={
"experiment_id": ["abrupt-4xCO2", "piControl"],
"source_id": "CanESM5",
"variable_id": ["areacella", "rlut", "rsdt", "rsut", "tas"],
"branded_variable": [
"areacella_ti-u-hxy-u",
"rlut_tavg-u-hxy-u",
"rsdt_tavg-u-hxy-u",
"rsut_tavg-u-hxy-u",
"tas_tavg-h2m-hxy-u",
],
"variant_label": "r1i1p1f1",
"frequency": ["fx", "mon"],
"region": "glb",
},
remove_ensembles=True,
),
),
),
)
)
@staticmethod
def update_recipe(
recipe: Recipe,
input_files: dict[SourceDatasetType, pandas.DataFrame],
) -> None:
"""Update the recipe."""
# Prepare updated datasets section in recipe. It contains two
# datasets, one for the "abrupt-4xCO2" and one for the "piControl"
# experiment.
cmip_source = get_cmip_source_type(input_files)
df = input_files[cmip_source]
recipe["datasets"] = get_child_and_parent_dataset(
df[df.variable_id == "tas"],
parent_experiment="piControl",
child_duration_in_years=150,
parent_offset_in_years=0,
parent_duration_in_years=150,
)
# Delete branding suffixes from dataset entries because they are
# variable-specific
for dataset in recipe["datasets"]:
dataset.pop("branding_suffix", None)
# For CMIP6, delete all appearances of branding suffixes
if cmip_source == SourceDatasetType.CMIP6:
for variable in recipe["diagnostics"]["ecs"]["variables"].values():
variable.pop("branding_suffix", None)
@staticmethod
def format_result(
result_dir: Path,
execution_dataset: ExecutionDatasetCollection,
metric_args: MetricBundleArgs,
output_args: OutputBundleArgs,
) -> tuple[CMECMetric, CMECOutput]:
"""Format the result."""
ecs_ds = xarray.open_dataset(result_dir / "work" / "ecs" / "calculate" / "ecs.nc")
ecs = float(fillvalues_to_nan(ecs_ds["ecs"].values)[0])
lambda_ds = xarray.open_dataset(result_dir / "work" / "ecs" / "calculate" / "lambda.nc")
lambda_ = float(fillvalues_to_nan(lambda_ds["lambda"].values)[0])
# Update the diagnostic bundle arguments with the computed diagnostics.
metric_args[MetricCV.DIMENSIONS.value] = {
MetricCV.JSON_STRUCTURE.value: [
"region",
"metric",
],
"region": {"global": {}},
"metric": {"ecs": {}, "lambda": {}},
}
metric_args[MetricCV.RESULTS.value] = {
"global": {
"ecs": ecs,
"lambda": lambda_,
},
}
return CMECMetric.model_validate(metric_args), CMECOutput.model_validate(output_args)