climate-ref-esmvaltool 0.5.0__py3-none-any.whl

climate_ref_esmvaltool/__init__.py

@@ -0,0 +1,30 @@
+"""
+Rapid evaluating CMIP data with ESMValTool.
+"""
+
+import climate_ref_esmvaltool.diagnostics
+from climate_ref_core.dataset_registry import dataset_registry_manager
+from climate_ref_core.providers import CondaDiagnosticProvider
+from climate_ref_esmvaltool._version import __version__
+from climate_ref_esmvaltool.recipe import _ESMVALTOOL_COMMIT
+
+# Initialise the diagnostics manager.
+provider = CondaDiagnosticProvider(
+    "ESMValTool",
+    __version__,
+    repo="https://github.com/ESMValGroup/ESMValTool.git",
+    tag_or_commit=_ESMVALTOOL_COMMIT,
+)
+
+# Register the diagnostics.
+for _diagnostic_cls_name in climate_ref_esmvaltool.diagnostics.__all__:
+    _diagnostic_cls = getattr(climate_ref_esmvaltool.diagnostics, _diagnostic_cls_name)
+    provider.register(_diagnostic_cls())
+
+# Register OBS, OBS6, and raw data
+dataset_registry_manager.register(
+    "esmvaltool",
+    "https://pub-b093171261094c4ea9adffa01f94ee06.r2.dev/",
+    package="climate_ref_esmvaltool.dataset_registry",
+    resource="data.txt",
+)

climate_ref_esmvaltool/_version.py

@@ -0,0 +1,3 @@
+import importlib.metadata
+
+__version__ = importlib.metadata.version("climate-ref-esmvaltool")

climate_ref_esmvaltool/dataset_registry/data.txt

@@ -0,0 +1,74 @@
+ESMValTool/OBS/Tier2/OSI-450-nh/OBS_OSI-450-nh_reanaly_v3_fx_areacello.nc aead9fc03e6773f66c3fa522ddd9cc36ff6a5b47cfab02d3cb9481b52cc2f7cb
+ESMValTool/OBS/Tier2/OSI-450-nh/OBS_OSI-450-nh_reanaly_v3_OImon_sic_197901-197912.nc b5fe29fd2864248580043af4bca27a4771cf216ef7db74d645590ba10809dbe8
+ESMValTool/OBS/Tier2/OSI-450-nh/OBS_OSI-450-nh_reanaly_v3_OImon_sic_198001-198012.nc ce988e813cae4c59bbb622420e7e339b9e435117486af8aa81afaa54e19d7d68
+ESMValTool/OBS/Tier2/OSI-450-nh/OBS_OSI-450-nh_reanaly_v3_OImon_sic_198101-198112.nc 5713ea69e8ce6d436d3acb30cc6207638d868d0f7a24b2821788418481ec9660
+ESMValTool/OBS/Tier2/OSI-450-nh/OBS_OSI-450-nh_reanaly_v3_OImon_sic_198201-198212.nc 980685a890b9a02cc9c190a7fd7650a7c20b37e3fb5347803db8d9aa725bda9d
+ESMValTool/OBS/Tier2/OSI-450-nh/OBS_OSI-450-nh_reanaly_v3_OImon_sic_198301-198312.nc 4ebff517978213235000299c3492739870373fe5e3ddc8db68d6826c20526bef
+ESMValTool/OBS/Tier2/OSI-450-nh/OBS_OSI-450-nh_reanaly_v3_OImon_sic_198401-198412.nc fd302b6349d13895a5f918dd116b7efbc7af41705c0a1d3fc62092fac78b7463
+ESMValTool/OBS/Tier2/OSI-450-nh/OBS_OSI-450-nh_reanaly_v3_OImon_sic_198501-198512.nc 4d6fabf1247e92d316029657b10b993618ee08afe0f7f7f026793d92ca2b3019
+ESMValTool/OBS/Tier2/OSI-450-nh/OBS_OSI-450-nh_reanaly_v3_OImon_sic_198601-198612.nc cdcda5ef9ee1a804a7c23ffcace5a15674f630a9541a08927b49ebc279adf67f
+ESMValTool/OBS/Tier2/OSI-450-nh/OBS_OSI-450-nh_reanaly_v3_OImon_sic_198701-198712.nc 1f14e6251be16c6130be52f67f309d19225a2186cec3ebb196a2a4d316e627ad
+ESMValTool/OBS/Tier2/OSI-450-nh/OBS_OSI-450-nh_reanaly_v3_OImon_sic_198801-198812.nc 7828fb3696bcea2b2f8ef0f8823f69545747f2db6d8f7b2e6b06e32c1b9faed6
+ESMValTool/OBS/Tier2/OSI-450-nh/OBS_OSI-450-nh_reanaly_v3_OImon_sic_198901-198912.nc 852752aee0649cd23ca76d2f6f418f8ce510ae0806865da5d4ff3b347ee56f70
+ESMValTool/OBS/Tier2/OSI-450-nh/OBS_OSI-450-nh_reanaly_v3_OImon_sic_199001-199012.nc 0567a0824ae24eeeef91291e98e2972913bfe6960998f8ca474378c28ff53722
+ESMValTool/OBS/Tier2/OSI-450-nh/OBS_OSI-450-nh_reanaly_v3_OImon_sic_199101-199112.nc 1263e0fc884524cc91266d0269619a44978b814bc0e113d05dd18a4b8ecf30e5
+ESMValTool/OBS/Tier2/OSI-450-nh/OBS_OSI-450-nh_reanaly_v3_OImon_sic_199201-199212.nc f64216239a8f652b0d96556dec4b1146dad304c88a45e5cfb38917661c9cbfde
+ESMValTool/OBS/Tier2/OSI-450-nh/OBS_OSI-450-nh_reanaly_v3_OImon_sic_199301-199312.nc 413031394e005221899e86143d016fe0f8f074f27d9d8324058aa9261853d8e7
+ESMValTool/OBS/Tier2/OSI-450-nh/OBS_OSI-450-nh_reanaly_v3_OImon_sic_199401-199412.nc 18aaa5c6ddee4aa3944ed3fdea44cff27fb455ebe4592edd46550742a7e90bbf
+ESMValTool/OBS/Tier2/OSI-450-nh/OBS_OSI-450-nh_reanaly_v3_OImon_sic_199501-199512.nc dd06c51ab71746c5ae9abe763816aaf3ef240ada749a8bfbc89afaa942e7d995
+ESMValTool/OBS/Tier2/OSI-450-nh/OBS_OSI-450-nh_reanaly_v3_OImon_sic_199601-199612.nc 4227b2c134e3db5110454223e621988b71c8ef689089d1e9819c0e411f179caa
+ESMValTool/OBS/Tier2/OSI-450-nh/OBS_OSI-450-nh_reanaly_v3_OImon_sic_199701-199712.nc 0dc78fc679f2abedf6ec61f4c19f4a4478dbb1fbbf2654eb066cb387d9ab6a00
+ESMValTool/OBS/Tier2/OSI-450-nh/OBS_OSI-450-nh_reanaly_v3_OImon_sic_199801-199812.nc 98b78eea8ce6c8ab812bfd873158513b840398393066beb835b4aa98609ff2f2
+ESMValTool/OBS/Tier2/OSI-450-nh/OBS_OSI-450-nh_reanaly_v3_OImon_sic_199901-199912.nc ad325f8091028a39e4bd0da7e11103e94f6ecc14a75a41515900e5aae037d651
+ESMValTool/OBS/Tier2/OSI-450-nh/OBS_OSI-450-nh_reanaly_v3_OImon_sic_200001-200012.nc 0dd3d1017797f6ac19cac32c062248321a22ee5931f79c683d9d1d8b2b77068a
+ESMValTool/OBS/Tier2/OSI-450-nh/OBS_OSI-450-nh_reanaly_v3_OImon_sic_200101-200112.nc c5e3b1621df7ed91e67a41858b37441877d01503dec9a4211755c30f6aab124e
+ESMValTool/OBS/Tier2/OSI-450-nh/OBS_OSI-450-nh_reanaly_v3_OImon_sic_200201-200212.nc e5d1627f1595a0eb8bf7f51db89023884e9e9b25e3fd168ae579e8d0d86e08fa
+ESMValTool/OBS/Tier2/OSI-450-nh/OBS_OSI-450-nh_reanaly_v3_OImon_sic_200301-200312.nc e2770f79ab5f6e2f3d652c0b54734e95105be1914a2de84d442b4c3faa2adda5
+ESMValTool/OBS/Tier2/OSI-450-nh/OBS_OSI-450-nh_reanaly_v3_OImon_sic_200401-200412.nc 503daf56c1568923a2c6e0353588a94e26d4caa10c6dc73e1393fb7ce2e70d5b
+ESMValTool/OBS/Tier2/OSI-450-nh/OBS_OSI-450-nh_reanaly_v3_OImon_sic_200501-200512.nc 735b2a4fb028fc5f99add5a663113293045c808a0cb3e82c0536c92540fb6ebc
+ESMValTool/OBS/Tier2/OSI-450-nh/OBS_OSI-450-nh_reanaly_v3_OImon_sic_200601-200612.nc 34a6547a9740347861928c788c9e866b295ea424dc5167d8e32ca74e0294d3c9
+ESMValTool/OBS/Tier2/OSI-450-nh/OBS_OSI-450-nh_reanaly_v3_OImon_sic_200701-200712.nc c96b4cc0c03162fac8f6d7aafc65c859991e2df5cae9c37209d1557ce4795b2b
+ESMValTool/OBS/Tier2/OSI-450-nh/OBS_OSI-450-nh_reanaly_v3_OImon_sic_200801-200812.nc a99830c5a656d65e814f547698d12aa5be298dac8ac7bd52b6343cfdd6c2decd
+ESMValTool/OBS/Tier2/OSI-450-nh/OBS_OSI-450-nh_reanaly_v3_OImon_sic_200901-200912.nc 16a6ddaaddbe733991428e3a5778ca52340d27ea3383c58a7e4e76d41c472e36
+ESMValTool/OBS/Tier2/OSI-450-nh/OBS_OSI-450-nh_reanaly_v3_OImon_sic_201001-201012.nc 55b1b664fea63e83b30cab3cde0eec8ad457054b8deeac9d31e27cc7cf415d65
+ESMValTool/OBS/Tier2/OSI-450-nh/OBS_OSI-450-nh_reanaly_v3_OImon_sic_201101-201112.nc 3ccd8d7f1bf76b09f49478e08e0996348f218bbd705dd031eb06c1beb6b21f64
+ESMValTool/OBS/Tier2/OSI-450-nh/OBS_OSI-450-nh_reanaly_v3_OImon_sic_201201-201212.nc e82707692e34817c09d743b5776f4fdf59c6e9e1601fb3496878ba251e4d6c06
+ESMValTool/OBS/Tier2/OSI-450-nh/OBS_OSI-450-nh_reanaly_v3_OImon_sic_201301-201312.nc 46db3a4001df110fa71f3c33371d0613e61bb38f1f86de8343bbfbbca880f49b
+ESMValTool/OBS/Tier2/OSI-450-nh/OBS_OSI-450-nh_reanaly_v3_OImon_sic_201401-201412.nc fefe2db37a628e277512a9f6c20b0ac210d20a964c38ca13d6d5e59cec225ef8
+ESMValTool/OBS/Tier2/OSI-450-sh/OBS_OSI-450-sh_reanaly_v3_fx_areacello.nc 28f6cb9f8f4e795e2d3008a84df9fe2d5587050e87efcff2dd730189ac8454d3
+ESMValTool/OBS/Tier2/OSI-450-sh/OBS_OSI-450-sh_reanaly_v3_OImon_sic_197901-197912.nc 3eadfb27fa0176abd0f8c890577870f106a328935a4df07fa31ada457c9d1590
+ESMValTool/OBS/Tier2/OSI-450-sh/OBS_OSI-450-sh_reanaly_v3_OImon_sic_198001-198012.nc 341c94dc9f16dd45b76c7bcfb877a8161a83ee519beb92a5abffbdd2c2d0bcef
+ESMValTool/OBS/Tier2/OSI-450-sh/OBS_OSI-450-sh_reanaly_v3_OImon_sic_198101-198112.nc fedd045a62c5f09010620fe81e607e0f637a9be97a1e0fe1aff5f3210da4ebfb
+ESMValTool/OBS/Tier2/OSI-450-sh/OBS_OSI-450-sh_reanaly_v3_OImon_sic_198201-198212.nc f0ab6ecbfa15180d482ebd33b4e6567d0fbd82184e738a5505b9ba5d00ff797a
+ESMValTool/OBS/Tier2/OSI-450-sh/OBS_OSI-450-sh_reanaly_v3_OImon_sic_198301-198312.nc a9c88f88b8165020641492677748b5c887870b180ee65ddc339ce4ff7eda3aa5
+ESMValTool/OBS/Tier2/OSI-450-sh/OBS_OSI-450-sh_reanaly_v3_OImon_sic_198401-198412.nc cda7b9469e05b2c13faf14a48f7da4a8026535da921278bb73b1c95fdbdb5817
+ESMValTool/OBS/Tier2/OSI-450-sh/OBS_OSI-450-sh_reanaly_v3_OImon_sic_198501-198512.nc d0b5db2b82b31b530487f2bf6c14f67d15171e009f01cc64a7b36703bd662e5d
+ESMValTool/OBS/Tier2/OSI-450-sh/OBS_OSI-450-sh_reanaly_v3_OImon_sic_198601-198612.nc 9c71beb4c7cb6fa563649ac14f4d8da6469a7e39382f6dd66b9b0200c54d73eb
+ESMValTool/OBS/Tier2/OSI-450-sh/OBS_OSI-450-sh_reanaly_v3_OImon_sic_198701-198712.nc e1f48dc90e30513b4c72bb210f888af6ff358f771f955c0ff6f45377c3430b22
+ESMValTool/OBS/Tier2/OSI-450-sh/OBS_OSI-450-sh_reanaly_v3_OImon_sic_198801-198812.nc f7bfeb4b518a800cbf244f9a8422535ffdfb3e92fa3d268a38f88cdb471de2ba
+ESMValTool/OBS/Tier2/OSI-450-sh/OBS_OSI-450-sh_reanaly_v3_OImon_sic_198901-198912.nc 4086c5cc0b44f25f88892b0ef5096b7175dd9cf7972fea9d5ea2fe674f9572d9
+ESMValTool/OBS/Tier2/OSI-450-sh/OBS_OSI-450-sh_reanaly_v3_OImon_sic_199001-199012.nc be0a4c07d9b01f86913807cf9dfcf73383021df37bbd8ef71a03a09bb8cd5176
+ESMValTool/OBS/Tier2/OSI-450-sh/OBS_OSI-450-sh_reanaly_v3_OImon_sic_199101-199112.nc 2480581a86eb74771279184334011bbcc750084efbbf72efaecd7c6ec3d8495c
+ESMValTool/OBS/Tier2/OSI-450-sh/OBS_OSI-450-sh_reanaly_v3_OImon_sic_199201-199212.nc d2bbf1350b2f4564fe60664d52be38c43902222b2e54078c64365e1ab284c410
+ESMValTool/OBS/Tier2/OSI-450-sh/OBS_OSI-450-sh_reanaly_v3_OImon_sic_199301-199312.nc c94f72e4a9b806479586739505c5e338f256b799ba95d4dd0e24b7c34d5eaba3
+ESMValTool/OBS/Tier2/OSI-450-sh/OBS_OSI-450-sh_reanaly_v3_OImon_sic_199401-199412.nc 1f7f58413a1103b1aab2b0909781b589a6c8b9bcc57441122c16cf77b3947a45
+ESMValTool/OBS/Tier2/OSI-450-sh/OBS_OSI-450-sh_reanaly_v3_OImon_sic_199501-199512.nc c68b8ec4ab6fb1996a08d942a8b4d9cebdcd4153258c0b0db718711aeb0e7565
+ESMValTool/OBS/Tier2/OSI-450-sh/OBS_OSI-450-sh_reanaly_v3_OImon_sic_199601-199612.nc 7010dfecd0cde62826fd44daa5080b725569da384ad0e37b672ed03df3bb647a
+ESMValTool/OBS/Tier2/OSI-450-sh/OBS_OSI-450-sh_reanaly_v3_OImon_sic_199701-199712.nc d749a4bf8a11eeb1ecb264d65a687cfada20df3676af0840d373f9f6ecaf5db1
+ESMValTool/OBS/Tier2/OSI-450-sh/OBS_OSI-450-sh_reanaly_v3_OImon_sic_199801-199812.nc 6fa86c6fdc5ff0a2057604cfe95f80ad0a8f2ef71f5d054785d4bde2bbbda6c5
+ESMValTool/OBS/Tier2/OSI-450-sh/OBS_OSI-450-sh_reanaly_v3_OImon_sic_199901-199912.nc 2a0a7d60510e9daeeea1ffb557109416888239abe244ae8687e31650d47a05cd
+ESMValTool/OBS/Tier2/OSI-450-sh/OBS_OSI-450-sh_reanaly_v3_OImon_sic_200001-200012.nc 147ec37e56c571397afc9833f1b8b23987cedf8108566ad24c30a09a7009a9a5
+ESMValTool/OBS/Tier2/OSI-450-sh/OBS_OSI-450-sh_reanaly_v3_OImon_sic_200101-200112.nc f0be737c861796072c68046b2e96cefda14473ee46c71ab714ec3d7642dbcef7
+ESMValTool/OBS/Tier2/OSI-450-sh/OBS_OSI-450-sh_reanaly_v3_OImon_sic_200201-200212.nc 26e2c2d9e78fb3482b99d3e338bf1fdc4f27ec7fb4eb64c054123646ceb22bfb
+ESMValTool/OBS/Tier2/OSI-450-sh/OBS_OSI-450-sh_reanaly_v3_OImon_sic_200301-200312.nc e8ff93274ad87bbe5491aca37112800b7016003b13cdd316cd7920f98e54534c
+ESMValTool/OBS/Tier2/OSI-450-sh/OBS_OSI-450-sh_reanaly_v3_OImon_sic_200401-200412.nc 716e089dba6bd34e2d2f661b4d2b65a57722b845260aec0ad3a0d3f2786cceaf
+ESMValTool/OBS/Tier2/OSI-450-sh/OBS_OSI-450-sh_reanaly_v3_OImon_sic_200501-200512.nc f73498ffcea9cb59dae2bd88e23c9bcde70d7c090e00102ab980f743701c154e
+ESMValTool/OBS/Tier2/OSI-450-sh/OBS_OSI-450-sh_reanaly_v3_OImon_sic_200601-200612.nc 648b6ed330a12cb9809b87ba2e2ebf24d8806ed8ae7664bae10e4146d0af1302
+ESMValTool/OBS/Tier2/OSI-450-sh/OBS_OSI-450-sh_reanaly_v3_OImon_sic_200701-200712.nc 4394f0a46644a35249ac274c77c092847fcb0b9c860d7a6ca480f9fc26aaaa1c
+ESMValTool/OBS/Tier2/OSI-450-sh/OBS_OSI-450-sh_reanaly_v3_OImon_sic_200801-200812.nc 8b22d86c712283c2bf7d978453f8f56d924bf82c4f6ff7834763066b081e4f5e
+ESMValTool/OBS/Tier2/OSI-450-sh/OBS_OSI-450-sh_reanaly_v3_OImon_sic_200901-200912.nc fe555a4ec603c95425cd257cc426f6f349ed5d33b3760d665c102798aa3144f1
+ESMValTool/OBS/Tier2/OSI-450-sh/OBS_OSI-450-sh_reanaly_v3_OImon_sic_201001-201012.nc 4d8b3dfdb8c0d98fd21858356eedee6ac912eb66c295d81fffcb5eb206f2c06b
+ESMValTool/OBS/Tier2/OSI-450-sh/OBS_OSI-450-sh_reanaly_v3_OImon_sic_201101-201112.nc 1d63f2855bdc30d86fbda942c65e104ad70069c78a433d0bccd45170e77789f8
+ESMValTool/OBS/Tier2/OSI-450-sh/OBS_OSI-450-sh_reanaly_v3_OImon_sic_201201-201212.nc 86187c3d1174053f2cba6dad010af49ceab77d368aa9314bf53c330b5f2217b9
+ESMValTool/OBS/Tier2/OSI-450-sh/OBS_OSI-450-sh_reanaly_v3_OImon_sic_201301-201312.nc 8820353570884b2ef182caaffb5986ed6268bbe199fd867f61b56e798ca01f1a
+ESMValTool/OBS/Tier2/OSI-450-sh/OBS_OSI-450-sh_reanaly_v3_OImon_sic_201401-201412.nc 7102d0db3dc02c5b0eb0cfe3535ee50171007ef5b43eb9aae1220ac21b0b98e9

climate_ref_esmvaltool/diagnostics/__init__.py

@@ -0,0 +1,19 @@
+"""ESMValTool diagnostics."""
+
+from climate_ref_esmvaltool.diagnostics.climate_at_global_warming_levels import ClimateAtGlobalWarmingLevels
+from climate_ref_esmvaltool.diagnostics.ecs import EquilibriumClimateSensitivity
+from climate_ref_esmvaltool.diagnostics.example import GlobalMeanTimeseries
+from climate_ref_esmvaltool.diagnostics.sea_ice_area_seasonal_cycle import SeaIceAreaSeasonalCycle
+from climate_ref_esmvaltool.diagnostics.tcr import TransientClimateResponse
+from climate_ref_esmvaltool.diagnostics.tcre import TransientClimateResponseEmissions
+from climate_ref_esmvaltool.diagnostics.zec import ZeroEmissionCommitment
+
+__all__ = [
+    "ClimateAtGlobalWarmingLevels",
+    "EquilibriumClimateSensitivity",
+    "GlobalMeanTimeseries",
+    "SeaIceAreaSeasonalCycle",
+    "TransientClimateResponse",
+    "TransientClimateResponseEmissions",
+    "ZeroEmissionCommitment",
+]

climate_ref_esmvaltool/diagnostics/base.py

@@ -0,0 +1,212 @@
+from abc import abstractmethod
+from collections.abc import Iterable
+from pathlib import Path
+from typing import ClassVar
+
+import pandas
+from loguru import logger
+from ruamel.yaml import YAML
+
+from climate_ref_core.dataset_registry import dataset_registry_manager
+from climate_ref_core.datasets import ExecutionDatasetCollection, SourceDatasetType
+from climate_ref_core.diagnostics import (
+    CommandLineDiagnostic,
+    ExecutionDefinition,
+    ExecutionResult,
+)
+from climate_ref_core.pycmec.metric import CMECMetric
+from climate_ref_core.pycmec.output import CMECOutput, OutputCV
+from climate_ref_esmvaltool.recipe import load_recipe, prepare_climate_data
+from climate_ref_esmvaltool.types import MetricBundleArgs, OutputBundleArgs, Recipe
+
+yaml = YAML()
+
+
+class ESMValToolDiagnostic(CommandLineDiagnostic):
+    """ESMValTool Diagnostic base class."""
+
+    base_recipe: ClassVar[str]
+
+    @staticmethod
+    @abstractmethod
+    def update_recipe(recipe: Recipe, input_files: pandas.DataFrame) -> None:
+        """
+        Update the base recipe for the run.
+
+        Parameters
+        ----------
+        recipe:
+            The base recipe to update.
+        input_files:
+            The dataframe describing the input files.
+
+        """
+
+    @staticmethod
+    def format_result(
+        result_dir: Path,
+        execution_dataset: ExecutionDatasetCollection,
+        metric_args: MetricBundleArgs,
+        output_args: OutputBundleArgs,
+    ) -> tuple[MetricBundleArgs, OutputBundleArgs]:
+        """
+        Update the arguments needed to create a CMEC diagnostic and output bundle.
+
+        Parameters
+        ----------
+        result_dir
+            Directory containing executions from an ESMValTool run.
+        execution_dataset
+            The diagnostic dataset used for the diagnostic execution.
+        metric_args
+            Generic diagnostic bundle arguments.
+        output_args
+            Generic output bundle arguments.
+
+        Returns
+        -------
+            The arguments needed to create a CMEC diagnostic and output bundle.
+        """
+        return metric_args, output_args
+
+    def build_cmd(self, definition: ExecutionDefinition) -> Iterable[str]:
+        """
+        Build the command to run an ESMValTool recipe.
+
+        Parameters
+        ----------
+        definition
+            A description of the information needed for this execution of the diagnostic
+
+        Returns
+        -------
+        :
+            The result of running the diagnostic.
+        """
+        input_files = definition.datasets[SourceDatasetType.CMIP6].datasets
+        recipe = load_recipe(self.base_recipe)
+        self.update_recipe(recipe, input_files)
+
+        recipe_path = definition.to_output_path("recipe.yml")
+        with recipe_path.open("w", encoding="utf-8") as file:
+            yaml.dump(recipe, file)
+
+        climate_data = definition.to_output_path("climate_data")
+
+        prepare_climate_data(
+            definition.datasets[SourceDatasetType.CMIP6].datasets,
+            climate_data_dir=climate_data,
+        )
+
+        config = {
+            "drs": {
+                "CMIP6": "ESGF",
+            },
+            "output_dir": str(definition.to_output_path("executions")),
+            "rootpath": {
+                "default": str(climate_data),
+            },
+            "search_esgf": "never",
+        }
+
+        # Configure the paths to OBS/OBS6/native6 data
+        registry = dataset_registry_manager["esmvaltool"]
+        data_dir = registry.abspath / "ESMValTool"  # type: ignore[attr-defined]
+        if not data_dir.exists():
+            logger.warning(
+                "ESMValTool observational and reanalysis data is not available "
+                f"in {data_dir}, you may want to run the command "
+                "`ref datasets fetch-data --registry esmvaltool`."
+            )
+        else:
+            config["drs"].update(  # type: ignore[attr-defined]
+                {
+                    "OBS": "default",
+                    "OBS6": "default",
+                    "native6": "default",
+                }
+            )
+            config["rootpath"].update(  # type: ignore[attr-defined]
+                {
+                    "OBS": str(data_dir / "OBS"),
+                    "OBS6": str(data_dir / "OBS6"),
+                    "native6": str(data_dir / "RAWOBS"),
+                }
+            )
+
+        config_dir = definition.to_output_path("config")
+        config_dir.mkdir()
+        with (config_dir / "config.yml").open("w", encoding="utf-8") as file:
+            yaml.dump(config, file)
+
+        return [
+            "esmvaltool",
+            "run",
+            f"--config-dir={config_dir}",
+            f"{recipe_path}",
+        ]
+
+    def build_execution_result(
+        self,
+        definition: ExecutionDefinition,
+    ) -> ExecutionResult:
+        """
+        Build the diagnostic result after running an ESMValTool recipe.
+
+        Parameters
+        ----------
+        definition
+            A description of the information needed for this execution of the diagnostic
+
+        Returns
+        -------
+        :
+            The resulting diagnostic.
+        """
+        result_dir = next(definition.to_output_path("executions").glob("*"))
+
+        metric_args = CMECMetric.create_template()
+        output_args = CMECOutput.create_template()
+
+        # Add the plots and data files
+        plot_suffixes = {".png", ".jpg", ".pdf", ".ps"}
+        for metadata_file in result_dir.glob("run/*/*/diagnostic_provenance.yml"):
+            metadata = yaml.load(metadata_file.read_text(encoding="utf-8"))
+            for filename in metadata:
+                caption = metadata[filename].get("caption", "")
+                relative_path = definition.as_relative_path(filename)
+                if relative_path.suffix in plot_suffixes:
+                    key = OutputCV.PLOTS.value
+                else:
+                    key = OutputCV.DATA.value
+                output_args[key][f"{relative_path}"] = {
+                    OutputCV.FILENAME.value: f"{relative_path}",
+                    OutputCV.LONG_NAME.value: caption,
+                    OutputCV.DESCRIPTION.value: "",
+                }
+
+        # Add the index.html file
+        index_html = f"{result_dir}/index.html"
+        output_args[OutputCV.HTML.value][index_html] = {
+            OutputCV.FILENAME.value: index_html,
+            OutputCV.LONG_NAME.value: "Results page",
+            OutputCV.DESCRIPTION.value: "Page showing the executions of the ESMValTool run.",
+        }
+        output_args[OutputCV.INDEX.value] = index_html
+
+        # Add the (debug) log file
+        output_args[OutputCV.PROVENANCE.value][OutputCV.LOG.value] = f"{result_dir}/run/main_log_debug.txt"
+
+        # Update the diagnostic and output bundle with diagnostic specific executions.
+        metric_args, output_args = self.format_result(
+            result_dir=result_dir,
+            execution_dataset=definition.datasets,
+            metric_args=metric_args,
+            output_args=output_args,
+        )
+
+        return ExecutionResult.build_from_output_bundle(
+            definition,
+            cmec_output_bundle=output_args,
+            cmec_metric_bundle=metric_args,
+        )

climate_ref_esmvaltool/diagnostics/climate_at_global_warming_levels.py

@@ -0,0 +1,100 @@
+import pandas
+
+from climate_ref_core.constraints import (
+    AddSupplementaryDataset,
+    RequireContiguousTimerange,
+    RequireFacets,
+)
+from climate_ref_core.datasets import FacetFilter, SourceDatasetType
+from climate_ref_core.diagnostics import DataRequirement
+from climate_ref_esmvaltool.diagnostics.base import ESMValToolDiagnostic
+from climate_ref_esmvaltool.recipe import dataframe_to_recipe
+from climate_ref_esmvaltool.types import Recipe
+
+
+class ClimateAtGlobalWarmingLevels(ESMValToolDiagnostic):
+    """
+    Calculate climate variables at global warming levels.
+    """
+
+    name = "Climate variables at global warming levels"
+    slug = "climate-at-global-warming-levels"
+    base_recipe = "recipe_calculate_gwl_exceedance_stats.yml"
+
+    variables = (
+        "pr",
+        "tas",
+    )
+
+    data_requirements = (
+        DataRequirement(
+            source_type=SourceDatasetType.CMIP6,
+            filters=(
+                FacetFilter(
+                    facets={
+                        "variable_id": variables,
+                        "experiment_id": (
+                            "ssp126",
+                            "ssp245",
+                            "ssp370",
+                            "ssp585",
+                        ),
+                    },
+                ),
+            ),
+            group_by=("experiment_id",),
+            constraints=(
+                RequireFacets("variable_id", variables),
+                AddSupplementaryDataset(
+                    supplementary_facets={"experiment_id": "historical"},
+                    matching_facets=(
+                        "source_id",
+                        "member_id",
+                        "grid_label",
+                        "table_id",
+                        "variable_id",
+                    ),
+                    optional_matching_facets=tuple(),
+                ),
+                RequireFacets("experiment_id", ("historical",)),
+                RequireContiguousTimerange(group_by=("instance_id",)),
+                AddSupplementaryDataset.from_defaults("areacella", SourceDatasetType.CMIP6),
+            ),
+        ),
+    )
+    facets = ("model", "metric")
+
+    @staticmethod
+    def update_recipe(recipe: Recipe, input_files: pandas.DataFrame) -> None:
+        """Update the recipe."""
+        # Set up the datasets
+        diagnostics = recipe["diagnostics"]
+        for diagnostic in diagnostics.values():
+            diagnostic.pop("additional_datasets")
+        recipe_variables = dataframe_to_recipe(input_files)
+        datasets = recipe_variables["tas"]["additional_datasets"]
+        datasets = [ds for ds in datasets if ds["exp"] != "historical"]
+        for dataset in datasets:
+            dataset.pop("timerange")
+            dataset["activity"] = ["CMIP", dataset["activity"]]
+            dataset["exp"] = ["historical", dataset["exp"]]
+        recipe["datasets"] = datasets
+
+        # Specify the timeranges
+        diagnostics["calculate_gwl_exceedance_years"]["variables"]["tas_anomaly"] = {
+            "short_name": "tas",
+            "preprocessor": "calculate_anomalies",
+            "timerange": "1850/2100",
+        }
+
+        diagnostics["gwl_mean_plots_tas"]["variables"]["tas"] = {
+            "short_name": "tas",
+            "preprocessor": "multi_model_gwl_stats",
+            "timerange": "2000/2100",
+        }
+
+        diagnostics["gwl_mean_plots_pr"]["variables"]["pr"] = {
+            "short_name": "pr",
+            "preprocessor": "multi_model_gwl_stats",
+            "timerange": "2000/2100",
+        }

climate_ref_esmvaltool/diagnostics/ecs.py

@@ -0,0 +1,144 @@
+from pathlib import Path
+
+import pandas
+import xarray
+
+from climate_ref_core.constraints import (
+    AddSupplementaryDataset,
+    RequireContiguousTimerange,
+    RequireFacets,
+    RequireOverlappingTimerange,
+)
+from climate_ref_core.datasets import ExecutionDatasetCollection, FacetFilter, SourceDatasetType
+from climate_ref_core.diagnostics import DataRequirement
+from climate_ref_core.pycmec.metric import MetricCV
+from climate_ref_esmvaltool.diagnostics.base import ESMValToolDiagnostic
+from climate_ref_esmvaltool.recipe import dataframe_to_recipe
+from climate_ref_esmvaltool.types import MetricBundleArgs, OutputBundleArgs, Recipe
+
+
+class EquilibriumClimateSensitivity(ESMValToolDiagnostic):
+    """
+    Calculate the global mean equilibrium climate sensitivity for a dataset.
+    """
+
+    name = "Equilibrium Climate Sensitivity"
+    slug = "equilibrium-climate-sensitivity"
+    base_recipe = "recipe_ecs.yml"
+
+    variables = (
+        "rlut",
+        "rsdt",
+        "rsut",
+        "tas",
+    )
+    experiments = (
+        "abrupt-4xCO2",
+        "piControl",
+    )
+    data_requirements = (
+        DataRequirement(
+            source_type=SourceDatasetType.CMIP6,
+            filters=(
+                FacetFilter(
+                    facets={
+                        "variable_id": variables,
+                        "experiment_id": experiments,
+                    },
+                ),
+            ),
+            group_by=("source_id", "member_id", "grid_label"),
+            constraints=(
+                RequireFacets("variable_id", variables),
+                RequireFacets("experiment_id", experiments),
+                RequireContiguousTimerange(group_by=("instance_id",)),
+                RequireOverlappingTimerange(group_by=("instance_id",)),
+                AddSupplementaryDataset.from_defaults("areacella", SourceDatasetType.CMIP6),
+            ),
+        ),
+    )
+    facets = ("source_id", "region", "metric")
+
+    @staticmethod
+    def update_recipe(recipe: Recipe, input_files: pandas.DataFrame) -> None:
+        """Update the recipe."""
+        # Only run the diagnostic that computes ECS for a single model.
+        recipe["diagnostics"] = {
+            "cmip6": {
+                "description": "Calculate ECS.",
+                "variables": {
+                    "tas": {
+                        "preprocessor": "spatial_mean",
+                    },
+                    "rtnt": {
+                        "preprocessor": "spatial_mean",
+                        "derive": True,
+                    },
+                },
+                "scripts": {
+                    "ecs": {
+                        "script": "climate_metrics/ecs.py",
+                        "calculate_mmm": False,
+                    },
+                },
+            },
+        }
+
+        # Prepare updated datasets section in recipe. It contains two
+        # datasets, one for the "abrupt-4xCO2" and one for the "piControl"
+        # experiment.
+        recipe_variables = dataframe_to_recipe(input_files)
+        recipe_variables = {k: v for k, v in recipe_variables.items() if k != "areacella"}
+
+        # Select a timerange covered by all datasets.
+        start_times, end_times = [], []
+        for variable in recipe_variables.values():
+            for dataset in variable["additional_datasets"]:
+                start, end = dataset["timerange"].split("/")
+                start_times.append(start)
+                end_times.append(end)
+        timerange = f"{max(start_times)}/{min(end_times)}"
+
+        datasets = recipe_variables["tas"]["additional_datasets"]
+        for dataset in datasets:
+            dataset["timerange"] = timerange
+
+        recipe["datasets"] = datasets
+
+    @staticmethod
+    def format_result(
+        result_dir: Path,
+        execution_dataset: ExecutionDatasetCollection,
+        metric_args: MetricBundleArgs,
+        output_args: OutputBundleArgs,
+    ) -> tuple[MetricBundleArgs, OutputBundleArgs]:
+        """Format the result."""
+        input_files = next(c.datasets for _, c in execution_dataset.items())
+        source_id = input_files.iloc[0].source_id
+
+        ecs_ds = xarray.open_dataset(result_dir / "work" / "cmip6" / "ecs" / "ecs.nc")
+        ecs = float(ecs_ds["ecs"].values[0])
+        lambda_ds = xarray.open_dataset(result_dir / "work" / "cmip6" / "ecs" / "lambda.nc")
+        lambda_ = float(lambda_ds["lambda"].values[0])
+
+        # Update the diagnostic bundle arguments with the computed diagnostics.
+        metric_args[MetricCV.DIMENSIONS.value] = {
+            MetricCV.JSON_STRUCTURE.value: [
+                "source_id",
+                "region",
+                "metric",
+            ],
+            "source_id": {source_id: {}},
+            "region": {"global": {}},
+            "metric": {"ecs": {}, "lambda": {}},
+        }
+        metric_args[MetricCV.RESULTS.value] = {
+            source_id: {
+                "global": {
+                    "ecs": ecs,
+                    "lambda": lambda_,
+                },
+            },
+        }
+
+        return metric_args, output_args

climate_ref_esmvaltool/diagnostics/example.py

@@ -0,0 +1,50 @@
+import pandas
+
+from climate_ref_core.constraints import AddSupplementaryDataset, RequireContiguousTimerange
+from climate_ref_core.datasets import FacetFilter, SourceDatasetType
+from climate_ref_core.diagnostics import DataRequirement
+from climate_ref_esmvaltool.diagnostics.base import ESMValToolDiagnostic
+from climate_ref_esmvaltool.recipe import dataframe_to_recipe
+from climate_ref_esmvaltool.types import Recipe
+
+
+class GlobalMeanTimeseries(ESMValToolDiagnostic):
+    """
+    Calculate the annual mean global mean timeseries for a dataset.
+    """
+
+    name = "Global Mean Timeseries"
+    slug = "global-mean-timeseries"
+    base_recipe = "examples/recipe_python.yml"
+
+    data_requirements = (
+        DataRequirement(
+            source_type=SourceDatasetType.CMIP6,
+            filters=(FacetFilter(facets={"variable_id": ("tas",)}),),
+            group_by=("instance_id",),
+            constraints=(
+                RequireContiguousTimerange(group_by=("instance_id",)),
+                AddSupplementaryDataset.from_defaults("areacella", SourceDatasetType.CMIP6),
+            ),
+        ),
+    )
+    facets = ("model", "metric")
+
+    @staticmethod
+    def update_recipe(recipe: Recipe, input_files: pandas.DataFrame) -> None:
+        """Update the recipe."""
+        # Clear unwanted elements from the recipe.
+        recipe["datasets"].clear()
+        recipe["diagnostics"].pop("map")
+        variables = recipe["diagnostics"]["timeseries"]["variables"]
+        variables.clear()
+
+        # Prepare updated variables section in recipe.
+        recipe_variables = dataframe_to_recipe(input_files)
+        recipe_variables = {k: v for k, v in recipe_variables.items() if k != "areacella"}
+        for variable in recipe_variables.values():
+            variable["preprocessor"] = "annual_mean_global"
+            variable["caption"] = "Annual global mean {long_name} according to {dataset}."
+
+        # Populate recipe with new variables/datasets.
+        variables.update(recipe_variables)