<a id="changelog"></a>

# Changelog

<a id="changelog-v2-15-0"></a>

## v2.15.0

### Highlights

- Preparation of recipes that are run by the [Rapid Evaluation Framework]() (REF) for CMIP7.
- An option to install ESMValTool with minimal dependencies ([Pull request #4517](https://github.com/ESMValGroup/ESMValTool/pull/4517))
- Use pixi to manage development environments ([Pull request #4407](https://github.com/ESMValGroup/ESMValTool/pull/4407)) see [Install from source](quickstart/installation.html.md#install-from-source) more information.

This release includes

### Backwards incompatible changes

- Remove deprecated options from diagnostic `multi_datasets.py` ([Pull request #4520](https://github.com/ESMValGroup/ESMValTool/pull/4520)) by [@schlunma](https://github.com/schlunma)

### Bug fixes

- Fix removal of `month_number` and `year` coordinates after `monthly_statistics` preprocessor in E-OBS cmorizer ([Pull request #4396](https://github.com/ESMValGroup/ESMValTool/pull/4396)) by [@jlenh](https://github.com/jlenh)
- Fix ESACCI-CLOUD formatter: removing group coordinates is not necessary anymore ([Pull request #4410](https://github.com/ESMValGroup/ESMValTool/pull/4410)) by [@schlunma](https://github.com/schlunma)
- Fix ESACCI-OC CMORizer ([Pull request #4464](https://github.com/ESMValGroup/ESMValTool/pull/4464)) by [@schlunma](https://github.com/schlunma)
- Fix handling of the time coordinate in outputs of recipe_ref_fire.yml ([Pull request #4538](https://github.com/ESMValGroup/ESMValTool/pull/4538)) by [@jlenh](https://github.com/jlenh)
- Fix dates for ESACCI-AEROSOL in recipe_check_obs.yml ([Pull request #4547](https://github.com/ESMValGroup/ESMValTool/pull/4547)) by [@axel-lauer](https://github.com/axel-lauer)
- Fix `ValueError: setting an array element with a sequence.` in `diag_shapeselect.py` ([Pull request #4532](https://github.com/ESMValGroup/ESMValTool/pull/4532)) by [@schlunma](https://github.com/schlunma)

### Documentation

- Remove outdated link to YAML reference card ([Pull request #4418](https://github.com/ESMValGroup/ESMValTool/pull/4418)) by [@bouweandela](https://github.com/bouweandela)
- Fix the PDF build of the documentation ([Pull request #4432](https://github.com/ESMValGroup/ESMValTool/pull/4432)) by [@bouweandela](https://github.com/bouweandela)
- Improve documentation on installing the development version of ESMValCore ([Pull request #4433](https://github.com/ESMValGroup/ESMValTool/pull/4433)) by [@bouweandela](https://github.com/bouweandela)
- Update release instructions related to Docker ([Pull request #4454](https://github.com/ESMValGroup/ESMValTool/pull/4454)) by [@bouweandela](https://github.com/bouweandela)
- Minimise content on main documentation page ([Pull request #4449](https://github.com/ESMValGroup/ESMValTool/pull/4449)) by [@ehogan](https://github.com/ehogan)
- Documentation for contributor license agreement & CLA-assistant ([Pull request #4440](https://github.com/ESMValGroup/ESMValTool/pull/4440)) by [@alistairsellar](https://github.com/alistairsellar)
- Small improvements to documentation on obtaining input data ([Pull request #4462](https://github.com/ESMValGroup/ESMValTool/pull/4462)) by [@bouweandela](https://github.com/bouweandela)
- Remove redundant information from `zenodo.json` ([Pull request #4518](https://github.com/ESMValGroup/ESMValTool/pull/4518)) by [@schlunma](https://github.com/schlunma)

### Diagnostics

- Radiation budget: labelling plots with alias ([Pull request #4292](https://github.com/ESMValGroup/ESMValTool/pull/4292)) by [@NParsonsMO](https://github.com/NParsonsMO)

### Observational and re-analysis dataset support

- Extension of ESA CCI OZONE CMORizer ([Pull request #4125](https://github.com/ESMValGroup/ESMValTool/pull/4125)) by [@axel-lauer](https://github.com/axel-lauer)
- Cmoriser update WOA to 2023 ([Pull request #4337](https://github.com/ESMValGroup/ESMValTool/pull/4337)) by [@flicj191](https://github.com/flicj191)
- Updated calipso-icecloud downloader and formatter from v1.00 to v2.00 ([Pull request #4441](https://github.com/ESMValGroup/ESMValTool/pull/4441)) by [@axel-lauer](https://github.com/axel-lauer)
- Update CMORizer CLARA-AVHRR (A3) ([Pull request #4463](https://github.com/ESMValGroup/ESMValTool/pull/4463)) by [@axel-lauer](https://github.com/axel-lauer)

### Automatic testing

- Run test recipes in the nightly tests with intake-esgf ([Pull request #4394](https://github.com/ESMValGroup/ESMValTool/pull/4394)) by [@bouweandela](https://github.com/bouweandela)
- Improve the security of GitHub Action workflows ([Pull request #4421](https://github.com/ESMValGroup/ESMValTool/pull/4421)) by [@bouweandela](https://github.com/bouweandela)
- Add workflow dispatch gha test.yml (needed to test PR 4502) ([Pull request #4503](https://github.com/ESMValGroup/ESMValTool/pull/4503)) by [@valeriupredoi](https://github.com/valeriupredoi)
- Run Github Action tests (test.yml) after pixi lockfile update ([Pull request #4502](https://github.com/ESMValGroup/ESMValTool/pull/4502)) by [@valeriupredoi](https://github.com/valeriupredoi)
- Ask ESMValBot to create the lockfile update pull request ([Pull request #4507](https://github.com/ESMValGroup/ESMValTool/pull/4507)) by [@bouweandela](https://github.com/bouweandela)
- Undo branches selection in test.yml ([Pull request #4509](https://github.com/ESMValGroup/ESMValTool/pull/4509)) by [@bouweandela](https://github.com/bouweandela)
- Run tests on all platforms and Python versions when updating pixi lock file ([Pull request #4512](https://github.com/ESMValGroup/ESMValTool/pull/4512)) by [@bouweandela](https://github.com/bouweandela)

### Installation

- Use pixi to manage development conda environments ([Pull request #4407](https://github.com/ESMValGroup/ESMValTool/pull/4407)) by [@bouweandela](https://github.com/bouweandela)
- Support for Python 3.14 ([Pull request #4303](https://github.com/ESMValGroup/ESMValTool/pull/4303)) by [@valeriupredoi](https://github.com/valeriupredoi)
- Add an option to install with minimal dependencies ([Pull request #4517](https://github.com/ESMValGroup/ESMValTool/pull/4517)) by [@bouweandela](https://github.com/bouweandela)

### Rapid Evaluation Framework

- Fix issue with recipe ref fire dependency ([Pull request #4420](https://github.com/ESMValGroup/ESMValTool/pull/4420)) by [@jlenh](https://github.com/jlenh)
- Add fallbacks for CMIP7 tasmax handling in `ref/recipe_ref_fire.yml` ([Pull request #4423](https://github.com/ESMValGroup/ESMValTool/pull/4423)) by [@jlenh](https://github.com/jlenh)
- Updating the REF ozone recipe with the correct ozone data ([Pull request #4444](https://github.com/ESMValGroup/ESMValTool/pull/4444)) by [@hb326](https://github.com/hb326)
- Add ZEC CMIP7 recipe ([Pull request #4458](https://github.com/ESMValGroup/ESMValTool/pull/4458)) by [@bettina-gier](https://github.com/bettina-gier)
- Added a CMIP7 version for `recipe_ref_trend_regions.yml`, `recipe_ref_tannual_cycle_region.yml` and `recipe_ref_timeseries_region.yml` ([Pull request #4460](https://github.com/ESMValGroup/ESMValTool/pull/4460)) by [@katjaweigel](https://github.com/katjaweigel)
- Add CMIP7-compatible REF version of `recipe_ecs.yml` ([Pull request #4465](https://github.com/ESMValGroup/ESMValTool/pull/4465)) by [@schlunma](https://github.com/schlunma)
- Add CMIP7-compatible REF version of `recipe_tcr.yml` ([Pull request #4469](https://github.com/ESMValGroup/ESMValTool/pull/4469)) by [@schlunma](https://github.com/schlunma)
- Add CMIP7-compatible REF version of `recipe_tcre.yml` ([Pull request #4480](https://github.com/ESMValGroup/ESMValTool/pull/4480)) by [@schlunma](https://github.com/schlunma)
- REF recipe CRE with CMIP7 data ([Pull request #4461](https://github.com/ESMValGroup/ESMValTool/pull/4461)) by [@hb326](https://github.com/hb326)
- Write temperature vs. emissions data in TCRE diagnostic ([Pull request #4484](https://github.com/ESMValGroup/ESMValTool/pull/4484)) by [@schlunma](https://github.com/schlunma)
- Update REF recipe `recipe_calculate_gwl_exceedance_stats.yml` for CMIP7 datasets ([Pull request #4486](https://github.com/ESMValGroup/ESMValTool/pull/4486)) by [@rswamina](https://github.com/rswamina)
- Sea ice sensitivity to GMST - Calculate from observational datasets ([Pull request #4220](https://github.com/ESMValGroup/ESMValTool/pull/4220)) by [@NParsonsMO](https://github.com/NParsonsMO)
- Adding CMIP7 version of `recipe_seaice_sensitivity.yml` ([Pull request #4453](https://github.com/ESMValGroup/ESMValTool/pull/4453)) by [@NParsonsMO](https://github.com/NParsonsMO)
- Update REF recipe recipe_ref_fire.yml for CMIP7 datasets ([Pull request #4479](https://github.com/ESMValGroup/ESMValTool/pull/4479)) by [@jlenh](https://github.com/jlenh)
- Update REF ENSO recipes for CMIP7 ([Pull request #4470](https://github.com/ESMValGroup/ESMValTool/pull/4470)) by [@flicj191](https://github.com/flicj191)

### Improvements

- Update path to CEDA-JASMIN esmeval gws (group workspace) ([Pull request #4411](https://github.com/ESMValGroup/ESMValTool/pull/4411)) by [@valeriupredoi](https://github.com/valeriupredoi)
- Nicer command line ([Pull request #4459](https://github.com/ESMValGroup/ESMValTool/pull/4459)) by [@bouweandela](https://github.com/bouweandela)

<a id="changelog-v2-14-0"></a>

## v2.14.0

### Highlights

- New diagnostics/recipes:
  : - Calculation of Lamb weathertypes ([Pull request #4231](https://github.com/ESMValGroup/ESMValTool/pull/4231))
    - Histogram plots ([Pull request #4329](https://github.com/ESMValGroup/ESMValTool/pull/4329))
    - Hour of maximum precipitation ([Pull request #4334](https://github.com/ESMValGroup/ESMValTool/pull/4334))
- Support for new observational datasets:
  : - ESACCI SNOW ([Pull request #3542](https://github.com/ESMValGroup/ESMValTool/pull/3542))
    - Improved support for ESACCI AEROSOL ([Pull request #3629](https://github.com/ESMValGroup/ESMValTool/pull/3629))
    - EN4 ([Pull request #4193](https://github.com/ESMValGroup/ESMValTool/pull/4193))
- We modernized our development set-up and are now using [Ruff](https://docs.astral.sh/ruff/) for [Code quality](community/code_documentation.html.md#code-quality) checks and formatting.

This release includes

### Backwards incompatible changes

- Update the CMORizer command ([Pull request #4317](https://github.com/ESMValGroup/ESMValTool/pull/4317), [Pull request #4326](https://github.com/ESMValGroup/ESMValTool/pull/4326)) by [@bouweandela](https://github.com/bouweandela)

### Bug fixes

- Fix recipe_enso_climatology1 - remove collect diagnostic ([Pull request #4221](https://github.com/ESMValGroup/ESMValTool/pull/4221)) by [@flicj191](https://github.com/flicj191)
- Rename `modeling_realm` to `type` in CMORizers ([Pull request #4319](https://github.com/ESMValGroup/ESMValTool/pull/4319)) by [@bouweandela](https://github.com/bouweandela)
- Fix `multi_datasets.py` so it can handle different projections ([Pull request #4358](https://github.com/ESMValGroup/ESMValTool/pull/4358)) by [@schlunma](https://github.com/schlunma)

### Broken or retired recipes

- Remove `recipe_russel18jgr.yml` from list of broken recipes ([Pull request #4351](https://github.com/ESMValGroup/ESMValTool/pull/4351)) by [@schlunma](https://github.com/schlunma)
- Retire `recipe_climwip_brunner2019_med.yml` ([Pull request #4350](https://github.com/ESMValGroup/ESMValTool/pull/4350)) by [@schlunma](https://github.com/schlunma)
- Add `recipe_kcs.yml` to list of broken recipes ([Pull request #4354](https://github.com/ESMValGroup/ESMValTool/pull/4354)) by [@schlunma](https://github.com/schlunma)
- Retire Wenzel recipes ([Pull request #4357](https://github.com/ESMValGroup/ESMValTool/pull/4357)) by [@schlunma](https://github.com/schlunma)
- Remove `recipe_check_obs.yml` from list of broken recipes ([Pull request #4376](https://github.com/ESMValGroup/ESMValTool/pull/4376)) by [@schlunma](https://github.com/schlunma)
- Retire `recipe_eyring*jgr.yml` ([Pull request #4379](https://github.com/ESMValGroup/ESMValTool/pull/4379)) by [@schlunma](https://github.com/schlunma)

### Documentation

- Separate ESMValTool and ESMValCore documentation ([Pull request #3914](https://github.com/ESMValGroup/ESMValTool/pull/3914)) by [@flicj191](https://github.com/flicj191)
- Fix PDF documentation build ([Pull request #4236](https://github.com/ESMValGroup/ESMValTool/pull/4236)) by [@bouweandela](https://github.com/bouweandela)
- Update links to ESMValCore configuration ([Pull request #4249](https://github.com/ESMValGroup/ESMValTool/pull/4249)) by [@bouweandela](https://github.com/bouweandela)
- Document that we follow SPEC 0 ([Pull request #4246](https://github.com/ESMValGroup/ESMValTool/pull/4246)) by [@bouweandela](https://github.com/bouweandela)
- Fix stable documentation build ([Pull request #4253](https://github.com/ESMValGroup/ESMValTool/pull/4253)) by [@bouweandela](https://github.com/bouweandela)
- Update some easy to fix links in documentation ([Pull request #4256](https://github.com/ESMValGroup/ESMValTool/pull/4256)) by [@katjaweigel](https://github.com/katjaweigel)
- Add link checker github action for documentation ([Pull request #4251](https://github.com/ESMValGroup/ESMValTool/pull/4251)) by [@flicj191](https://github.com/flicj191)
- Add ENES-RI Zenodo community ([Pull request #4254](https://github.com/ESMValGroup/ESMValTool/pull/4254)) by [@bouweandela](https://github.com/bouweandela)
- Schedule for link checker and update for recent report ([Pull request #4305](https://github.com/ESMValGroup/ESMValTool/pull/4305)) by [@flicj191](https://github.com/flicj191)
- Pin sphinx<9 ([Pull request #4315](https://github.com/ESMValGroup/ESMValTool/pull/4315)) by [@valeriupredoi](https://github.com/valeriupredoi)
- Add Matomo page view tracking for the documentation ([Pull request #4320](https://github.com/ESMValGroup/ESMValTool/pull/4320)) by [@bouweandela](https://github.com/bouweandela)
- Fix matomo integration ([Pull request #4322](https://github.com/ESMValGroup/ESMValTool/pull/4322)) by [@bouweandela](https://github.com/bouweandela)
- Remove mentions of the deprecated config-developer.yml file from the documentation ([Pull request #4335](https://github.com/ESMValGroup/ESMValTool/pull/4335)) by [@bouweandela](https://github.com/bouweandela)
- Documentation update -remove gensidebar ([Pull request #4345](https://github.com/ESMValGroup/ESMValTool/pull/4345)) by [@flicj191](https://github.com/flicj191)
- Update documentation on defining custom variables ([Pull request #4349](https://github.com/ESMValGroup/ESMValTool/pull/4349)) by [@bouweandela](https://github.com/bouweandela)
- Update contact info ([Pull request #4348](https://github.com/ESMValGroup/ESMValTool/pull/4348)) by [@axel-lauer](https://github.com/axel-lauer)
- Remove mention of deprecated `esmvaltool config get_config_user` command ([Pull request #4366](https://github.com/ESMValGroup/ESMValTool/pull/4366)) by [@schlunma](https://github.com/schlunma)
- Update contact email in documentation ([Pull request #4383](https://github.com/ESMValGroup/ESMValTool/pull/4383)) by [@axel-lauer](https://github.com/axel-lauer)

### Diagnostics

- Calculating Lamb weathertypes for CMIP5, CMIP6, SMILES and EURO-CORDEX ([Pull request #4231](https://github.com/ESMValGroup/ESMValTool/pull/4231)) by [@thomaskroi1996](https://github.com/thomaskroi1996)
- Add diagnostic to plot a histogram ([Pull request #4329](https://github.com/ESMValGroup/ESMValTool/pull/4329)) by [@LisaBock](https://github.com/LisaBock)
- Add diagnostic to calculate hour of maximum precipitation ([Pull request #4334](https://github.com/ESMValGroup/ESMValTool/pull/4334)) by [@schlunma](https://github.com/schlunma)
- Make emergent constraints diagnostics compatible with Pandas>=3 ([Pull request #4356](https://github.com/ESMValGroup/ESMValTool/pull/4356)) by [@schlunma](https://github.com/schlunma)
- Allow specifying `axes_kwargs` in `monitor/multi_datasets.py` ([Pull request #4365](https://github.com/ESMValGroup/ESMValTool/pull/4365)) by [@schlunma](https://github.com/schlunma)

### Observational and re-analysis dataset support

- ESACCI SNOW CMORizer ([Pull request #3542](https://github.com/ESMValGroup/ESMValTool/pull/3542)) by [@axel-lauer](https://github.com/axel-lauer)
- Update CMORizer CERES-EBAF to v4.2 ([Pull request #3360](https://github.com/ESMValGroup/ESMValTool/pull/3360)) by [@axel-lauer](https://github.com/axel-lauer)
- Fix JRA-55 downloader ([Pull request #4191](https://github.com/ESMValGroup/ESMValTool/pull/4191)) by [@LisaBock](https://github.com/LisaBock)
- EN4 cmorizer ([Pull request #4193](https://github.com/ESMValGroup/ESMValTool/pull/4193)) by [@hanellis](https://github.com/hanellis)
- New ESACCI AEROSOL CMORizer (Python version) ([Pull request #3629](https://github.com/ESMValGroup/ESMValTool/pull/3629)) by [@axel-lauer](https://github.com/axel-lauer)
- Extension of ESA CCI OZONE CMORizer ([Pull request #4125](https://github.com/ESMValGroup/ESMValTool/pull/4125)) by [@axel-lauer](https://github.com/axel-lauer)

### Release

- Modernize release notes script ([Pull request #4336](https://github.com/ESMValGroup/ESMValTool/pull/4336)) by [@schlunma](https://github.com/schlunma)

### Automatic testing

- Run Github Action install from conda with Python 3.13 also ([Pull request #4229](https://github.com/ESMValGroup/ESMValTool/pull/4229)) by [@valeriupredoi](https://github.com/valeriupredoi)
- Fix WOA CMORizer tests ([Pull request #4243](https://github.com/ESMValGroup/ESMValTool/pull/4243)) by [@valeriupredoi](https://github.com/valeriupredoi)
- Update recipe tests to align with ESMValCore development ([Pull request #4268](https://github.com/ESMValGroup/ESMValTool/pull/4268)) by [@bouweandela](https://github.com/bouweandela)
- Fix tests for new esmvalcore config ([Pull request #4252](https://github.com/ESMValGroup/ESMValTool/pull/4252)) by [@valeriupredoi](https://github.com/valeriupredoi)
- Clean up OSX Github Action tests ([Pull request #4272](https://github.com/ESMValGroup/ESMValTool/pull/4272)) by [@valeriupredoi](https://github.com/valeriupredoi)
- Update recipe load test so it works with the latest ESMValCore ([Pull request #4294](https://github.com/ESMValGroup/ESMValTool/pull/4294)) by [@bouweandela](https://github.com/bouweandela)
- Increase CirleCI container resource to medium+ ([Pull request #4364](https://github.com/ESMValGroup/ESMValTool/pull/4364)) by [@valeriupredoi](https://github.com/valeriupredoi)
- Update batch job generation script with experiences from latest tests ([Pull request #4378](https://github.com/ESMValGroup/ESMValTool/pull/4378)) by [@schlunma](https://github.com/schlunma)

### Installation

- Use `pip install --no-deps` to avoid overwiting packages from the conda environment ([Pull request #4182](https://github.com/ESMValGroup/ESMValTool/pull/4182)) by [@bouweandela](https://github.com/bouweandela)
- Drop support for Python 3.11 ([Pull request #4273](https://github.com/ESMValGroup/ESMValTool/pull/4273)) by [@bouweandela](https://github.com/bouweandela)
- Pin iris <3.14.1 to comply with iris-esmf-regrid 0.13 ([Pull request #4284](https://github.com/ESMValGroup/ESMValTool/pull/4284)) by [@valeriupredoi](https://github.com/valeriupredoi)
- Update package build and deploy ([Pull request #4289](https://github.com/ESMValGroup/ESMValTool/pull/4289)) by [@bouweandela](https://github.com/bouweandela)
- Drop `ruamel.yaml` as a dependency ([Pull request #4295](https://github.com/ESMValGroup/ESMValTool/pull/4295)) by [@bouweandela](https://github.com/bouweandela)
- Unpin iris ([Pull request #4304](https://github.com/ESMValGroup/ESMValTool/pull/4304)) by [@valeriupredoi](https://github.com/valeriupredoi)
- Remove R development dependencies ([Pull request #4306](https://github.com/ESMValGroup/ESMValTool/pull/4306)) by [@valeriupredoi](https://github.com/valeriupredoi)
- Update environment.yml with R dependency r-r.utils for recipe_martin18grl and recipe_spei ([Pull request #4355](https://github.com/ESMValGroup/ESMValTool/pull/4355)) by [@katjaweigel](https://github.com/katjaweigel)
- Pin numpy >=2 ([Pull request #4375](https://github.com/ESMValGroup/ESMValTool/pull/4375)) by [@valeriupredoi](https://github.com/valeriupredoi)

### Improvements

- Switch from Prospector to ruff ([Pull request #4209](https://github.com/ESMValGroup/ESMValTool/pull/4209)) by [@bouweandela](https://github.com/bouweandela)
- Fix Codacy configuration ([Pull request #4262](https://github.com/ESMValGroup/ESMValTool/pull/4262)) by [@bouweandela](https://github.com/bouweandela)
- Apply automatic fixes for style issues ([Pull request #4263](https://github.com/ESMValGroup/ESMValTool/pull/4263)) by [@bouweandela](https://github.com/bouweandela)
- Update obs4MIPs dataset names ([Pull request #4321](https://github.com/ESMValGroup/ESMValTool/pull/4321), [Pull request #4377](https://github.com/ESMValGroup/ESMValTool/pull/4377)) by [@bouweandela](https://github.com/bouweandela) and [@valeriupredoi](https://github.com/valeriupredoi)
- Add `keep_group_coordinates: true` to recipes that fail without it ([Pull request #4352](https://github.com/ESMValGroup/ESMValTool/pull/4352)) by [@schlunma](https://github.com/schlunma)
- Load configuration before accessing CMOR tables ([Pull request #4363](https://github.com/ESMValGroup/ESMValTool/pull/4363)) by [@bouweandela](https://github.com/bouweandela)
- Avoid failing tests on coverage upload from forks ([Pull request #4371](https://github.com/ESMValGroup/ESMValTool/pull/4371)) by [@bouweandela](https://github.com/bouweandela)

<a id="changelog-v2-13-0"></a>

## v2.13.0

### Highlights

Constellation of CMORizers and diagnostics updated/implemented as part of the
[Rapid Evaluation Framework (REF)](https://wcrp-cmip.org/cmip-phases/cmip7/rapid-evaluation-framework/):

- CMORizers:
  > - Update of the ESACCI-OZONE CMORizer
  > - ESACCI-SEAICE CMORizer
  > - Update of the OSI-450 (OSISAF/CCI) CMORizer
- [Diagnostics](recipes/recipe_ref.html.md#recipes-ref):
  > - Seasonal cycle and time series of Arctic/Antarctic sea ice area
  > - [Zero Emissions Commitment (ZEC)](recipes/recipe_zec.html.md#recipes-zec)
  > - Cloud radiative effects
  > - [Transient Climate Response to Emissions (TCRE)](recipes/recipe_tcre.html.md#recipes-tcre)
  > - [ENSO metrics](recipes/recipe_enso_ref.html.md#recipes-enso-metrics)
  > - 2D histograms and scatterplots for clouds
  > - Regional historical changes
  > - [Evaluation of climate variables at Global warming levels](recipes/recipe_calculate_gwl_exceedance_stats.html.md#recipes-recipe-calculate-gwl-exceedance-stats)
  > - [Sea surface temperature bias (IPCC AR6 Ch3 Fig. 3.24)](recipes/recipe_ipccwg1ar6ch3.html.md#recipes-ipccwg1ar6ch3)
  > - [Climate drivers for fire](recipes/recipe_ref_fire.html.md#recipe-ref-fire)
  > - [Rate of sea ice area loss per degree of warming](recipes/recipe_seaice_sensitivity.html.md#recipe-seaice-sensitivity)
  > - Ozone metrics and climatology

This release includes

### Backwards incompatible changes

- Refactor diagnostic monitor/multi_datasets.py ([Pull request #4002](https://github.com/ESMValGroup/ESMValTool/pull/4002)) by [@schlunma](https://github.com/schlunma)
  Plot option annual_mean_kwargs: This will be ignored now. Previously,
  this could lead to errors in rare cases. Instead, explicitly specify a
  dataset that uses the annual_statistics preprocessor in the recipe,
  for example esmvaltool/recipes/monitor/recipe_monitor_with_refs.yml#L132-L139.
- Retire recipe schlund20jgr ([Pull request #4022](https://github.com/ESMValGroup/ESMValTool/pull/4022)) by [@axel-lauer](https://github.com/axel-lauer)
- Retire julia recipes ([Pull request #4045](https://github.com/ESMValGroup/ESMValTool/pull/4045)) by [@bettina-gier](https://github.com/bettina-gier)
- Retire psyplot recipe and diagnostic ([Pull request #4063](https://github.com/ESMValGroup/ESMValTool/pull/4063)) by [@valeriupredoi](https://github.com/valeriupredoi)

### Community

- Added stale action ([Pull request #4100](https://github.com/ESMValGroup/ESMValTool/pull/4100)) by [@schlunma](https://github.com/schlunma)

### Documentation

- Update citation and changelog for version 2.12 ([Pull request #3945](https://github.com/ESMValGroup/ESMValTool/pull/3945)) by [@sloosvel](https://github.com/sloosvel)
- Use Python-only environment for ReadTheDocs builds ([Pull request #3955](https://github.com/ESMValGroup/ESMValTool/pull/3955)) by [@valeriupredoi](https://github.com/valeriupredoi)
- Add explanatory note in documentation advice on Codacy ([Pull request #4020](https://github.com/ESMValGroup/ESMValTool/pull/4020)) by [@alistairsellar](https://github.com/alistairsellar)
- Extend broken recipe policy ([Pull request #3913](https://github.com/ESMValGroup/ESMValTool/pull/3913)) by [@axel-lauer](https://github.com/axel-lauer)
- Remove some more Julia references from documentation (but keep some) ([Pull request #4073](https://github.com/ESMValGroup/ESMValTool/pull/4073)) by [@valeriupredoi](https://github.com/valeriupredoi)
- Add footer with legal info ([Pull request #4072](https://github.com/ESMValGroup/ESMValTool/pull/4072)) by [@axel-lauer](https://github.com/axel-lauer)
- Add mention of NSC HPC servers ([Pull request #4084](https://github.com/ESMValGroup/ESMValTool/pull/4084)) by [@jlenh](https://github.com/jlenh)
- Update figure selection and layout of the gallery ([Pull request #4060](https://github.com/ESMValGroup/ESMValTool/pull/4060)) by [@bettina-gier](https://github.com/bettina-gier)
- Update timeline for release 2.13.0 ([Pull request #4096](https://github.com/ESMValGroup/ESMValTool/pull/4096)) by [@jlenh](https://github.com/jlenh)
- Refer to esmvaltool.org webpage for development team information ([Pull request #3892](https://github.com/ESMValGroup/ESMValTool/pull/3892)) by [@bouweandela](https://github.com/bouweandela)
- Remove mention of Julia in documentation ahead of discontinued support in v2.13 ([Pull request #4156](https://github.com/ESMValGroup/ESMValTool/pull/4156)) by [@jlenh](https://github.com/jlenh)
- Update cartopy documentation link to fix documentation build fail ([Pull request #4179](https://github.com/ESMValGroup/ESMValTool/pull/4179)) by [@jlenh](https://github.com/jlenh)
- Add debugging help ([Pull request #2638](https://github.com/ESMValGroup/ESMValTool/pull/2638)) by [@zklaus](https://github.com/zklaus)

### Diagnostics

- Add recipe for seasonal cycle and time series of Arctic/Antarctic sea ice area (REF) ([Pull request #3891](https://github.com/ESMValGroup/ESMValTool/pull/3891)) by [@axel-lauer](https://github.com/axel-lauer)
- Add recipe and diagnostic for ZEC (Zero Emissions Commitment) ([Pull request #3897](https://github.com/ESMValGroup/ESMValTool/pull/3897)) by [@bettina-gier](https://github.com/bettina-gier)
- Create scatterplots for the REF ([Pull request #3923](https://github.com/ESMValGroup/ESMValTool/pull/3923)) by [@LisaBock](https://github.com/LisaBock)
- Evaluate key climate variables at Global warming levels ([Pull request #3927](https://github.com/ESMValGroup/ESMValTool/pull/3927)) by [@rswamina](https://github.com/rswamina)
- Add SST bias diagnostic for IPCC AR6 Ch3 Fig. 3.24. Can be used for REF. ([Pull request #3944](https://github.com/ESMValGroup/ESMValTool/pull/3944)) by [@malininae](https://github.com/malininae)
- Update recipe_combined_indices.yml for R versions larger than 4.2 ([Pull request #3967](https://github.com/ESMValGroup/ESMValTool/pull/3967)) by [@bouweandela](https://github.com/bouweandela)
- Added option to plot horizontal lines in monitoring line plots ([Pull request #3977](https://github.com/ESMValGroup/ESMValTool/pull/3977)) by [@schlunma](https://github.com/schlunma)
- Fix R recipes for R > 4.2 ([Pull request #3985](https://github.com/ESMValGroup/ESMValTool/pull/3985)) by [@sloosvel](https://github.com/sloosvel)
- REF ozone recipe ([Pull request #3988](https://github.com/ESMValGroup/ESMValTool/pull/3988)) by [@hb326](https://github.com/hb326)
- Faster and lower memory version of recipe_ref_scatterplot.yml ([Pull request #3992](https://github.com/ESMValGroup/ESMValTool/pull/3992)) by [@bouweandela](https://github.com/bouweandela)
- Update GPCP and ERA5 obs4MIPs datasets in recipe_ref_scatterplot.yml ([Pull request #4011](https://github.com/ESMValGroup/ESMValTool/pull/4011)) by [@bouweandela](https://github.com/bouweandela)
- Add option to specify caption in recipe for monitor/multi_datasets.py ([Pull request #4028](https://github.com/ESMValGroup/ESMValTool/pull/4028)) by [@schlunma](https://github.com/schlunma)
- Optimize caption produced by tcr.py ([Pull request #4042](https://github.com/ESMValGroup/ESMValTool/pull/4042)) by [@schlunma](https://github.com/schlunma)
- Optimize caption produced by ecs.py ([Pull request #4040](https://github.com/ESMValGroup/ESMValTool/pull/4040)) by [@schlunma](https://github.com/schlunma)
- Fix tcre metric diagnostic ([Pull request #4044](https://github.com/ESMValGroup/ESMValTool/pull/4044)) by [@valeriupredoi](https://github.com/valeriupredoi)
- Optimize tcre.py diagnostic (caption and usability via Python API) ([Pull request #4056](https://github.com/ESMValGroup/ESMValTool/pull/4056)) by [@schlunma](https://github.com/schlunma)
- Add additional diagnostics to recipe_ocean_quadmap.yml ([Pull request #3953](https://github.com/ESMValGroup/ESMValTool/pull/3953)) by [@SophieHall2024](https://github.com/SophieHall2024)
- New CH4 lifetime diagnostic ([Pull request #3507](https://github.com/ESMValGroup/ESMValTool/pull/3507)) by [@FranziskaWinterstein](https://github.com/FranziskaWinterstein)
- New recipe: rate of sea ice area loss per degree warming ([Pull request #3983](https://github.com/ESMValGroup/ESMValTool/pull/3983)) by [@alistairsellar](https://github.com/alistairsellar)
- Remove unused option annual_mean_kwargs from all recipes ([Pull request #4133](https://github.com/ESMValGroup/ESMValTool/pull/4133)) by [@schlunma](https://github.com/schlunma)
- Aeronet format updates and diagnostic changes ([Pull request #4131](https://github.com/ESMValGroup/ESMValTool/pull/4131)) by [@nchawang](https://github.com/nchawang)
- Use obs4MIPs consistently in all recipes ([Pull request #4142](https://github.com/ESMValGroup/ESMValTool/pull/4142)) by [@bouweandela](https://github.com/bouweandela)
- Add missing method in seaice_drift.py ([Pull request #4161](https://github.com/ESMValGroup/ESMValTool/pull/4161)) by [@sloosvel](https://github.com/sloosvel)
- Update the name of the remapscon2 operator in R recipes ([Pull request #4164](https://github.com/ESMValGroup/ESMValTool/pull/4164)) by [@jlenh](https://github.com/jlenh)
- Trace gases (CO2, CH4, N2O) surface concentration diagnostic ([Pull request #4014](https://github.com/ESMValGroup/ESMValTool/pull/4014)) by [@jlenh](https://github.com/jlenh)
- Climate drivers for fire for REF ([Pull request #3975](https://github.com/ESMValGroup/ESMValTool/pull/3975)) by [@jlenh](https://github.com/jlenh)
- Exchange toz reference data in ozone REF recipe ([Pull request #4008](https://github.com/ESMValGroup/ESMValTool/pull/4008)) by [@axel-lauer](https://github.com/axel-lauer)
- Add captions to REF recipe for basic sea ice area diags ([Pull request #4033](https://github.com/ESMValGroup/ESMValTool/pull/4033)) by [@axel-lauer](https://github.com/axel-lauer)
- CLIVAR ENSO metrics for REF ([Pull request #3972](https://github.com/ESMValGroup/ESMValTool/pull/3972)) by [@flicj191](https://github.com/flicj191)
- Update and combine drought diagnostics ([Pull request #3907](https://github.com/ESMValGroup/ESMValTool/pull/3907)) by [@lukruh](https://github.com/lukruh)
- Regional historical changes for REF ([Pull request #3926](https://github.com/ESMValGroup/ESMValTool/pull/3926)) by [@katjaweigel](https://github.com/katjaweigel)
- Add more datasets to recipe_easy_ipcc.yml ([Pull request #3920](https://github.com/ESMValGroup/ESMValTool/pull/3920)) by [@bouweandela](https://github.com/bouweandela)
- ACCESS-NRI ENSO diagnostics CLIVAR porting ([Pull request #3905](https://github.com/ESMValGroup/ESMValTool/pull/3905)) by [@flicj191](https://github.com/flicj191)
- Correct typo in “pearsonr” ([Pull request #4140](https://github.com/ESMValGroup/ESMValTool/pull/4140)) by [@katjaweigel](https://github.com/katjaweigel)
- Update time ranges in REF ‘cloud radiative effect’ recipe ([Pull request #4057](https://github.com/ESMValGroup/ESMValTool/pull/4057)) by [@LisaBock](https://github.com/LisaBock)
- Fix caption and time range for REF diagnostic “Cloud scatterplots” ([Pull request #4066](https://github.com/ESMValGroup/ESMValTool/pull/4066)) by [@LisaBock](https://github.com/LisaBock)
- Portrait plot example: remove sea surface temperature ([Pull request #4099](https://github.com/ESMValGroup/ESMValTool/pull/4099)) by [@lukruh](https://github.com/lukruh)
- Recipes ipccwg1ar5ch9: Update CERES and GPCP versions to match ESGF ([Pull request #3440](https://github.com/ESMValGroup/ESMValTool/pull/3440)) by [@rbeucher](https://github.com/rbeucher)
- Recipe_schlund20esd Remove CERES-EBAF version to fix ESGF search ([Pull request #3441](https://github.com/ESMValGroup/ESMValTool/pull/3441)) by [@rbeucher](https://github.com/rbeucher)
- Adding basic sanity checks ([Pull request #4120](https://github.com/ESMValGroup/ESMValTool/pull/4120)) by [@LisaBock](https://github.com/LisaBock)
- Adding optional data output for seaborn_diag.py ([Pull request #4144](https://github.com/ESMValGroup/ESMValTool/pull/4144)) by [@katjaweigel](https://github.com/katjaweigel)
- Fix recipe_williams09climdyn_CREM.yml by replacing np.NAN with np.nan ([Pull request #4160](https://github.com/ESMValGroup/ESMValTool/pull/4160)) by [@jlenh](https://github.com/jlenh)
- Fix recipe_carvalhais14nat.yml to avoid the usage of vars() inside a function ([Pull request #4170](https://github.com/ESMValGroup/ESMValTool/pull/4170)) by [@jlenh](https://github.com/jlenh)
- Fix small matplotlib errors in recipe_zmnam.yml ([Pull request #4177](https://github.com/ESMValGroup/ESMValTool/pull/4177)) by [@jlenh](https://github.com/jlenh)
- Fix \_fix_lons function in recipe_flato13ipcc_figure_914.yml due to numpy error [#4034] ([Pull request #4178](https://github.com/ESMValGroup/ESMValTool/pull/4178)) by [@jlenh](https://github.com/jlenh)
- Improve the handling of options in recipe_ref_fire.yml ([Pull request #4184](https://github.com/ESMValGroup/ESMValTool/pull/4184)) by [@bouweandela](https://github.com/bouweandela)
- Fix small matplotlib errors in recipe_zmnam.yml ([Pull request #4177](https://github.com/ESMValGroup/ESMValTool/pull/4177)) by [@jlenh](https://github.com/jlenh)
- Fix minor NCL errors for recipe_russel18jgr.yml ([Pull request #4183](https://github.com/ESMValGroup/ESMValTool/pull/4183)) by [@jlenh](https://github.com/jlenh)
- Fix specification for WOA dataset in recipe_ocean_quadmap ([Pull request #4176](https://github.com/ESMValGroup/ESMValTool/pull/4176)) by [@TomasTorsvik](https://github.com/TomasTorsvik)
- Fix autoassess normalise error ([Pull request #4187](https://github.com/ESMValGroup/ESMValTool/pull/4187)) by [@alistairsellar](https://github.com/alistairsellar)

### Observational and re-analysis dataset support

- Update ESACCI-OZONE CMORizer(formatter and downloader) for REF ([Pull request #3899](https://github.com/ESMValGroup/ESMValTool/pull/3899)) by [@diegokam](https://github.com/diegokam)
- Update CMORizer for OSI-450 aka OSISAF/CCI (sea ice concentration) ([Pull request #3963](https://github.com/ESMValGroup/ESMValTool/pull/3963)) by [@axel-lauer](https://github.com/axel-lauer)
- Adding HadEX3 CMORizer ([Pull request #3636](https://github.com/ESMValGroup/ESMValTool/pull/3636)) by [@malininae](https://github.com/malininae)
- Downloader & cmorizer for NOAA GML surface flask trace gases  ([Pull request #3847](https://github.com/ESMValGroup/ESMValTool/pull/3847)) by [@jlenh](https://github.com/jlenh)
- Use nested update to parse configuration options given to CMORizer interface ([Pull request #4113](https://github.com/ESMValGroup/ESMValTool/pull/4113)) by [@schlunma](https://github.com/schlunma)
- Aeronet-header-fix to handle V3 data ([Pull request #4101](https://github.com/ESMValGroup/ESMValTool/pull/4101)) by [@nchawang](https://github.com/nchawang)
- Cmorizer for the Wetland Area and Dynamics for Methane Modeling (WAD2M) dataset ([Pull request #4110](https://github.com/ESMValGroup/ESMValTool/pull/4110)) by [@jlenh](https://github.com/jlenh)
- Cmorizer for the Global Lakes and Wetlands Database (GLWD) version 2.0 dataset ([Pull request #4112](https://github.com/ESMValGroup/ESMValTool/pull/4112)) by [@jlenh](https://github.com/jlenh)
- Update ESACCI Cloud CMORizer (daily and monthly data)  ([Pull request #3756](https://github.com/ESMValGroup/ESMValTool/pull/3756)) by [@diegokam](https://github.com/diegokam)
- Fix coords in ESACCI-CLOUD cmorizer ([Pull request #4129](https://github.com/ESMValGroup/ESMValTool/pull/4129)) by [@LisaBock](https://github.com/LisaBock)
- Added CMORizer for Yang2020 data ([Pull request #4090](https://github.com/ESMValGroup/ESMValTool/pull/4090)) by [@schlunma](https://github.com/schlunma)
- Add CMORized NOAA GML surface flask concentration measurement of N2O ([Pull request #4059](https://github.com/ESMValGroup/ESMValTool/pull/4059)) by [@jlenh](https://github.com/jlenh)
- CMORizer for ESACCI-BIOMASS ([Pull request #4121](https://github.com/ESMValGroup/ESMValTool/pull/4121)) by [@axel-lauer](https://github.com/axel-lauer)
- Faster OSI-450-nh and OSI-450-sh CMORizer and respect Dask settings ([Pull request #3990](https://github.com/ESMValGroup/ESMValTool/pull/3990)) by [@bouweandela](https://github.com/bouweandela)
- CMORiser for the IAPv4.2 global ocean temperature dataset ([Pull request #3887](https://github.com/ESMValGroup/ESMValTool/pull/3887)) by [@rbeucher](https://github.com/rbeucher)
- Update recipe_check_obs.yml to match the latest AERONET data ([Pull request #4171](https://github.com/ESMValGroup/ESMValTool/pull/4171)) by [@hb326](https://github.com/hb326)
- Update version facet for ESACCI-CLOUD in recipe_check_obs.yml ([Pull request #4166](https://github.com/ESMValGroup/ESMValTool/pull/4166)) by [@jlenh](https://github.com/jlenh)
- Remove end_year facet for NOAA-GML datasets in recipe_check_obs.yml ([Pull request #4167](https://github.com/ESMValGroup/ESMValTool/pull/4167)) by [@jlenh](https://github.com/jlenh)
- New version of JRA-25 CMORizer ([Pull request #3470](https://github.com/ESMValGroup/ESMValTool/pull/3470)) by [@axel-lauer](https://github.com/axel-lauer)
- Add CAMS cmorizer ([Pull request #3749](https://github.com/ESMValGroup/ESMValTool/pull/3749)) by [@bettina-gier](https://github.com/bettina-gier)

### Automatic testing

- Use mamba>=2 for Circle CI upstream development test ([Pull request #3949](https://github.com/ESMValGroup/ESMValTool/pull/3949)) by [@valeriupredoi](https://github.com/valeriupredoi)
- Use python-only environment file for Circle build documentation ([Pull request #3981](https://github.com/ESMValGroup/ESMValTool/pull/3981)) by [@valeriupredoi](https://github.com/valeriupredoi)
- Use conda exec instead of mamba for circleCI build_documentation test ([Pull request #4003](https://github.com/ESMValGroup/ESMValTool/pull/4003)) by [@valeriupredoi](https://github.com/valeriupredoi)
- Run pre-commit on main ([Pull request #4026](https://github.com/ESMValGroup/ESMValTool/pull/4026)) by [@schlunma](https://github.com/schlunma)
- Try set a longer no output time limit for Circle tests ([Pull request #4035](https://github.com/ESMValGroup/ESMValTool/pull/4035)) by [@valeriupredoi](https://github.com/valeriupredoi)
- Only run imagehash tests on Linux machines ([Pull request #4039](https://github.com/ESMValGroup/ESMValTool/pull/4039)) by [@schlunma](https://github.com/schlunma)
- Do not run conda install package Github Action with Python 3.13 (yet) ([Pull request #4071](https://github.com/ESMValGroup/ESMValTool/pull/4071)) by [@valeriupredoi](https://github.com/valeriupredoi)
- Fix Cicle CI tests (prepend Julia to PATH for the containerized run tests) ([Pull request #4086](https://github.com/ESMValGroup/ESMValTool/pull/4086)) by [@valeriupredoi](https://github.com/valeriupredoi)
- Automatically open pull requests to update GitHub Actions ([Pull request #4143](https://github.com/ESMValGroup/ESMValTool/pull/4143)) by [@valeriupredoi](https://github.com/valeriupredoi)
- Run esmvalbot test PR twice a month ([Pull request #3976](https://github.com/ESMValGroup/ESMValTool/pull/3976)) by [@bouweandela](https://github.com/bouweandela)
- Add DKRZ resources for RTW to dkrz-recipes.jinja ([Pull request #3986](https://github.com/ESMValGroup/ESMValTool/pull/3986)) by [@ehogan](https://github.com/ehogan)
- Add JASMIN resources for RTW to jasmin-recipes.jinja ([Pull request #3987](https://github.com/ESMValGroup/ESMValTool/pull/3987)) by [@ehogan](https://github.com/ehogan)
- Use site directories in the RTW ([Pull request #3984](https://github.com/ESMValGroup/ESMValTool/pull/3984)) by [@ehogan](https://github.com/ehogan)
- Update MO paths in the RTW ([Pull request #4006](https://github.com/ESMValGroup/ESMValTool/pull/4006)) by [@ehogan](https://github.com/ehogan)
- Select directories for comparison carefully in the RTW ([Pull request #4007](https://github.com/ESMValGroup/ESMValTool/pull/4007)) by [@ehogan](https://github.com/ehogan)
- Implement additional user configuration options in RTW ([Pull request #4009](https://github.com/ESMValGroup/ESMValTool/pull/4009)) by [@ehogan](https://github.com/ehogan)
- Generate “recipe status” HTML after each Recipe Test Workflow cycle ([Pull request #4013](https://github.com/ESMValGroup/ESMValTool/pull/4013)) by [@chrisbillowsMO](https://github.com/chrisbillowsMO)
- Update RTW to use the git scheme ([Pull request #4030](https://github.com/ESMValGroup/ESMValTool/pull/4030)) by [@ehogan](https://github.com/ehogan)
- Add housekeeping to RTW ([Pull request #4019](https://github.com/ESMValGroup/ESMValTool/pull/4019)) by [@ehogan](https://github.com/ehogan)
- Revert “Update RTW to use the git scheme” ([Pull request #4041](https://github.com/ESMValGroup/ESMValTool/pull/4041)) by [@ehogan](https://github.com/ehogan)
- Update location of recipe_consecdrydays.yml in the RTW ([Pull request #4052](https://github.com/ESMValGroup/ESMValTool/pull/4052)) by [@ehogan](https://github.com/ehogan)
- Monitor Tests workflow fails ([Pull request #4065](https://github.com/ESMValGroup/ESMValTool/pull/4065)) by [@chrisbillowsMO](https://github.com/chrisbillowsMO)
- RTW status report shows missing compare tasks as succeeded ([Pull request #4064](https://github.com/ESMValGroup/ESMValTool/pull/4064)) by [@chrisbillowsMO](https://github.com/chrisbillowsMO)
- Use compare command in recipe test workflow ([Pull request #4087](https://github.com/ESMValGroup/ESMValTool/pull/4087)) by [@alistairsellar](https://github.com/alistairsellar)
- Separate BRANCH variable for recipe_test_workflow cloning Core and Tool ([Pull request #4070](https://github.com/ESMValGroup/ESMValTool/pull/4070)) by [@alistairsellar](https://github.com/alistairsellar)
- Update RTW to use new user configuration ([Pull request #4017](https://github.com/ESMValGroup/ESMValTool/pull/4017)) by [@ehogan](https://github.com/ehogan)

### Installation

- Remove Julia from conda dependency environment (but keep tests for esmvaltool install Julia)
  and add docs how to install from source ([Pull request #3921](https://github.com/ESMValGroup/ESMValTool/pull/3921)) by [@valeriupredoi](https://github.com/valeriupredoi)
- Unpin upper limit r-base ([Pull request #3971](https://github.com/ESMValGroup/ESMValTool/pull/3971)) by [@valeriupredoi](https://github.com/valeriupredoi)
- Drop support for Python 3.10 ([Pull request #4027](https://github.com/ESMValGroup/ESMValTool/pull/4027)) by [@schlunma](https://github.com/schlunma)
- Support Python 3.13 ([Pull request #3805](https://github.com/ESMValGroup/ESMValTool/pull/3805)) by [@valeriupredoi](https://github.com/valeriupredoi)
- Tackle Julia in DockerHub container builds: remove nstallation of packages
  (and remove dependencies in Project.jl bar :beer: YAML) ([Pull request #4083](https://github.com/ESMValGroup/ESMValTool/pull/4083)) by [@valeriupredoi](https://github.com/valeriupredoi)
- Use pyproject.toml and retire setup.py with NO Ruff configuration changes ([Pull request #4088](https://github.com/ESMValGroup/ESMValTool/pull/4088)) by [@valeriupredoi](https://github.com/valeriupredoi)
- Update environment to use ESMValCore v2.13.0rc1 ([Pull request #4169](https://github.com/ESMValGroup/ESMValTool/pull/4169)) by [@bouweandela](https://github.com/bouweandela)
- Update ESMValCore version also for OSX ([Pull request #4174](https://github.com/ESMValGroup/ESMValTool/pull/4174)) by [@bouweandela](https://github.com/bouweandela)

### Improvements

- Replace flake8, yapf, and isort with ruff ([Pull request #3893](https://github.com/ESMValGroup/ESMValTool/pull/3893)) by [@bouweandela](https://github.com/bouweandela)
- Remove test_recipe command ([Pull request #4031](https://github.com/ESMValGroup/ESMValTool/pull/4031)) by [@alistairsellar](https://github.com/alistairsellar)
- Replace deprecated horizontal regridding scheme linear_extrapolate with generic scheme ([Pull request #4081](https://github.com/ESMValGroup/ESMValTool/pull/4081)) by [@schlunma](https://github.com/schlunma)
- Add compare command, via new develop command group ([Pull request #4054](https://github.com/ESMValGroup/ESMValTool/pull/4054)) by [@alistairsellar](https://github.com/alistairsellar)
- Add extra Ruff rules and switch to requires-python = “>=3.11” in pyproject.toml ([Pull request #4085](https://github.com/ESMValGroup/ESMValTool/pull/4085)) by [@valeriupredoi](https://github.com/valeriupredoi)
- Move dependabot configuration to correct path ([Pull request #4145](https://github.com/ESMValGroup/ESMValTool/pull/4145)) by [@bouweandela](https://github.com/bouweandela)
- Use trusted publisher routine for PyPI and retire token-based type ([Pull request #4150](https://github.com/ESMValGroup/ESMValTool/pull/4150)) by [@valeriupredoi](https://github.com/valeriupredoi)
- Fix pypa Github Action version ([Pull request #4151](https://github.com/ESMValGroup/ESMValTool/pull/4151)) by [@valeriupredoi](https://github.com/valeriupredoi)

<a id="changelog-v2-12-0"></a>

## v2.12.0

### Highlights

- Recipe [recipe_portrait_CMIP.yml](recipes/recipe_portrait.html.md#recipe-portrait) allows the creation
  of portrait plots to visualize performance metrics.
- A set of new [recipes](recipes/recipe_benchmarking.html.md#recipe-benchmarking) allow plotting
  arbitrary preprocessor output to benchmark a model simulation with
  other datasets.

This release includes

### Backwards incompatible changes

- Remove recipe filler utility ([Pull request #3777](https://github.com/ESMValGroup/ESMValTool/pull/3777)) by [@schlunma](https://github.com/schlunma).
  ESMValTool accepts the use of wildcards in the recipe, and a filled
  version of the recipe is automatically created and stored in the
  run directory.

### Deprecations

- Adapt ESMValTool to new configuration ([Pull request #3761](https://github.com/ESMValGroup/ESMValTool/pull/3761)) by [@schlunma](https://github.com/schlunma)
  - The single configuration file `config-user.yml` has been deprecated in favour of configuration directories.
    By default, the directory `~/.config/esmvaltool` will be considered.
    To switch to the new format run:
    > ```bash
    > mkdir -p ~/.config/esmvaltool && mv ~/.esmvaltool/config-user.yml ~/.config/esmvaltool
    > ```

    You can also specify the location of the configuration directory with the `--config_dir` flag.
    Please refer to [Configuration](https://docs.esmvaltool.org/projects/ESMValCore/en/latest/quickstart/configure.html#config) for a detailed description on how to configure the tool.

### Bug fixes

- Fix for setting global attributes in cmorizers ([Pull request #3717](https://github.com/ESMValGroup/ESMValTool/pull/3717)) by [@LisaBock](https://github.com/LisaBock)

### Community

- Add a security policy ([Pull request #3456](https://github.com/ESMValGroup/ESMValTool/pull/3456)) by [@ehogan](https://github.com/ehogan)

### Documentation

- Ignore autosummary warning in documentation build ([Pull request #3718](https://github.com/ESMValGroup/ESMValTool/pull/3718)) by [@valeriupredoi](https://github.com/valeriupredoi)
- Retire mambaforge - addendum to 3774 ([Pull request #3778](https://github.com/ESMValGroup/ESMValTool/pull/3778)) by [@valeriupredoi](https://github.com/valeriupredoi)
- Update Docker builds badge in README ([Pull request #3783](https://github.com/ESMValGroup/ESMValTool/pull/3783)) by [@valeriupredoi](https://github.com/valeriupredoi)
- Readthedocs configuration/builds: revert to miniconda before miniforge is available ([Pull request #3785](https://github.com/ESMValGroup/ESMValTool/pull/3785)) by [@valeriupredoi](https://github.com/valeriupredoi)
- Add info on obs tiers to docu ([Pull request #3624](https://github.com/ESMValGroup/ESMValTool/pull/3624)) by [@axel-lauer](https://github.com/axel-lauer)
- Fix wrong version in title in Readthedocs documentation ([Pull request #3815](https://github.com/ESMValGroup/ESMValTool/pull/3815)) by [@valeriupredoi](https://github.com/valeriupredoi)
- Removed wrong description of option in portrait plot docstring ([Pull request #3908](https://github.com/ESMValGroup/ESMValTool/pull/3908)) by [@schlunma](https://github.com/schlunma)
- Update broken recipes ([Pull request #3940](https://github.com/ESMValGroup/ESMValTool/pull/3940)) by [@sloosvel](https://github.com/sloosvel)
- Add next release schedule ([Pull request #3794](https://github.com/ESMValGroup/ESMValTool/pull/3794)) by [@sloosvel](https://github.com/sloosvel)

### Diagnostics

- More flexible file loading in monitor/multi_datasets.py ([Pull request #3728](https://github.com/ESMValGroup/ESMValTool/pull/3728)) by [@schlunma](https://github.com/schlunma)
- Add option to plot time on x-axis in monitoring Hovmoeller plots ([Pull request #3732](https://github.com/ESMValGroup/ESMValTool/pull/3732)) by [@FranziskaWinterstein](https://github.com/FranziskaWinterstein)
- Use transform_first=True for contourf plots with Robinson projection to avoid cartopy bug ([Pull request #3789](https://github.com/ESMValGroup/ESMValTool/pull/3789)) by [@schlunma](https://github.com/schlunma)
- Fix contourf plots for masked data ([Pull request #3797](https://github.com/ESMValGroup/ESMValTool/pull/3797)) by [@schlunma](https://github.com/schlunma)
- Fix issue related to removal/change of private function imported in diag_scripts/shared/_supermeans.py (deprecation in iris=3.11) ([Pull request #3810](https://github.com/ESMValGroup/ESMValTool/pull/3810)) by [@valeriupredoi](https://github.com/valeriupredoi)
- Allow setting matplotlib.rcParams in monitor/multi_datasets.py ([Pull request #3844](https://github.com/ESMValGroup/ESMValTool/pull/3844)) by [@schlunma](https://github.com/schlunma)
- Adding figures of Bock and Lauer (2024) ([Pull request #3526](https://github.com/ESMValGroup/ESMValTool/pull/3526)) by [@LisaBock](https://github.com/LisaBock)
- Added Python portrait plot diagnostic ([Pull request #3551](https://github.com/ESMValGroup/ESMValTool/pull/3551)) by [@lukruh](https://github.com/lukruh)
- Fix Autoassess diagnostic for new matplotlib 3.10 api change ([Pull request #3917](https://github.com/ESMValGroup/ESMValTool/pull/3917)) by [@valeriupredoi](https://github.com/valeriupredoi)
- Fix diagnostic mpqb ([Pull request #3918](https://github.com/ESMValGroup/ESMValTool/pull/3918)) by [@sloosvel](https://github.com/sloosvel)
- Add diagnostic to calculate Transient Climate Response to Emissions (TCRE) ([Pull request #3904](https://github.com/ESMValGroup/ESMValTool/pull/3904)) by [@schlunma](https://github.com/schlunma)
- Benchmarking recipes (Lauer et al.) ([Pull request #3598](https://github.com/ESMValGroup/ESMValTool/pull/3598)) by [@axel-lauer](https://github.com/axel-lauer)
- Add Cloud Radiative Effects recipe for REF ([Pull request #3903](https://github.com/ESMValGroup/ESMValTool/pull/3903)) by [@LisaBock](https://github.com/LisaBock)

### Observational and re-analysis dataset support

- Update esacci-soilmoisture(v08.1) downloader and CMORizer (Python version) ([Pull request #3676](https://github.com/ESMValGroup/ESMValTool/pull/3676)) by [@diegokam](https://github.com/diegokam)
- Update ESACCI Landcover CMORizer (python version) and downloader (pft yearly data, v2.0.8) ([Pull request #3727](https://github.com/ESMValGroup/ESMValTool/pull/3727)) by [@diegokam](https://github.com/diegokam)
- CMORizer for JRA-55 ([Pull request #3141](https://github.com/ESMValGroup/ESMValTool/pull/3141)) by [@axel-lauer](https://github.com/axel-lauer)
- Replace underscores in facets of observational datasets with minuses ([Pull request #3840](https://github.com/ESMValGroup/ESMValTool/pull/3840)) by [@schlunma](https://github.com/schlunma)
- Add TropFlux CMORiser ([Pull request #3863](https://github.com/ESMValGroup/ESMValTool/pull/3863)) by [@rbeucher](https://github.com/rbeucher)
- CMORizer for ESACCI-SEAICE ([Pull request #3821](https://github.com/ESMValGroup/ESMValTool/pull/3821)) by [@axel-lauer](https://github.com/axel-lauer)
- Update ESACCI-SST cmorizer to v3.0 ([Pull request #3697](https://github.com/ESMValGroup/ESMValTool/pull/3697)) by [@LisaBock](https://github.com/LisaBock)
- Adding pr, tauu, tauv NOAA-CIRES-20CR-V2 CMORISER ([Pull request #3763](https://github.com/ESMValGroup/ESMValTool/pull/3763)) by [@max-anu](https://github.com/max-anu)
- Adding pr, tauu, tauv, tos to NCEP2 CMORISer ([Pull request #3765](https://github.com/ESMValGroup/ESMValTool/pull/3765)) by [@max-anu](https://github.com/max-anu)
- Adding a CMORiser for CMAP data for pr ([Pull request #3766](https://github.com/ESMValGroup/ESMValTool/pull/3766)) by [@max-anu](https://github.com/max-anu)
- Update NSIDC_G02202_sh CMORiser to add bounds for lat,lon and time ([Pull request #3744](https://github.com/ESMValGroup/ESMValTool/pull/3744)) by [@flicj191](https://github.com/flicj191)

### Automatic testing

- Remove obsolete utility esmvt_rose_wrapper and its documentation and very obsolete mip_convert cmorizer ([Pull request #3759](https://github.com/ESMValGroup/ESMValTool/pull/3759)) by [@valeriupredoi](https://github.com/valeriupredoi)
- Remove obsolete and inactive tests/system tests ([Pull request #3760](https://github.com/ESMValGroup/ESMValTool/pull/3760)) by [@valeriupredoi](https://github.com/valeriupredoi)
- Retire Mambaforge ([Pull request #3774](https://github.com/ESMValGroup/ESMValTool/pull/3774)) by [@valeriupredoi](https://github.com/valeriupredoi)
- Pin mamba<2 for conda-lock: solution by Ben Mares @maresb ([Pull request #3771](https://github.com/ESMValGroup/ESMValTool/pull/3771)) by [@valeriupredoi](https://github.com/valeriupredoi)
- Update comment in conda lock creation Github action ([Pull request #3788](https://github.com/ESMValGroup/ESMValTool/pull/3788)) by [@valeriupredoi](https://github.com/valeriupredoi)
- Run a periodic esmvalbot test via automated PR ([Pull request #3465](https://github.com/ESMValGroup/ESMValTool/pull/3465)) by [@valeriupredoi](https://github.com/valeriupredoi)
- Add init files in package-like diagnostic directories to comply with pytest >=8.3.4 ([Pull request #3834](https://github.com/ESMValGroup/ESMValTool/pull/3834)) by [@valeriupredoi](https://github.com/valeriupredoi)
- Fix failing sklearn test ([Pull request #3850](https://github.com/ESMValGroup/ESMValTool/pull/3850)) by [@schlunma](https://github.com/schlunma)
- Fix circle ci nightly test installation from source development mode (and test mode) that times out ([Pull request #3864](https://github.com/ESMValGroup/ESMValTool/pull/3864)) by [@valeriupredoi](https://github.com/valeriupredoi)
- Remove portrait plot test recipe ([Pull request #3871](https://github.com/ESMValGroup/ESMValTool/pull/3871)) by [@schlunma](https://github.com/schlunma)
- Restrict cron Github Actions tests to run from forks ([Pull request #3894](https://github.com/ESMValGroup/ESMValTool/pull/3894)) by [@valeriupredoi](https://github.com/valeriupredoi)
- Force mamba 2 in Github Actions that solve environment ([Pull request #3929](https://github.com/ESMValGroup/ESMValTool/pull/3929)) by [@valeriupredoi](https://github.com/valeriupredoi)
- Force install mamba2 in CircleCI and add ipython and pin it to <9.0 ([Pull request #3947](https://github.com/ESMValGroup/ESMValTool/pull/3947)) by [@valeriupredoi](https://github.com/valeriupredoi)
- Use mamba>=2 for Circle CI upstream development test  ([Pull request #3949](https://github.com/ESMValGroup/ESMValTool/pull/3949)) by [@valeriupredoi](https://github.com/valeriupredoi)

### Installation

- Retire support for Python 3.9 ([Pull request #3683](https://github.com/ESMValGroup/ESMValTool/pull/3683)) by [@valeriupredoi](https://github.com/valeriupredoi)
- [Julia] pin curl <8.10 to restrict libcurl <8.10 so Julia installs packages correctly ([Pull request #3755](https://github.com/ESMValGroup/ESMValTool/pull/3755)) by [@valeriupredoi](https://github.com/valeriupredoi)
- Add support for Python=3.12 ([Pull request #3501](https://github.com/ESMValGroup/ESMValTool/pull/3501)) by [@valeriupredoi](https://github.com/valeriupredoi)
- Pin cartopy to cartopy<0.24 ([Pull request #3768](https://github.com/ESMValGroup/ESMValTool/pull/3768)) by [@valeriupredoi](https://github.com/valeriupredoi)
- Pin pys2index >=0.1.5 in osx environment ([Pull request #3792](https://github.com/ESMValGroup/ESMValTool/pull/3792)) by [@valeriupredoi](https://github.com/valeriupredoi)
- Update environment: pin iris>=3.11, unpin cartopy and allow for numpy >=2 ([Pull request #3811](https://github.com/ESMValGroup/ESMValTool/pull/3811)) by [@valeriupredoi](https://github.com/valeriupredoi)
- Unpin pandas  ([Pull request #3924](https://github.com/ESMValGroup/ESMValTool/pull/3924)) by [@valeriupredoi](https://github.com/valeriupredoi)

### Improvements

- Update ERA5 renaming script for hourly ([Pull request #3630](https://github.com/ESMValGroup/ESMValTool/pull/3630)) by [@malininae](https://github.com/malininae)
- Avoid masking issues in Dask 2024.8.0 ([Pull request #3736](https://github.com/ESMValGroup/ESMValTool/pull/3736)) by [@bouweandela](https://github.com/bouweandela)
- Dark mode compatible transparent background logo ([Pull request #3751](https://github.com/ESMValGroup/ESMValTool/pull/3751)) by [@lukruh](https://github.com/lukruh)
- Change authors name ([Pull request #3806](https://github.com/ESMValGroup/ESMValTool/pull/3806)) by [@lukruh](https://github.com/lukruh)
- Recipe Test Workflow (RTW) prototype ([Pull request #3210](https://github.com/ESMValGroup/ESMValTool/pull/3210)) by [@ehogan](https://github.com/ehogan)
- Update obs4MIPs names to match ESGF see #2974 ([Pull request #3439](https://github.com/ESMValGroup/ESMValTool/pull/3439)) by [@rbeucher](https://github.com/rbeucher)
- Recipe_wenzel16jclim: Remove CERES-EBAF version to fix ESGF ([Pull request #3442](https://github.com/ESMValGroup/ESMValTool/pull/3442)) by [@rbeucher](https://github.com/rbeucher)
- Update RTW checks ([Pull request #3823](https://github.com/ESMValGroup/ESMValTool/pull/3823)) by [@ehogan](https://github.com/ehogan)
- Add cccma collaborators ([Pull request #3831](https://github.com/ESMValGroup/ESMValTool/pull/3831)) by [@malininae](https://github.com/malininae)
- Add DKRZ as a site to RTW ([Pull request #3837](https://github.com/ESMValGroup/ESMValTool/pull/3837)) by [@ehogan](https://github.com/ehogan)
- Add an option to disable using the distributed scheduler from the diagnostic script ([Pull request #3787](https://github.com/ESMValGroup/ESMValTool/pull/3787)) by [@bouweandela](https://github.com/bouweandela)
- Use site-specific lists of recipes in the RTW ([Pull request #3856](https://github.com/ESMValGroup/ESMValTool/pull/3856)) by [@chrisbillowsMO](https://github.com/chrisbillowsMO)
- Add links to summary page that are required for hosting at DKRZ ([Pull request #3866](https://github.com/ESMValGroup/ESMValTool/pull/3866)) by [@bouweandela](https://github.com/bouweandela)
- Add filename to list of ignored attributes in compare.py ([Pull request #3919](https://github.com/ESMValGroup/ESMValTool/pull/3919)) by [@sloosvel](https://github.com/sloosvel)
- Add unit conversion to DU to recipes that use toz ([Pull request #3784](https://github.com/ESMValGroup/ESMValTool/pull/3784)) by [@schlunma](https://github.com/schlunma)

<a id="changelog-v2-11-0"></a>

## v2.11.0

Highlights

- Two new recipes have been added:
  - Recipe [recipe_aod_aeronet_assess.yml](recipes/recipe_aod_aeronet_assess.html.md#recipe-aod-aeronet-assess)
    evaluates model aerosol optical depth (AOD) climatologies against ground
    based observations from the AeroNET measurement network.
  - Recipe [recipe_climate_patterns.yml](recipes/recipe_climate_patterns.html.md#recipes-climate-patterns)
    generates climate patterns from CMIP6 model datasets.
- The ESACCI-WATERVAPOUR CMORizer now includes daily data and uses the
  officially released CDR2 data.
- Support for 5 new datasets have been added:
  - AeroNET
  - ANU Climate 2.0 Australian data
  - Australian Gridded Climate Data(AGCD) precipitation
  - NOAA-ERSST
  - NSIDC-G02202-sh sea ice fraction
- NEW TREND: First time release manager shout-outs!
  - This is the first ESMValTool release managed by the Met Office! We want to
    shout this out - and for all future first time release managers to
    shout-out - to celebrate the growing, thriving ESMValTool community.

This release includes

### Bug fixes

- Recipe_ocean_quadmap: Update ATSR to match ESGF name ([Pull request #3443](https://github.com/ESMValGroup/ESMValTool/pull/3443)) by [@rbeucher](https://github.com/rbeucher)
- Fix recipe_bock20jgr_fig_8-10.yml ([Pull request #3665](https://github.com/ESMValGroup/ESMValTool/pull/3665)) by [@LisaBock](https://github.com/LisaBock)
- Update the list of datasets used in `recipe_easy_ipcc.yml` ([Pull request #3710](https://github.com/ESMValGroup/ESMValTool/pull/3710)) by [@bouweandela](https://github.com/bouweandela)

### Documentation

- Improve release tools and documentation ([Pull request #3462](https://github.com/ESMValGroup/ESMValTool/pull/3462)) by [@bouweandela](https://github.com/bouweandela)
- Fix a typo in the references file ([Pull request #3499](https://github.com/ESMValGroup/ESMValTool/pull/3499)) by [@bouweandela](https://github.com/bouweandela)
- Fix recipe path in `recipe_perfmetrics.rst` ([Pull request #3532](https://github.com/ESMValGroup/ESMValTool/pull/3532)) by [@TomasTorsvik](https://github.com/TomasTorsvik)
- Improved description of model evaluation recipes ([Pull request #3541](https://github.com/ESMValGroup/ESMValTool/pull/3541)) by [@schlunma](https://github.com/schlunma)
- Remove double word in cmorizer documentation ([Pull request #3553](https://github.com/ESMValGroup/ESMValTool/pull/3553)) by [@bettina-gier](https://github.com/bettina-gier)
- Fix Codacy badge ([Pull request #3558](https://github.com/ESMValGroup/ESMValTool/pull/3558)) by [@bouweandela](https://github.com/bouweandela)
- Update the release schedule for v2.11.0 ([Pull request #3573](https://github.com/ESMValGroup/ESMValTool/pull/3573)) by [@ehogan](https://github.com/ehogan)
- Improve the formatting of the recipe documentation template ([Pull request #3652](https://github.com/ESMValGroup/ESMValTool/pull/3652)) by [@mo-gill](https://github.com/mo-gill)
- Add introduction material on the main documentation page ([Pull request #3628](https://github.com/ESMValGroup/ESMValTool/pull/3628)) by [@bouweandela](https://github.com/bouweandela)
- Avoid warning in documentation build ([Pull request #3675](https://github.com/ESMValGroup/ESMValTool/pull/3675)) by [@bouweandela](https://github.com/bouweandela)
- Update the list of broken recipes for `v2.11.0` ([Pull request #3706](https://github.com/ESMValGroup/ESMValTool/pull/3706)) by [@ehogan](https://github.com/ehogan)

### Diagnostics

- `monitor/multi_dataset.py` improvements: allow data w/o `timerange` and improve text formatting ([Pull request #3528](https://github.com/ESMValGroup/ESMValTool/pull/3528)) by [@schlunma](https://github.com/schlunma)
- Allow datasets without `project` in multi_datasets.py ([Pull request #3552](https://github.com/ESMValGroup/ESMValTool/pull/3552)) by [@schlunma](https://github.com/schlunma)
- Prevent overlapping time axis tick labels in monitoring recipe ([Pull request #3682](https://github.com/ESMValGroup/ESMValTool/pull/3682)) by [@schlunma](https://github.com/schlunma)

### New recipe

- Add support for aerosol optical depth climatology metrics to the AutoAssess replacement ([Pull request #3048](https://github.com/ESMValGroup/ESMValTool/pull/3048)) by [@catherinehardacre](https://github.com/catherinehardacre)
- CMIP6 climate patterns  ([Pull request #2785](https://github.com/ESMValGroup/ESMValTool/pull/2785)) by [@mo-gregmunday](https://github.com/mo-gregmunday)

### Observational and re-analysis dataset support

- Add cmorizer scripts for NOAA-ERSST. ([Pull request #1799](https://github.com/ESMValGroup/ESMValTool/pull/1799)) by [@bjoernbroetz](https://github.com/bjoernbroetz)
- Update OceanSODA-ETHZ CMORizer with new source file ([Pull request #3535](https://github.com/ESMValGroup/ESMValTool/pull/3535)) by [@TomasTorsvik](https://github.com/TomasTorsvik)
- Add CMORizer script for NSIDC-G02202-sh sea ice fraction ([Pull request #3512](https://github.com/ESMValGroup/ESMValTool/pull/3512)) by [@flicj191](https://github.com/flicj191)
- CMORizer Australian Gridded Climate Data(AGCD) precipitation ([Pull request #3445](https://github.com/ESMValGroup/ESMValTool/pull/3445)) by [@flicj191](https://github.com/flicj191)
- Extend CMORizer NCEP-DOE-R2 ([Pull request #3469](https://github.com/ESMValGroup/ESMValTool/pull/3469)) by [@axel-lauer](https://github.com/axel-lauer)
- Add comment to recipe_lauer13jclim regarding UWisc being superseded by MAC-LWP ([Pull request #3537](https://github.com/ESMValGroup/ESMValTool/pull/3537)) by [@rbeucher](https://github.com/rbeucher)
- Recipe_autoassess_landsurface_surfrad: Remove CERES-EBAF version to fix ESGF search ([Pull request #3438](https://github.com/ESMValGroup/ESMValTool/pull/3438)) by [@rbeucher](https://github.com/rbeucher)
- Updating ESACCI-WATERVAPOUR cmorizer ([Pull request #3282](https://github.com/ESMValGroup/ESMValTool/pull/3282)) by [@malininae](https://github.com/malininae)
- CMORiser for ANU Climate 2.0 Australian data ([Pull request #3511](https://github.com/ESMValGroup/ESMValTool/pull/3511)) by [@flicj191](https://github.com/flicj191)
- Add AERONET cmorizer ([Pull request #3227](https://github.com/ESMValGroup/ESMValTool/pull/3227)) by [@zklaus](https://github.com/zklaus)
- Update CRU CMORizer ([Pull request #3381](https://github.com/ESMValGroup/ESMValTool/pull/3381)) by [@lukruh](https://github.com/lukruh)
- Fix recipe_check_obs to be aligned with DKRZ ([Pull request #3673](https://github.com/ESMValGroup/ESMValTool/pull/3673)) by [@LisaBock](https://github.com/LisaBock)
- Update AERONET data version ([Pull request #3692](https://github.com/ESMValGroup/ESMValTool/pull/3692)) by [@ehogan](https://github.com/ehogan)

### Automatic testing

- Move code into function in batch job generation script ([Pull request #3491](https://github.com/ESMValGroup/ESMValTool/pull/3491)) by [@bouweandela](https://github.com/bouweandela)
- Fix sklearn tests ([Pull request #3506](https://github.com/ESMValGroup/ESMValTool/pull/3506)) by [@schlunma](https://github.com/schlunma)
- Pinned sklearn>=1.4.0 ([Pull request #3508](https://github.com/ESMValGroup/ESMValTool/pull/3508)) by [@schlunma](https://github.com/schlunma)
- Update sklearn tests to be compatible with current pytest version (pytest >=8.0.0) ([Pull request #3517](https://github.com/ESMValGroup/ESMValTool/pull/3517)) by [@schlunma](https://github.com/schlunma)
- Update sklearn tests to be compatible with current pytest version (pytest >=8.0.0) Part 2 ([Pull request #3518](https://github.com/ESMValGroup/ESMValTool/pull/3518)) by [@schlunma](https://github.com/schlunma)
- [Circle/CI]Fix test_installation_from_conda Circle CI tests ([Pull request #3538](https://github.com/ESMValGroup/ESMValTool/pull/3538)) by [@valeriupredoi](https://github.com/valeriupredoi)
- [Github Actions] install git in OSX and add environment inspection ([Pull request #3581](https://github.com/ESMValGroup/ESMValTool/pull/3581)) by [@valeriupredoi](https://github.com/valeriupredoi)
- [CI Github Actions] Update (outdated) actions versions that produce Node.js warnings ([Pull request #3586](https://github.com/ESMValGroup/ESMValTool/pull/3586)) by [@valeriupredoi](https://github.com/valeriupredoi)
- Fix `flake8==7` linting issues ([Pull request #3634](https://github.com/ESMValGroup/ESMValTool/pull/3634)) by [@valeriupredoi](https://github.com/valeriupredoi)
- Use `importlib` as the import mode for `pytest` ([Pull request #3672](https://github.com/ESMValGroup/ESMValTool/pull/3672)) by [@ehogan](https://github.com/ehogan)

### Installation

- Update dependencies ([Pull request #3487](https://github.com/ESMValGroup/ESMValTool/pull/3487)) by [@bouweandela](https://github.com/bouweandela)
- Merge v2.10.x into main ([Pull request #3489](https://github.com/ESMValGroup/ESMValTool/pull/3489)) by [@schlunma](https://github.com/schlunma)
- Add imagehash package as an ESMValTool dependency ([Pull request #3557](https://github.com/ESMValGroup/ESMValTool/pull/3557)) by [@alistairsellar](https://github.com/alistairsellar)
- Unpin `r-akima` ([Pull request #3564](https://github.com/ESMValGroup/ESMValTool/pull/3564)) by [@valeriupredoi](https://github.com/valeriupredoi)
- Adding pys2index dependency ([Pull request #3577](https://github.com/ESMValGroup/ESMValTool/pull/3577)) by [@ljoakim](https://github.com/ljoakim)
- Pin esmpy <8.6.0 ([Pull request #3585](https://github.com/ESMValGroup/ESMValTool/pull/3585)) by [@valeriupredoi](https://github.com/valeriupredoi)
- Pin R <4.3.0 ([Pull request #3689](https://github.com/ESMValGroup/ESMValTool/pull/3689)) by [@ehogan](https://github.com/ehogan)
- Pin importlib_metadata <8 ([Pull request #3700](https://github.com/ESMValGroup/ESMValTool/pull/3700)) by [@ehogan](https://github.com/ehogan)
- Pin matplotlib <3.9.0 on ESMValTool release branch ([Pull request #3712](https://github.com/ESMValGroup/ESMValTool/pull/3712)) by [@ehogan](https://github.com/ehogan)

### Dependency updates

- Fix for `recipe_seaice_drift.yml`: fix CRS transformer for “North Pole Stereographic” ([Pull request #3531](https://github.com/ESMValGroup/ESMValTool/pull/3531)) by [@flicj191](https://github.com/flicj191)
- Fixed attribute handling in austral_jet/main.ncl for iris>=3.8 ([Pull request #3603](https://github.com/ESMValGroup/ESMValTool/pull/3603)) by [@schlunma](https://github.com/schlunma)
- Fixed attribute handling in emergent constraint diagnostic for iris>=3.8 ([Pull request #3605](https://github.com/ESMValGroup/ESMValTool/pull/3605)) by [@schlunma](https://github.com/schlunma)
- Update the name of the remapcon2 operator in R recipes ([Pull request #3611](https://github.com/ESMValGroup/ESMValTool/pull/3611)) by [@ehogan](https://github.com/ehogan)
- Use `iris.FUTURE.save_split_attrs = True` to remove iris warning in many diagnostics ([Pull request #3651](https://github.com/ESMValGroup/ESMValTool/pull/3651)) by [@schlunma](https://github.com/schlunma)
- Avoid concatenation error in recipe_pcrglobwb.yml ([Pull request #3645](https://github.com/ESMValGroup/ESMValTool/pull/3645)) by [@bouweandela](https://github.com/bouweandela)
- Update scipy.integrate.simps import ([Pull request #3704](https://github.com/ESMValGroup/ESMValTool/pull/3704)) by [@ehogan](https://github.com/ehogan)

### Improvements

- Add native6, OBS6 and RAWOBS rootpaths to metoffice template in config-user-example.yml and remove temporary dir ([Pull request #3613](https://github.com/ESMValGroup/ESMValTool/pull/3613)) by [@alistairsellar](https://github.com/alistairsellar)

<a id="changelog-v2-10-0"></a>

## v2.10.0

Highlights

- Add a realistic IPCC example recipe that reproduces figure 9.3 from AR6. It
  computes the mean sea-surface temperature anomaly between 1850-2100 over all
  available CMIP6 models. See the [recipe documentation](recipes/recipe_examples.html.md#recipe-examples)
  or read the [blog post](https://blog.esciencecenter.nl/easy-ipcc-powered-by-esmvalcore-19a0b6366ea7)
  for more information.
- Added more plot types to monitoring diagnostic: Hovmoeller Z vs. time,
  Hovmoeller time vs latlon, variable vs. latitude are now available. See the
  [recipe documentation](recipes/recipe_monitor.html.md#recipe-monitor) for more information.
- Add support for 4 new datasets:
  - NOAA-CIRES-20CR v3 reanalysis
  - NASA MERRA reanalysis
  - NOAA marine boundary layer data for CH4
  - MOBO-DIC2004-2019

  See [Supported datasets for which a CMORizer script is available](input.html.md#supported-datasets) and [Observations](input.html.md#inputdata-observations) for more
  information.
- Many recipes now have up-to-date obs4MIPs dataset names so required data can
  automatically be downloaded from ESGF.

This release includes

### Bug fixes

- Update recipe shapeselect to work with shapely v2 ([Pull request #3283](https://github.com/ESMValGroup/ESMValTool/pull/3283)) [@lukruh](https://github.com/lukruh)
- Correctly handle `~` when reading `plot_folder` option of monitoring diagnostic ([Pull request #3449](https://github.com/ESMValGroup/ESMValTool/pull/3449)) [@schlunma](https://github.com/schlunma)
- Fixed provenance tracking for NCL multipanel PNGs ([Pull request #3332](https://github.com/ESMValGroup/ESMValTool/pull/3332)) [@schlunma](https://github.com/schlunma)
- Fixed plot paths in NCL provenance tracking ([Pull request #3422](https://github.com/ESMValGroup/ESMValTool/pull/3422)) [@schlunma](https://github.com/schlunma)
- Fix erroneous file_type handling in certain NCL diagnostics ([Pull request #3474](https://github.com/ESMValGroup/ESMValTool/pull/3474)) [@zklaus](https://github.com/zklaus)
- Fix NCL provenance tracking ([Pull request #3477](https://github.com/ESMValGroup/ESMValTool/pull/3477)) [@schlunma](https://github.com/schlunma)
- Fix plots and provenance in Russell diagnostics ([Pull request #3479](https://github.com/ESMValGroup/ESMValTool/pull/3479)) [@schlunma](https://github.com/schlunma)

### Documentation

- Add merge instructions to release instructions ([Pull request #3292](https://github.com/ESMValGroup/ESMValTool/pull/3292)) [@remi-kazeroni](https://github.com/remi-kazeroni)
- Update release schedule after release of v2.9.0 ([Pull request #3289](https://github.com/ESMValGroup/ESMValTool/pull/3289)) [@remi-kazeroni](https://github.com/remi-kazeroni)
- Add list of failing recipes for v2.9.0 release ([Pull request #3294](https://github.com/ESMValGroup/ESMValTool/pull/3294)) [@remi-kazeroni](https://github.com/remi-kazeroni)
- Update `mamba` version in readthedocs configuration docs builds ([Pull request #3310](https://github.com/ESMValGroup/ESMValTool/pull/3310)) [@valeriupredoi](https://github.com/valeriupredoi)
- Add Romain Beucher to citation file as contributor ([Pull request #3318](https://github.com/ESMValGroup/ESMValTool/pull/3318)) [@valeriupredoi](https://github.com/valeriupredoi)
- Removed recipe_carvalhais14nat from list of broken recipes ([Pull request #3319](https://github.com/ESMValGroup/ESMValTool/pull/3319)) [@remi-kazeroni](https://github.com/remi-kazeroni)
- Add [OBS-maintainers](https://github.com/orgs/ESMValGroup/teams/obs-maintainers) team to documentation on OBS data maintenance and CMORizer reviews ([Pull request #3335](https://github.com/ESMValGroup/ESMValTool/pull/3335)) [@remi-kazeroni](https://github.com/remi-kazeroni)
- Add Pauline Bonnet to citation file ([Pull request #3347](https://github.com/ESMValGroup/ESMValTool/pull/3347)) [@Paulinebonnet111](https://github.com/Paulinebonnet111)
- Ensure compatible zstandard and zstd in readthedocs builds ([Pull request #3362](https://github.com/ESMValGroup/ESMValTool/pull/3362)) [@zklaus](https://github.com/zklaus)
- Fix documentation build ([Pull request #3397](https://github.com/ESMValGroup/ESMValTool/pull/3397)) [@bouweandela](https://github.com/bouweandela)
- Minor updates to release tools ([Pull request #3216](https://github.com/ESMValGroup/ESMValTool/pull/3216)) [@bouweandela](https://github.com/bouweandela)
- Enhance provenance documentation ([Pull request #3305](https://github.com/ESMValGroup/ESMValTool/pull/3305)) [@alistairsellar](https://github.com/alistairsellar)
- Re-add communities and grants in zenodo file ([Pull request #3416](https://github.com/ESMValGroup/ESMValTool/pull/3416)) [@valeriupredoi](https://github.com/valeriupredoi)
- Update Anconda badge in README ([Pull request #3375](https://github.com/ESMValGroup/ESMValTool/pull/3375), [Pull request #3453](https://github.com/ESMValGroup/ESMValTool/pull/3453)) [@valeriupredoi](https://github.com/valeriupredoi)

### Diagnostics

- Slight refactoring of diagnostic script `galytska23/select_variables_for_tigramite.py` for generality and portability ([Pull request #3298](https://github.com/ESMValGroup/ESMValTool/pull/3298)) [@valeriupredoi](https://github.com/valeriupredoi) and [@egalytska](https://github.com/egalytska)
- Allow custom variable grouping in diagnostic script `monitor/multi_datasets.py` ([Pull request #3343](https://github.com/ESMValGroup/ESMValTool/pull/3343)) [@schlunma](https://github.com/schlunma)
- Extended monitor diagnostic with plot type variable vs. latitude ([Pull request #3340](https://github.com/ESMValGroup/ESMValTool/pull/3340)) [@ellensarauer](https://github.com/ellensarauer)
- Add Hovmoeller Z vs. time plot to monitoring diagnostic ([Pull request #3345](https://github.com/ESMValGroup/ESMValTool/pull/3345)) [@cubeme](https://github.com/cubeme) and [@helgehr](https://github.com/helgehr)
- Adding Hovmoeller time vs latlon plots to monitoring recipes ([Pull request #3341](https://github.com/ESMValGroup/ESMValTool/pull/3341)) [@lukruh](https://github.com/lukruh) and [@jeremykraftdlr](https://github.com/jeremykraftdlr)
- Implied heat transport new diagnostic ([Pull request #3177](https://github.com/ESMValGroup/ESMValTool/pull/3177)) [@mo-abodas](https://github.com/mo-abodas)
- Recipe changes for new statistics preprocessors (percentiles) ([Pull request #3351](https://github.com/ESMValGroup/ESMValTool/pull/3351)) [@schlunma](https://github.com/schlunma)
- Add a realistic example recipe ([Pull request #3356](https://github.com/ESMValGroup/ESMValTool/pull/3356)) [@Peter9191](https://github.com/Peter9191) and [@bouweandela](https://github.com/bouweandela)
- Support `CenteredNorm` in diagnostic monitor/multidatasets.py ([Pull request #3415](https://github.com/ESMValGroup/ESMValTool/pull/3415)) [@schlunma](https://github.com/schlunma)
- Use new preprocessor statistics calling convention for recipe_easy_ipcc.yml ([Pull request #3418](https://github.com/ESMValGroup/ESMValTool/pull/3418)) [@bouweandela](https://github.com/bouweandela)
- Adapt to changed style scheme name in matplotlib ([Pull request #3475](https://github.com/ESMValGroup/ESMValTool/pull/3475)) [@zklaus](https://github.com/zklaus)
- Add version to dataset in python example recipe to avoid “Unknown file format” issue on JASMIN ([Pull request #3322](https://github.com/ESMValGroup/ESMValTool/pull/3322)) [@ehogan](https://github.com/ehogan)
- Add the dataset version in the heatwaves_coldwaves recipe to avoid the “Unknown file format” issue on JASMIN ([Pull request #3373](https://github.com/ESMValGroup/ESMValTool/pull/3373)) [@ehogan](https://github.com/ehogan)

### Observational and re-analysis dataset support

- Cmorizer for NOAA-CIRES-20CR v3 reanalysis (clt, clwvi, hus, prw, rlut, rlutcs, rsut, rsutcs) ([Pull request #3137](https://github.com/ESMValGroup/ESMValTool/pull/3137)) [@LisaBock](https://github.com/LisaBock)
- CMORizer for NASA MERRA reanalysis ([Pull request #3039](https://github.com/ESMValGroup/ESMValTool/pull/3039)) [@axel-lauer](https://github.com/axel-lauer)
- Download and formatting of NOAA marine boundary layer data for CH4 (NOAA-MBL-CH4) ([Pull request #3301](https://github.com/ESMValGroup/ESMValTool/pull/3301)) [@FranziskaWinterstein](https://github.com/FranziskaWinterstein)
- Added CMORizer for MOBO-DIC2004-2019 ([Pull request #3297](https://github.com/ESMValGroup/ESMValTool/pull/3297)) [@schlunma](https://github.com/schlunma)
- Update obs4MIPs dataset names in quantilebias recipe ([Pull request #3330](https://github.com/ESMValGroup/ESMValTool/pull/3330)) [@rbeucher](https://github.com/rbeucher)
- Update obs4MIPs dataset names in Schlund20esd recipe ([Pull request #3329](https://github.com/ESMValGroup/ESMValTool/pull/3329)) [@rbeucher](https://github.com/rbeucher)
- Update obs4MIPs dataset names in flatoipcc recipes ([Pull request #3328](https://github.com/ESMValGroup/ESMValTool/pull/3328)) [@rbeucher](https://github.com/rbeucher)
- Update obs4mips dataset names in clouds recipes ([Pull request #3326](https://github.com/ESMValGroup/ESMValTool/pull/3326)) [@rbeucher](https://github.com/rbeucher)
- Update Obs4MIPs dataset names in ECS recipes ([Pull request #3327](https://github.com/ESMValGroup/ESMValTool/pull/3327)) [@rbeucher](https://github.com/rbeucher)
- Update obs4mips dataset names in Bock et al recipes ([Pull request #3324](https://github.com/ESMValGroup/ESMValTool/pull/3324), [Pull request #3389](https://github.com/ESMValGroup/ESMValTool/pull/3389) and [Pull request #3473](https://github.com/ESMValGroup/ESMValTool/pull/3473)) [@rbeucher](https://github.com/rbeucher) and [@bouweandela](https://github.com/bouweandela)
- Update obs4mips dataset names in radiation budget recipe ([Pull request #3323](https://github.com/ESMValGroup/ESMValTool/pull/3323)) [@rbeucher](https://github.com/rbeucher)
- Update Obs4MIPs dataset names in perfmetrics CMIP5 recipe ([Pull request #3325](https://github.com/ESMValGroup/ESMValTool/pull/3325)) [@rbeucher](https://github.com/rbeucher)

### Automatic testing

- Made sklearn test backwards-compatible with sklearn < 1.3 ([Pull request #3285](https://github.com/ESMValGroup/ESMValTool/pull/3285)) [@schlunma](https://github.com/schlunma)
- Update conda lock creation Github Action workflow and ship updated conda-lock file ([Pull request #3307](https://github.com/ESMValGroup/ESMValTool/pull/3307), [Pull request #3407](https://github.com/ESMValGroup/ESMValTool/pull/3407)) [@valeriupredoi](https://github.com/valeriupredoi)
- Compress all bash shell setters into one default option per GitHub Action workflow ([Pull request #3315](https://github.com/ESMValGroup/ESMValTool/pull/3315)) [@valeriupredoi](https://github.com/valeriupredoi)
- Remove deprecated option `offline` from CI configuration ([Pull request #3367](https://github.com/ESMValGroup/ESMValTool/pull/3367)) [@schlunma](https://github.com/schlunma)

### Installation

- Use ESMValCore v2.10 ([Pull request #3486](https://github.com/ESMValGroup/ESMValTool/pull/3486)) [@bouweandela](https://github.com/bouweandela)

### Improvements

- Merge v2.9.x into main  ([Pull request #3286](https://github.com/ESMValGroup/ESMValTool/pull/3286)) [@schlunma](https://github.com/schlunma)
- Allow NCL unit conversion kg s-1 -> GtC y-1 ([Pull request #3300](https://github.com/ESMValGroup/ESMValTool/pull/3300)) [@schlunma](https://github.com/schlunma)

<a id="changelog-v2-9-0"></a>

## v2.9.0

### Highlights

- A new [diagnostic](api/esmvaltool.diag_scripts.seaborn_diag.html.md#api-esmvaltool-diag-scripts-seaborn-diag) has been
  added to provide a high-level interface to
  [seaborn](https://seaborn.pydata.org/),
  a Python data visualization library based on
  [matplotlib](https://matplotlib.org/).
  See the [recipe documentation](recipes/recipe_seaborn.html.md#recipes-seaborn-diag) for more
  information.
- We have included a new recipe and diagnostic that represent the major
  physical processes that describe Arctic-midlatitude teleconnections and
  provide the basis for the CMIP6 model evaluation for the further application
  of causal discovery.
  The results are discussed in the article
  [“Causal model evaluation of Arctic-midlatitude teleconnections in CMIP6”](https://doi.org/10.1002/essoar.10512569.1)
  by Galytska et al. (in review in Journal of Geophysical Research: Atmospheres).
- It is now possible to use the
  [Dask distributed scheduler](https://docs.dask.org/en/latest/deploying.html),
  which can
  [significantly reduce the run-time of recipes](https://github.com/ESMValGroup/ESMValCore/pull/2049#pullrequestreview-1446279391).
  Configuration examples and advice are available in the
  [ESMValCore documentation](https://docs.esmvaltool.org/projects/ESMValCore/en/latest/quickstart/configure.html#config-dask).
  If configured, the Dask distributed scheduler will also be used by diagnostic
  scripts written in Python, so make sure to use
  [lazy data](https://scitools-iris.readthedocs.io/en/latest/userguide/real_and_lazy_data.html#real-and-lazy-data)
  wherever it is possible in your (new) diagnostics.
  More work on improving the computational performance is planned, so please
  share your experiences, good and bad, with this new feature in
  [ESMValGroup/ESMValCore#1763](https://github.com/ESMValGroup/ESMValCore/discussions/1763).

This release includes

### Bug fixes

- Fixed usage of `work_dir` in some CMORizer scripts ([Pull request #3192](https://github.com/ESMValGroup/ESMValTool/pull/3192)) [@remi-kazeroni](https://github.com/remi-kazeroni)
- Realize data for scalar cube in recipe_carvalhais14nat to avert issue from dask latest (2023.6.0) ([Pull request #3265](https://github.com/ESMValGroup/ESMValTool/pull/3265)) [@valeriupredoi](https://github.com/valeriupredoi)
- Fix failing `mlr` diagnostic test by adding new scikit-learn default tag ([Pull request #3273](https://github.com/ESMValGroup/ESMValTool/pull/3273)) [@remi-kazeroni](https://github.com/remi-kazeroni)
- Fix ordering of models in perfmetrics diagnostic script ([Pull request #3275](https://github.com/ESMValGroup/ESMValTool/pull/3275)) [@LisaBock](https://github.com/LisaBock)

### Documentation

- Update release schedule after v2.8.0 ([Pull request #3138](https://github.com/ESMValGroup/ESMValTool/pull/3138)) [@remi-kazeroni](https://github.com/remi-kazeroni)
- Added reference entry for Winterstein ([Pull request #3154](https://github.com/ESMValGroup/ESMValTool/pull/3154)) [@FranziskaWinterstein](https://github.com/FranziskaWinterstein)
- Show logo on PyPI ([Pull request #3185](https://github.com/ESMValGroup/ESMValTool/pull/3185)) [@valeriupredoi](https://github.com/valeriupredoi)
- Add Release Managers for v2.9.0 and v2.10.0 ([Pull request #3184](https://github.com/ESMValGroup/ESMValTool/pull/3184)) [@remi-kazeroni](https://github.com/remi-kazeroni)
- Fix readthedocs build with esmpy>=8.4.0 and missing ESMFMKFILE variable ([Pull request #3205](https://github.com/ESMValGroup/ESMValTool/pull/3205)) [@valeriupredoi](https://github.com/valeriupredoi)
- Add ESMValCore release v2.8.1 into the documentation ([Pull request #3235](https://github.com/ESMValGroup/ESMValTool/pull/3235)) [@remi-kazeroni](https://github.com/remi-kazeroni)
- Modified links to the tutorial ([Pull request #3236](https://github.com/ESMValGroup/ESMValTool/pull/3236)) [@remi-kazeroni](https://github.com/remi-kazeroni)
- Fix gitter badge in README ([Pull request #3258](https://github.com/ESMValGroup/ESMValTool/pull/3258)) [@remi-kazeroni](https://github.com/remi-kazeroni)
- Add release notes for v2.9.0 ([Pull request #3266](https://github.com/ESMValGroup/ESMValTool/pull/3266)) [@bouweandela](https://github.com/bouweandela)

### Diagnostics

- New plot_type 1d_profile in monitor  ([Pull request #3178](https://github.com/ESMValGroup/ESMValTool/pull/3178)) [@FranziskaWinterstein](https://github.com/FranziskaWinterstein)
- Add Seaborn diagnostic ([Pull request #3155](https://github.com/ESMValGroup/ESMValTool/pull/3155)) [@schlunma](https://github.com/schlunma)
- New recipe and diagnostic for Arctic-midlatitude research ([Pull request #3021](https://github.com/ESMValGroup/ESMValTool/pull/3021)) [@egalytska](https://github.com/egalytska)
- Generate climatology on the fly for AutoAssess soil moisture ([Pull request #3197](https://github.com/ESMValGroup/ESMValTool/pull/3197)) [@alistairsellar](https://github.com/alistairsellar)
- Remove “fx_variables” from recipe_tebaldi21esd.yml ([Pull request #3211](https://github.com/ESMValGroup/ESMValTool/pull/3211)) [@hb326](https://github.com/hb326)
- Remove “fx_variables” from ipccwg1ar5ch9 recipes ([Pull request #3215](https://github.com/ESMValGroup/ESMValTool/pull/3215)) [@katjaweigel](https://github.com/katjaweigel)
- Remove “fx_variables” from recipe_wenzel14jgr.yml ([Pull request #3212](https://github.com/ESMValGroup/ESMValTool/pull/3212)) [@hb326](https://github.com/hb326)
- Update obs4MIPs dataset to the current naming scheme in recipe_smpi.yml ([Pull request #2991](https://github.com/ESMValGroup/ESMValTool/pull/2991)) [@bouweandela](https://github.com/bouweandela)
- Fixed pandas diagnostics for pandas>=2.0.0 ([Pull request #3209](https://github.com/ESMValGroup/ESMValTool/pull/3209)) [@schlunma](https://github.com/schlunma)
- Update recipe_impact.yml to work with newer versions of pandas ([Pull request #3220](https://github.com/ESMValGroup/ESMValTool/pull/3220)) [@bouweandela](https://github.com/bouweandela)
- Add variable long names to provenance record in monitoring diagnostics ([Pull request #3222](https://github.com/ESMValGroup/ESMValTool/pull/3222)) [@bsolino](https://github.com/bsolino)

### Observational and re-analysis dataset support

- Add CMORizer for GPCP-SG (pr) ([Pull request #3150](https://github.com/ESMValGroup/ESMValTool/pull/3150)) [@FranziskaWinterstein](https://github.com/FranziskaWinterstein)
- Extension of NASA MERRA2 CMORizer (cl, cli, clivi, clw, clwvi) ([Pull request #3167](https://github.com/ESMValGroup/ESMValTool/pull/3167)) [@axel-lauer](https://github.com/axel-lauer)

### Automatic testing

- Add a CircleCI-testing-specific `recipe_python_for_CI.yml` to avoid calling geolocator/Nominatim over CI ([Pull request #3159](https://github.com/ESMValGroup/ESMValTool/pull/3159)) [@valeriupredoi](https://github.com/valeriupredoi)
- Check if Python minor version changed after Julia install in development installation test ([Pull request #3213](https://github.com/ESMValGroup/ESMValTool/pull/3213)) [@valeriupredoi](https://github.com/valeriupredoi)
- Fix tests using deprecated `esmvalcore._config` module that has been removed in ESMValCore v2.9 ([Pull request #3204](https://github.com/ESMValGroup/ESMValTool/pull/3204)) [@valeriupredoi](https://github.com/valeriupredoi)

### Installation

- Add support for Python=3.11 ([Pull request #3173](https://github.com/ESMValGroup/ESMValTool/pull/3173)) [@valeriupredoi](https://github.com/valeriupredoi)
- Drop python=3.8 support ([Pull request #3193](https://github.com/ESMValGroup/ESMValTool/pull/3193)) [@valeriupredoi](https://github.com/valeriupredoi)
- Repair generation of conda lock files ([Pull request #3148](https://github.com/ESMValGroup/ESMValTool/pull/3148)) [@valeriupredoi](https://github.com/valeriupredoi)
- Modernize lock creation script and repair lock generation ([Pull request #3174](https://github.com/ESMValGroup/ESMValTool/pull/3174)) [@valeriupredoi](https://github.com/valeriupredoi)
- Pin numpy !=1.24.3 due to severe masking bug ([Pull request #3182](https://github.com/ESMValGroup/ESMValTool/pull/3182)) [@valeriupredoi](https://github.com/valeriupredoi)
- Update xesmf to versions >= 0.4.0 ([Pull request #2728](https://github.com/ESMValGroup/ESMValTool/pull/2728)) [@zklaus](https://github.com/zklaus)
- Update esmpy import for ESMF version 8.4.0 or larger ([Pull request #3188](https://github.com/ESMValGroup/ESMValTool/pull/3188)) [@valeriupredoi](https://github.com/valeriupredoi)
- Relax the pin on iris to allow the use of older versions for performance reasons ([Pull request #3270](https://github.com/ESMValGroup/ESMValTool/pull/3270)) [@bouweandela](https://github.com/bouweandela)
- Use ESMValCore v2.9.0 ([Pull request #3274](https://github.com/ESMValGroup/ESMValTool/pull/3274)) [@bouweandela](https://github.com/bouweandela)

### Improvements

- Update pre-commit hooks ([Pull request #3189](https://github.com/ESMValGroup/ESMValTool/pull/3189)) [@bouweandela](https://github.com/bouweandela)
- Add support for using a dask distributed scheduler ([Pull request #3151](https://github.com/ESMValGroup/ESMValTool/pull/3151)) [@bouweandela](https://github.com/bouweandela)

<a id="changelog-v2-8-0"></a>

## v2.8.0

### Highlights

- This release includes the diagnostics for reproducing figures 3.9, 3.19,
  3.42 and 3.43 of the IPCC AR6 WG1 report.
  See [recipe documentation](recipes/recipe_ipccwg1ar6ch3.html.md#recipes-ipccwg1ar6ch3) about added recipes.
- A new set of recipes and diagnostics has been included to evaluate cloud
  climatologies from CMIP models as used in [Lauer et al. (2023), J. Climate](https://doi.org/10.1175/JCLI-D-22-0181.1).
  See [recipe documentation](recipes/recipe_clouds.html.md#recipes-clouds) about added recipes.
- Addition of a set of recipes for extreme events, regional and impact
  evaluation as used in [Weigel et al. (2021), GMD](https://doi.org/10.5194/gmd-14-3159-2021) and in IPCC AR5.
  See [recipe documentation](recipes/recipe_ipccwg1ar5ch9.html.md#recipes-ipccwg1ar5ch9) about added recipes.

Highlights from ESMValCore v2.8.0 [here](https://docs.esmvaltool.org/projects/ESMValCore/en/latest/changelog.html#changelog-v2-8-0):

- ESMValCore now supports wildcards in recipes and offers improved support
  for ancillary variables and dataset versioning.
- Support for CORDEX datasets in a rotated pole coordinate system has been added.
- Native [ICON](https://docs.esmvaltool.org/projects/ESMValCore/en/latest/quickstart/find_data.html#read-icon) output is now made UGRID-compliant
  on-the-fly.
- The Python API has been extended with the addition of three modules:
  [`esmvalcore.config`](https://docs.esmvaltool.org/projects/ESMValCore/en/latest/api/esmvalcore.config.html#module-esmvalcore.config), [`esmvalcore.dataset`](https://docs.esmvaltool.org/projects/ESMValCore/en/latest/api/esmvalcore.dataset.html#module-esmvalcore.dataset), and
  `esmvalcore.local`
- The preprocessor [`multi_model_statistics()`](https://docs.esmvaltool.org/projects/ESMValCore/en/latest/api/esmvalcore.preprocessor.html#esmvalcore.preprocessor.multi_model_statistics)
  has been extended to support more use-cases.

This release includes:

### Backwards incompatible changes

Please read the descriptions of the linked pull requests for detailed upgrade instructions.

- Deprecated features scheduled for removal in v2.8.0 or earlier have now been removed
  ([Pull request #2941](https://github.com/ESMValGroup/ESMValTool/pull/2941))
  [@schlunma](https://github.com/schlunma).
  Removed `esmvaltool.iris_helpers.var_name_constraint` (has been deprecated
  in v2.6.0; please use [`iris.NameConstraint`](https://scitools-iris.readthedocs.io/en/latest/generated/api/iris.html#iris.NameConstraint) with the keyword argument
  `var_name` instead).
  Removed write_netcdf and write_plots from recipe_filer.py.
- No files from the `native6` project will be found if a non-existent version
  of a dataset is specified ([#3041](https://github.com/ESMValGroup/ESMValTool/pull/3041))
  [@remi-kazeroni](https://github.com/remi-kazeroni).
  The tool now searches for exact `version` of `native6` datasets.
  Therefore, it is necessary to make sure that the version number in the
  directory tree matches with the version number in the recipe to find the files.
- The conversion of precipitation units from monitoring diagnostic is now done
  at the preprocessor stage
  ([#3049](https://github.com/ESMValGroup/ESMValTool/pull/3049))
  [@schlunma](https://github.com/schlunma).
  To use the unit conversion for precipitation in the new version of this
  diagnostic, add it as a preprocessor for the precipitation dataset to the
  recipe.

### Bug fixes

- Fix for provenance records from seaice_tsline.ncl ([Pull request #2938](https://github.com/ESMValGroup/ESMValTool/pull/2938)) [@axel-lauer](https://github.com/axel-lauer)
- Fix in validation.py for resolving datasets with identical names by using distinct aliases ([Pull request #2955](https://github.com/ESMValGroup/ESMValTool/pull/2955)) [@FranziskaWinterstein](https://github.com/FranziskaWinterstein)
- Bugfix: masking of non-significant differences in zonal.ncl (perfmetrics) ([Pull request #2957](https://github.com/ESMValGroup/ESMValTool/pull/2957)) [@axel-lauer](https://github.com/axel-lauer)
- Fix typo in perfmetrics/main.ncl to add tropopause ([Pull request #2966](https://github.com/ESMValGroup/ESMValTool/pull/2966)) [@FranziskaWinterstein](https://github.com/FranziskaWinterstein)
- Fix .png bug in wenzel16nat diagnostics ([Pull request #2976](https://github.com/ESMValGroup/ESMValTool/pull/2976)) [@axel-lauer](https://github.com/axel-lauer)
- Recipe_ocean_Landschuetzer2016: Fix typo in filename to run model vs OBS diagnostics ([Pull request #2997](https://github.com/ESMValGroup/ESMValTool/pull/2997)) [@TomasTorsvik](https://github.com/TomasTorsvik)
- Fix read_cmor in NCL utilities ([Pull request #3007](https://github.com/ESMValGroup/ESMValTool/pull/3007)) [@axel-lauer](https://github.com/axel-lauer)
- Removed usages of deprecated features that cause diagnostic crashes ([Pull request #3009](https://github.com/ESMValGroup/ESMValTool/pull/3009)) [@schlunma](https://github.com/schlunma)
- Replace removed matplotlib.pyplot.savefig option additional_artists ([Pull request #3075](https://github.com/ESMValGroup/ESMValTool/pull/3075)) [@schlunma](https://github.com/schlunma)
- Added missing comma to sommer17joss.bibtex ([Pull request #3078](https://github.com/ESMValGroup/ESMValTool/pull/3078)) [@schlunma](https://github.com/schlunma)
- Fix call of output_type in aux_plotting.ncl ([Pull request #3083](https://github.com/ESMValGroup/ESMValTool/pull/3083)) [@LisaBock](https://github.com/LisaBock)
- Remove colorbar from bbox_extra_artists ([Pull request #3087](https://github.com/ESMValGroup/ESMValTool/pull/3087)) [@schlunma](https://github.com/schlunma)
- Fix MPI-ESM1-2-HR entries in recipe_tebaldi21esd ([Pull request #3093](https://github.com/ESMValGroup/ESMValTool/pull/3093)) [@remi-kazeroni](https://github.com/remi-kazeroni)
- Fix bug in provenance writing of perfmetrics recipes v2.8.0 ([Pull request #3098](https://github.com/ESMValGroup/ESMValTool/pull/3098)) [@axel-lauer](https://github.com/axel-lauer)
- Fix recipe_sea_surface_salinity for v2.8 ([Pull request #3102](https://github.com/ESMValGroup/ESMValTool/pull/3102)) [@sloosvel](https://github.com/sloosvel)
- Fix variable short_name and metadata for ESACCI-LST CMORizer ([Pull request #3104](https://github.com/ESMValGroup/ESMValTool/pull/3104)) [@remi-kazeroni](https://github.com/remi-kazeroni)
- Fix recipe_carvalhais14: replace outline patch with splines ([Pull request #3111](https://github.com/ESMValGroup/ESMValTool/pull/3111)) [@valeriupredoi](https://github.com/valeriupredoi)
- Replace deprecated function cm.register_cmap with mpl.colormaps.register for recipe_ arctic_ocean ([Pull request #3112](https://github.com/ESMValGroup/ESMValTool/pull/3112)) [@TomasTorsvik](https://github.com/TomasTorsvik)
- Fix recipe_extract_shape.yml (lacking caption for provenance) ([Pull request #3126](https://github.com/ESMValGroup/ESMValTool/pull/3126)) [@valeriupredoi](https://github.com/valeriupredoi)

### Community

- Update documentation on pre-installed versions on HPC clusters ([Pull request #2934](https://github.com/ESMValGroup/ESMValTool/pull/2934)) [@remi-kazeroni](https://github.com/remi-kazeroni)

### Deprecations

- Remove radiation recipes that have been superseded by [recipe_radiation_budget](recipes/recipe_radiation_budget.html.md#recipes-radiation-budget) along with associated diagnostic scripts ([#3115](https://github.com/ESMValGroup/ESMValTool/pull/3115)) [@alistairsellar](https://github.com/alistairsellar)

### Documentation

- Backward compatibility policy ([Pull request #2879](https://github.com/ESMValGroup/ESMValTool/pull/2879)) [@alistairsellar](https://github.com/alistairsellar)
- Suppress installing and reinstalling dependencies with pip during readthedocs builds ([Pull request #2913](https://github.com/ESMValGroup/ESMValTool/pull/2913)) [@valeriupredoi](https://github.com/valeriupredoi)
- Update installation instructions ([Pull request #2939](https://github.com/ESMValGroup/ESMValTool/pull/2939)) [@bouweandela](https://github.com/bouweandela)
- Update documentation for recipe_extreme_index ([Pull request #2951](https://github.com/ESMValGroup/ESMValTool/pull/2951)) [@katjaweigel](https://github.com/katjaweigel)
- Update documentation and recipe_check_obs (ERA5) ([Pull request #2952](https://github.com/ESMValGroup/ESMValTool/pull/2952)) [@axel-lauer](https://github.com/axel-lauer)
- Updated ICON dataset entry in documentation ([Pull request #2954](https://github.com/ESMValGroup/ESMValTool/pull/2954)) [@schlunma](https://github.com/schlunma)
- Add Franziska Winterstein as collaborator in CITATION file ([Pull request #3001](https://github.com/ESMValGroup/ESMValTool/pull/3001)) [@valeriupredoi](https://github.com/valeriupredoi)
- Update release schedule for v2.7.0 and v2.8.0 ([Pull request #3010](https://github.com/ESMValGroup/ESMValTool/pull/3010)) [@remi-kazeroni](https://github.com/remi-kazeroni)
- Add ESMValCore Bugfix release v2.7.1 to the release overview table ([Pull request #3028](https://github.com/ESMValGroup/ESMValTool/pull/3028)) [@valeriupredoi](https://github.com/valeriupredoi)
- Detailed instructions for release procedure: running recipes and analyzing the output ([Pull request #3032](https://github.com/ESMValGroup/ESMValTool/pull/3032)) [@valeriupredoi](https://github.com/valeriupredoi)
- Link backward compatibility policy to top level of ESMValCore changelog  ([Pull request #3052](https://github.com/ESMValGroup/ESMValTool/pull/3052)) [@alistairsellar](https://github.com/alistairsellar)
- Update release instructions ([Pull request #3066](https://github.com/ESMValGroup/ESMValTool/pull/3066)) [@remi-kazeroni](https://github.com/remi-kazeroni)
- Updated docs and tests regarding new search_esgf option ([Pull request #3069](https://github.com/ESMValGroup/ESMValTool/pull/3069)) [@schlunma](https://github.com/schlunma)
- Update script to draft release notes ([Pull request #3070](https://github.com/ESMValGroup/ESMValTool/pull/3070)) [@remi-kazeroni](https://github.com/remi-kazeroni)
- Synchronize documentation table of contents with ESMValCore ([Pull request #3073](https://github.com/ESMValGroup/ESMValTool/pull/3073)) [@bouweandela](https://github.com/bouweandela)
- Update environment handling in release documentation ([Pull request #3096](https://github.com/ESMValGroup/ESMValTool/pull/3096)) [@remi-kazeroni](https://github.com/remi-kazeroni)
- Clarify use (or not) of Jasmin climatology files by soil moisture & permafrost recipes ([Pull request #3103](https://github.com/ESMValGroup/ESMValTool/pull/3103)) [@alistairsellar](https://github.com/alistairsellar)
- Add link to recipe portal in the gallery page ([Pull request #3113](https://github.com/ESMValGroup/ESMValTool/pull/3113)) [@remi-kazeroni](https://github.com/remi-kazeroni)
- Improve stratosphere documentation ([Pull request #3114](https://github.com/ESMValGroup/ESMValTool/pull/3114)) [@alistairsellar](https://github.com/alistairsellar)
- Added note to documentation that not all datasets used in schlund20jgr recipes are available on ESGF ([Pull request #3121](https://github.com/ESMValGroup/ESMValTool/pull/3121)) [@schlunma](https://github.com/schlunma)
- Draft changelog for v2.8.0 ([Pull request #3124](https://github.com/ESMValGroup/ESMValTool/pull/3124)) [@remi-kazeroni](https://github.com/remi-kazeroni)
- Documenting broken recipes after recipe testing for releases ([Pull request #3129](https://github.com/ESMValGroup/ESMValTool/pull/3129)) [@remi-kazeroni](https://github.com/remi-kazeroni)
- Increase ESMValTool version to 2.8.0 and update release dates ([Pull request #3136](https://github.com/ESMValGroup/ESMValTool/pull/3136)) [@remi-kazeroni](https://github.com/remi-kazeroni)

### Diagnostics

- Cloud diagnostics for Lauer et al. (2023) ([Pull request #2750](https://github.com/ESMValGroup/ESMValTool/pull/2750)) [@axel-lauer](https://github.com/axel-lauer)
- Splitting of flato13ipcc.yml into separate recipes and adding recipes for regional Figures ([Pull request #2156](https://github.com/ESMValGroup/ESMValTool/pull/2156)) [@katjaweigel](https://github.com/katjaweigel)
- Adding IPCC AR6 Chapter 3 Figure  3.43 - Pattern Correlation ([Pull request #2772](https://github.com/ESMValGroup/ESMValTool/pull/2772)) [@LisaBock](https://github.com/LisaBock)
- Adding IPCC AR6 Chapter 3 Fig. 3.42 - Perfmetrics ([Pull request #2856](https://github.com/ESMValGroup/ESMValTool/pull/2856)) [@LisaBock](https://github.com/LisaBock)
- Comment missing datasets and remove deprecated argument in recipe_climate_change_hotspot ([Pull request #2920](https://github.com/ESMValGroup/ESMValTool/pull/2920)) [@sloosvel](https://github.com/sloosvel)
- Add plot type annual_cycle to multi-dataset monitoring diagnostic ([Pull request #2922](https://github.com/ESMValGroup/ESMValTool/pull/2922)) [@schlunma](https://github.com/schlunma)
- Adding IPCC AR6 Chapter 3 Fig. 3.19 - Speed-Up Of Zonal Mean Wind ([Pull request #2984](https://github.com/ESMValGroup/ESMValTool/pull/2984)) [@LisaBock](https://github.com/LisaBock)
- Adding IPCC AR6 Chapter 3 Fig. 3.9 - Attribution ([Pull request #2986](https://github.com/ESMValGroup/ESMValTool/pull/2986)) [@LisaBock](https://github.com/LisaBock)
- Obs4mips CERES-EBAF: update version to latest available through esgf in recipe_validation.yml ([Pull request #3002](https://github.com/ESMValGroup/ESMValTool/pull/3002)) [@valeriupredoi](https://github.com/valeriupredoi)
- Improve flexibility of cloud diagnostics ([Pull request #3016](https://github.com/ESMValGroup/ESMValTool/pull/3016)) [@axel-lauer](https://github.com/axel-lauer)
- Let recipe_impact.yml write a CSV file that can directly be used in C4I portal ([Pull request #2258](https://github.com/ESMValGroup/ESMValTool/pull/2258)) [@Peter9192](https://github.com/Peter9192)
- Fix version numbers of native6 datasets in recipes ([#3041](https://github.com/ESMValGroup/ESMValTool/pull/3041)) [@remi-kazeroni](https://github.com/remi-kazeroni)
- Removed automatic conversion of precipitation units from monitoring diagnostic ([#3049](https://github.com/ESMValGroup/ESMValTool/pull/3049)) [@schlunma](https://github.com/schlunma).
- Updated recipes for ESMValCore v2.8 ([Pull request #3064](https://github.com/ESMValGroup/ESMValTool/pull/3064)) [@schlunma](https://github.com/schlunma)
- Fix cos22esd for release of 2.8 ([Pull request #3097](https://github.com/ESMValGroup/ESMValTool/pull/3097)) [@sloosvel](https://github.com/sloosvel)
- Diagnostic for recipe_autoassess_stratosphere.yml: remove unused feature incompatible with Matplotlib=3.7.1 ([Pull request #3089](https://github.com/ESMValGroup/ESMValTool/pull/3089)) [@valeriupredoi](https://github.com/valeriupredoi)
- Fix numpy deprecation in hype diagnostic ([Pull request #3101](https://github.com/ESMValGroup/ESMValTool/pull/3101)) [@Peter9192](https://github.com/Peter9192)
- Remove superseded radiation recipes ([#3115](https://github.com/ESMValGroup/ESMValTool/pull/3115)) [@alistairsellar](https://github.com/alistairsellar)
- Removed fx_variables in recipe_mpqb_xch4 and recipe_lauer22jclim_fig8 ([Pull request #3117](https://github.com/ESMValGroup/ESMValTool/pull/3117)) [@axel-lauer](https://github.com/axel-lauer)
- Update Python example recipe ([Pull request #3119](https://github.com/ESMValGroup/ESMValTool/pull/3119)) [@bouweandela](https://github.com/bouweandela)
- Updated figure settings to account for newer matplotlib version ([Pull request #3133](https://github.com/ESMValGroup/ESMValTool/pull/3133)) [@katjaweigel](https://github.com/katjaweigel)

### Observational and re-analysis dataset support

- Earth System Data Cube (ESDC) cmorizer ([Pull request #2799](https://github.com/ESMValGroup/ESMValTool/pull/2799)) [@bsolino](https://github.com/bsolino)
- Added CMORizer for Landschützer2020 (spco2) ([Pull request #2908](https://github.com/ESMValGroup/ESMValTool/pull/2908)) [@schlunma](https://github.com/schlunma)
- Added CMORizer for MOBO-DIC_MPIM (dissic) ([Pull request #2909](https://github.com/ESMValGroup/ESMValTool/pull/2909)) [@schlunma](https://github.com/schlunma)
- Added CMORizer for OceanSODA-ETHZ (areacello, co3os, dissicos, fgco2, phos, spco2, talkos) ([Pull request #2915](https://github.com/ESMValGroup/ESMValTool/pull/2915)) [@schlunma](https://github.com/schlunma)
- Extension of ERA-Interim CMORizer (cl, cli, clw, lwp, rlut, rlutcs, rsut, rsutcs) ([Pull request #2923](https://github.com/ESMValGroup/ESMValTool/pull/2923)) [@axel-lauer](https://github.com/axel-lauer)
- Add JRA-25 cmorizer (clt, hus, prw, rlut, rlutcs, rsut, rsutcs) ([Pull request #2927](https://github.com/ESMValGroup/ESMValTool/pull/2927)) [@LisaBock](https://github.com/LisaBock)
- New CMORizers for datasets from the NCEP family (NCEP-DOE-R2, NCEP-NCAR-R1, NOAA-CIRES-20CR) ([Pull request #2931](https://github.com/ESMValGroup/ESMValTool/pull/2931)) [@hb326](https://github.com/hb326)
- Updates to the recipes that use the NCEP reanalysis dataset ([Pull request #2932](https://github.com/ESMValGroup/ESMValTool/pull/2932)) [@hb326](https://github.com/hb326)
- MERRA2 cmorizer convert vertical level coordinate units from hPa to Pa ([Pull request #3003](https://github.com/ESMValGroup/ESMValTool/pull/3003)) [@valeriupredoi](https://github.com/valeriupredoi)
- MERRA2 cmorizer set UNLIMITED time coordinate ([Pull request #3006](https://github.com/ESMValGroup/ESMValTool/pull/3006)) [@valeriupredoi](https://github.com/valeriupredoi)
- Added CMORizers for TCOM-CH4 (CH4) and TCOM-N2O (N2O) ([Pull request #3014](https://github.com/ESMValGroup/ESMValTool/pull/3014)) [@schlunma](https://github.com/schlunma)
- Update HadISST cmorizer to include recent years ([Pull request #3027](https://github.com/ESMValGroup/ESMValTool/pull/3027)) [@remi-kazeroni](https://github.com/remi-kazeroni)

### Automatic testing

- Add DKRZ/Levante batch scripts for release recipe running ([Pull request #2883](https://github.com/ESMValGroup/ESMValTool/pull/2883)) [@valeriupredoi](https://github.com/valeriupredoi)
- Remove pytest-flake8 and call the use of flake8 straight ([Pull request #2904](https://github.com/ESMValGroup/ESMValTool/pull/2904)) [@valeriupredoi](https://github.com/valeriupredoi)
- Unpin flake8 ([Pull request #2937](https://github.com/ESMValGroup/ESMValTool/pull/2937)) [@valeriupredoi](https://github.com/valeriupredoi)
- Fix failing tests that use deprecated feature of sklearn ([Pull request #2961](https://github.com/ESMValGroup/ESMValTool/pull/2961)) [@schlunma](https://github.com/schlunma)
- Fix recipe loading tests for esmvalcore before and after version 2.8 ([Pull request #3020](https://github.com/ESMValGroup/ESMValTool/pull/3020)) [@valeriupredoi](https://github.com/valeriupredoi)
- Update recipe load test for v2.8 ([Pull request #3040](https://github.com/ESMValGroup/ESMValTool/pull/3040)) [@bouweandela](https://github.com/bouweandela)
- Test running recipes with the development version of ESMValCore ([Pull request #3072](https://github.com/ESMValGroup/ESMValTool/pull/3072)) [@bouweandela](https://github.com/bouweandela)
- Fix test_naming.py so it doesn’t let through directories that need be ignored ([Pull request #3082](https://github.com/ESMValGroup/ESMValTool/pull/3082)) [@valeriupredoi](https://github.com/valeriupredoi)
- Conda environment files for interim use of esmvalcore=2.8.0rc1 ([Pull request #3090](https://github.com/ESMValGroup/ESMValTool/pull/3090)) [@valeriupredoi](https://github.com/valeriupredoi)
- Move flake8 check to a step separate from installation on CircleCI ([Pull request #3105](https://github.com/ESMValGroup/ESMValTool/pull/3105)) [@bouweandela](https://github.com/bouweandela)
- Recreate conda lock file to harpoon esmvalcore=2.8.0rc1 ([Pull request #3108](https://github.com/ESMValGroup/ESMValTool/pull/3108)) [@valeriupredoi](https://github.com/valeriupredoi)
- Update batch script generation to run all recipes in one command ([Pull request #3130](https://github.com/ESMValGroup/ESMValTool/pull/3130)) [@remi-kazeroni](https://github.com/remi-kazeroni)

### Installation

- Merge release branch release_270stable in main so we pick up unsquashed commits and set the correct version 2.7.0 for main (and up version in CITATION.cff) ([Pull request #2896](https://github.com/ESMValGroup/ESMValTool/pull/2896)) [@valeriupredoi](https://github.com/valeriupredoi)
- Unpin NetCDF4 ([Pull request #2929](https://github.com/ESMValGroup/ESMValTool/pull/2929)) [@valeriupredoi](https://github.com/valeriupredoi)
- Unpin cf-units ([Pull request #2930](https://github.com/ESMValGroup/ESMValTool/pull/2930)) [@bouweandela](https://github.com/bouweandela)
- Set the version number on the development branches to one minor version more than the last release  ([Pull request #2964](https://github.com/ESMValGroup/ESMValTool/pull/2964)) [@bouweandela](https://github.com/bouweandela)
- Pin shapely<2.0.0 for linux64 ([Pull request #2970](https://github.com/ESMValGroup/ESMValTool/pull/2970)) [@valeriupredoi](https://github.com/valeriupredoi)
- Unpin matplotlib ([Pull request #3068](https://github.com/ESMValGroup/ESMValTool/pull/3068)) [@valeriupredoi](https://github.com/valeriupredoi)
- Add packaging as direct dependency to ESMValTool ([Pull request #3099](https://github.com/ESMValGroup/ESMValTool/pull/3099)) [@valeriupredoi](https://github.com/valeriupredoi)
- Re-pin sphinx to latest (6.1.3) and add nbsphinx to the environment ([Pull request #3118](https://github.com/ESMValGroup/ESMValTool/pull/3118)) [@valeriupredoi](https://github.com/valeriupredoi)
- Conda environment files for esmvalcore=2.8.0rc2 ([Pull request #3120](https://github.com/ESMValGroup/ESMValTool/pull/3120)) [@remi-kazeroni](https://github.com/remi-kazeroni)
- Remove rc (release candidates) conda channel and re-pin esmvalcore to new stable 2.8 ([Pull request #3131](https://github.com/ESMValGroup/ESMValTool/pull/3131)) [@valeriupredoi](https://github.com/valeriupredoi)

### Improvements

- Read config-user.yml using esmvalcore.config module ([Pull request #2736](https://github.com/ESMValGroup/ESMValTool/pull/2736)) [@bouweandela](https://github.com/bouweandela)
- Make results of recipes schlund20jgr_\*.yml deterministic ([Pull request #2900](https://github.com/ESMValGroup/ESMValTool/pull/2900)) [@schlunma](https://github.com/schlunma)
- Recipe_gier2020bg.yml: add sorting to SA barplot ([Pull request #2905](https://github.com/ESMValGroup/ESMValTool/pull/2905)) [@bettina-gier](https://github.com/bettina-gier)
- Add the outline of a climatological tropopause to the zonalmean_profile plots ([Pull request #2947](https://github.com/ESMValGroup/ESMValTool/pull/2947)) [@FranziskaWinterstein](https://github.com/FranziskaWinterstein)
- Update data finder imports ([Pull request #2958](https://github.com/ESMValGroup/ESMValTool/pull/2958)) [@bouweandela](https://github.com/bouweandela)
- Add support for the upcoming ESMValCore v2.8 release to the recipe filler tool ([Pull request #2995](https://github.com/ESMValGroup/ESMValTool/pull/2995)) [@bouweandela](https://github.com/bouweandela)
- Updated monitoring diagnostics with netCDF output and additional logging ([Pull request #3029](https://github.com/ESMValGroup/ESMValTool/pull/3029)) [@schlunma](https://github.com/schlunma)
- Use aliases in perfmetrics ([Pull request #3058](https://github.com/ESMValGroup/ESMValTool/pull/3058)) [@FranziskaWinterstein](https://github.com/FranziskaWinterstein)

<a id="changelog-v2-7-0"></a>

## v2.7.0

### Highlights

- This release has seen the inclusion of the code for figures 3.3, 3.4, 3.5, 3,13 and 3.15 of the IPCC AR6 WG1 report, see them in the [new documentation](https://docs.esmvaltool.org/en/latest/recipes/recipe_ipccwg1ar6ch3.html)
- We have also included new diagnostics and recipe necessary to produce the plots and tables for the journal article “Climate model projections from the Scenario Model Intercomparison Project (ScenarioMIP) of CMIP6” by [Tebaldi et al. in ESD 2020-68](https://doi.org/10.5194/esd-2020-68) from 2021; also see the [recipe entry](https://docs.esmvaltool.org/en/latest/recipes/recipe_tebaldi21esd.html)
- We have also extended the support for MERRA2 observational dataset, by adding support for a large number of variables, including 3D variables, see the [table of supported obs datasets](https://docs.esmvaltool.org/en/latest/input.html#supported-datasets-for-which-a-cmorizer-script-is-available)

### Backwards incompatible changes

- Remove installation of R dependencies from the help message ([Pull request #2761](https://github.com/ESMValGroup/ESMValTool/pull/2761)) [@remi-kazeroni](https://github.com/remi-kazeroni)

### Bug fixes

- Fix misplaced provenance records from IPCC AR5 Ch.12 diags ([Pull request #2758](https://github.com/ESMValGroup/ESMValTool/pull/2758)) [@axel-lauer](https://github.com/axel-lauer)
- Fix esmvaltool.utils.testing.regression.compare module to run with Python<3.10 too ([Pull request #2778](https://github.com/ESMValGroup/ESMValTool/pull/2778)) [@valeriupredoi](https://github.com/valeriupredoi)
- Fixed small bug that could lead to wrong pr units in monitor/multi_datasets.py ([Pull request #2788](https://github.com/ESMValGroup/ESMValTool/pull/2788)) [@schlunma](https://github.com/schlunma)
- Pin xgboost>1.6.1 so we avert documentation failing to build with 1.6.1 ([Pull request #2780](https://github.com/ESMValGroup/ESMValTool/pull/2780)) [@valeriupredoi](https://github.com/valeriupredoi)
- Pin matplotlib-base<3.6.0 to avoid conflict from mapgenerator that fails doc builds ([Pull request #2830](https://github.com/ESMValGroup/ESMValTool/pull/2830)) [@valeriupredoi](https://github.com/valeriupredoi)
- Fixed wrong latitudes in NDP CMORizer ([Pull request #2832](https://github.com/ESMValGroup/ESMValTool/pull/2832)) [@schlunma](https://github.com/schlunma)
- Fix indexer in Autoassess supermeans module use a tuple of (slice(), idx, idx) ([Pull request #2838](https://github.com/ESMValGroup/ESMValTool/pull/2838)) [@valeriupredoi](https://github.com/valeriupredoi)
- Replace xarray ufuncs with bogstandard numpy in weighting/climwip/calibrate_sigmas.py ([Pull request #2848](https://github.com/ESMValGroup/ESMValTool/pull/2848)) [@valeriupredoi](https://github.com/valeriupredoi)
- Fix units MERRA2 CMORizer ([Pull request #2850](https://github.com/ESMValGroup/ESMValTool/pull/2850)) [@axel-lauer](https://github.com/axel-lauer)
- Fix bug when using log-scale y-axis for ocean transects. ([Pull request #2862](https://github.com/ESMValGroup/ESMValTool/pull/2862)) [@TomasTorsvik](https://github.com/TomasTorsvik)

### Community

- Add MO-paths to config file ([Pull request #2784](https://github.com/ESMValGroup/ESMValTool/pull/2784)) [mo-tgeddes](https://github.com/mo-tgeddes)

### Deprecations

- Recipe recipe_esacci_oc.yml replace with new regrid scheme nearest_extrapolate ([Pull request #2841](https://github.com/ESMValGroup/ESMValTool/pull/2841)) [@valeriupredoi](https://github.com/valeriupredoi)

### Documentation

- Update release schedule for v2.7 ([Pull request #2747](https://github.com/ESMValGroup/ESMValTool/pull/2747)) [@bouweandela](https://github.com/bouweandela)
- Add Met Office installation method ([Pull request #2751](https://github.com/ESMValGroup/ESMValTool/pull/2751)) [mo-tgeddes](https://github.com/mo-tgeddes)
- Add release dates for 2023 ([Pull request #2769](https://github.com/ESMValGroup/ESMValTool/pull/2769)) [@remi-kazeroni](https://github.com/remi-kazeroni)
- Made maintainer entry mandatory for published recipes ([Pull request #2703](https://github.com/ESMValGroup/ESMValTool/pull/2703)) [@schlunma](https://github.com/schlunma)
- Use command with current command line opts for cffconvert in documentation ([Pull request #2791](https://github.com/ESMValGroup/ESMValTool/pull/2791)) [@valeriupredoi](https://github.com/valeriupredoi)
- Update CMORizer documentation with command options ([Pull request #2795](https://github.com/ESMValGroup/ESMValTool/pull/2795)) [@remi-kazeroni](https://github.com/remi-kazeroni)
- Fixed broken link for monthly meetings ([Pull request #2806](https://github.com/ESMValGroup/ESMValTool/pull/2806)) [@remi-kazeroni](https://github.com/remi-kazeroni)
- Update MO obs4MIPs paths in the user configuration file ([Pull request #2813](https://github.com/ESMValGroup/ESMValTool/pull/2813)) [mo-tgeddes](https://github.com/mo-tgeddes)
- Fix Windows incompatible file names in documentation of recipe_climate_change_hotspot.yml ([Pull request #2823](https://github.com/ESMValGroup/ESMValTool/pull/2823)) [@ledm](https://github.com/ledm)
- Update documentation for the Landschuetzer 2016 recipe. ([Pull request #2801](https://github.com/ESMValGroup/ESMValTool/pull/2801)) [@TomasTorsvik](https://github.com/TomasTorsvik)
- Fixed anaconda badge in README ([Pull request #2866](https://github.com/ESMValGroup/ESMValTool/pull/2866)) [@valeriupredoi](https://github.com/valeriupredoi)
- Update release strategy notes ([Pull request #2734](https://github.com/ESMValGroup/ESMValTool/pull/2734)) [@sloosvel](https://github.com/sloosvel)
- Add documentation on how to handle CMORizers for multiple dataset versions ([Pull request #2730](https://github.com/ESMValGroup/ESMValTool/pull/2730)) [@remi-kazeroni](https://github.com/remi-kazeroni)
- Extending documentation: recipe maintainer + broken recipe policy ([Pull request #2719](https://github.com/ESMValGroup/ESMValTool/pull/2719)) [@axel-lauer](https://github.com/axel-lauer)

### Diagnostics

- Recipe and diagnostics for : Tebaldi et al.,ESD, 2021 ([Pull request #2052](https://github.com/ESMValGroup/ESMValTool/pull/2052)) [debe-kevin](https://github.com/debe-kevin)
- Figures for IPCC AR6 WG1 Chapter 3 (Atmosphere) ([Pull request #2533](https://github.com/ESMValGroup/ESMValTool/pull/2533)) [@LisaBock](https://github.com/LisaBock)

### Observational and re-analysis dataset support

- Update CERES-EBAF to Ed4.1 ([Pull request #2752](https://github.com/ESMValGroup/ESMValTool/pull/2752)) [@axel-lauer](https://github.com/axel-lauer)
- New CMORizer for CALIPSO-ICECLOUD ([Pull request #2753](https://github.com/ESMValGroup/ESMValTool/pull/2753)) [@axel-lauer](https://github.com/axel-lauer)
- New CMORizer for CLOUDSAT-L2 ([Pull request #2754](https://github.com/ESMValGroup/ESMValTool/pull/2754)) [@axel-lauer](https://github.com/axel-lauer)
- Update MERRA2 cmorizer with extra 2D and 3D variables ([Pull request #2774](https://github.com/ESMValGroup/ESMValTool/pull/2774)) [@valeriupredoi](https://github.com/valeriupredoi)

### Automatic testing

- Pin netcdf4 != 1.6.1 since that is spitting large numbers of SegFaults ([Pull request #2796](https://github.com/ESMValGroup/ESMValTool/pull/2796)) [@valeriupredoi](https://github.com/valeriupredoi)

### Installation

- Increase esmvalcore version to 2.7.0 in environment files ([Pull request #2860](https://github.com/ESMValGroup/ESMValTool/pull/2860)) [@valeriupredoi](https://github.com/valeriupredoi)
- Add iris-esmf-regrid as a dependency ([Pull request #2880](https://github.com/ESMValGroup/ESMValTool/pull/2880)) [@zklaus](https://github.com/zklaus)

### Improvements

- Fix tebaldi21esd ([Pull request #2749](https://github.com/ESMValGroup/ESMValTool/pull/2749)) [@axel-lauer](https://github.com/axel-lauer)
- Added option to show basic statistics in plots of monitor/multi_datasets.py ([Pull request #2790](https://github.com/ESMValGroup/ESMValTool/pull/2790)) [@schlunma](https://github.com/schlunma)
- Remove retracted datasets from recipe_climate_change_hotspot ([Pull request #2854](https://github.com/ESMValGroup/ESMValTool/pull/2854)) [@sloosvel](https://github.com/sloosvel)

<a id="changelog-v2-6-0"></a>

## v2.6.0

### Highlights

- A new monitoring diagnostic has been added to allow the comparison of model runs against reference datasets. For details, see [Monitoring diagnostic to show multiple datasets in one plot (incl. biases)](api/esmvaltool.diag_scripts.monitor/multi_datasets.html.md#api-esmvaltool-diag-scripts-monitor-multi-datasets).
- A tool has been developed to compare the output of recipe runs against previous runs, in order to detect in an automated way breaking changes between releases. Find more information in [Comparing recipe runs](utils/utils.html.md#compare-recipe-runs).
- The recipe [Climate Change Hotspot](recipes/recipe_climate_change_hotspot.html.md#recipe-climate-change-hotspot-rst) allows to compute hotspots in any rectangular region.

Please also note the highlights from the corresponding ESMValCore release [here](https://docs.esmvaltool.org/projects/ESMValCore/en/latest/changelog.html#changelog-v2-6-0).
Thanks to that ESMValTool has gained the following features:

- A new set of CMOR fixes is now available in order to load native EMAC model output and CMORize it on the fly.
- The version number of ESMValCore is now automatically generated using [setuptools_scm](https://github.com/pypa/setuptools_scm/#default-versioning-scheme), which extracts Python package versions from git metadata.

This release includes

### Bug fixes

- Fix dtype for Marrmot recipe results ([Pull request #2646](https://github.com/ESMValGroup/ESMValTool/pull/2646)) [@SarahAlidoost](https://github.com/SarahAlidoost)
- Adapt test_fix_coords to new version of cf-units ([Pull request #2707](https://github.com/ESMValGroup/ESMValTool/pull/2707)) [@zklaus](https://github.com/zklaus)
- Fix nested axes in recipe_martin18_grl and recipe_li17natcc ([Pull request #2712](https://github.com/ESMValGroup/ESMValTool/pull/2712)) [@lukruh](https://github.com/lukruh)
- Update common_climdex_preprocessing_for_plots.R ([Pull request #2727](https://github.com/ESMValGroup/ESMValTool/pull/2727)) [@earnone](https://github.com/earnone)

### Community

- Collecting github user names for config-references ([Pull request #2677](https://github.com/ESMValGroup/ESMValTool/pull/2677)) [@lukruh](https://github.com/lukruh)

### Deprecations

- Deprecate the function esmvaltool.diag_scripts.shared.var_name_constraint. This function is scheduled for removal in v2.8.0. Please use [`iris.NameConstraint`](https://scitools-iris.readthedocs.io/en/latest/generated/api/iris.html#iris.NameConstraint) with the keyword argument var_name instead: this is an exact replacement. ([Pull request #2655](https://github.com/ESMValGroup/ESMValTool/pull/2655)) [@schlunma](https://github.com/schlunma)

### Documentation

- Documentation Improvements ([Pull request #2580](https://github.com/ESMValGroup/ESMValTool/pull/2580)) [@stacristo](https://github.com/stacristo)
- Fixed broken label in the documentation ([Pull request #2616](https://github.com/ESMValGroup/ESMValTool/pull/2616)) [@remi-kazeroni](https://github.com/remi-kazeroni)
- Add readthedocs configuration file ([Pull request #2627](https://github.com/ESMValGroup/ESMValTool/pull/2627)) [@bouweandela](https://github.com/bouweandela)
- Update the command for building the documentation ([Pull request #2622](https://github.com/ESMValGroup/ESMValTool/pull/2622)) [@bouweandela](https://github.com/bouweandela)
- Added DKRZ-Levante to config-user-example.yml ([Pull request #2632](https://github.com/ESMValGroup/ESMValTool/pull/2632)) [@remi-kazeroni](https://github.com/remi-kazeroni)
- Improved documentation on native dataset support ([Pull request #2635](https://github.com/ESMValGroup/ESMValTool/pull/2635)) [@schlunma](https://github.com/schlunma)
- Add documentation on building and uploading Docker images ([Pull request #2662](https://github.com/ESMValGroup/ESMValTool/pull/2662)) [@bouweandela](https://github.com/bouweandela)
- Remove support for Mistral in config-user-example.yml ([Pull request #2667](https://github.com/ESMValGroup/ESMValTool/pull/2667)) [@remi-kazeroni](https://github.com/remi-kazeroni)
- Add note to clarify that CORDEX support is work in progress ([Pull request #2682](https://github.com/ESMValGroup/ESMValTool/pull/2682)) [@bouweandela](https://github.com/bouweandela)
- Restore accidentally deleted text from input data docs ([Pull request #2683](https://github.com/ESMValGroup/ESMValTool/pull/2683)) [@bouweandela](https://github.com/bouweandela)
- Add running settings note in recipe_wenzel16nat.yml documentation ([Pull request #2692](https://github.com/ESMValGroup/ESMValTool/pull/2692)) [@sloosvel](https://github.com/sloosvel)
- Add a note on transferring permissions to the release manager ([Pull request #2688](https://github.com/ESMValGroup/ESMValTool/pull/2688)) [@bouweandela](https://github.com/bouweandela)
- Update documentation on ESMValTool module at DKRZ ([Pull request #2696](https://github.com/ESMValGroup/ESMValTool/pull/2696)) [@remi-kazeroni](https://github.com/remi-kazeroni)
- Add note on how to run recipe_wenzel14jgr.yml ([Pull request #2717](https://github.com/ESMValGroup/ESMValTool/pull/2717)) [@sloosvel](https://github.com/sloosvel)
- Added conda forge feedstock repo link in README ([Pull request #2555](https://github.com/ESMValGroup/ESMValTool/pull/2555)) [@valeriupredoi](https://github.com/valeriupredoi)

### Diagnostics

- Compute bias instead of correlation in compare_salinity.py ([Pull request #2642](https://github.com/ESMValGroup/ESMValTool/pull/2642)) [@sloosvel](https://github.com/sloosvel)
- Update monitor diagnostics ([Pull request #2608](https://github.com/ESMValGroup/ESMValTool/pull/2608)) [@schlunma](https://github.com/schlunma)
- Add new Psyplot diagnostic ([Pull request #2653](https://github.com/ESMValGroup/ESMValTool/pull/2653)) [@schlunma](https://github.com/schlunma)
- Reduce memory usage of lisflood recipe ([Pull request #2634](https://github.com/ESMValGroup/ESMValTool/pull/2634)) [@sverhoeven](https://github.com/sverhoeven)
- Provenance in ocean diagnostics ([Pull request #2651](https://github.com/ESMValGroup/ESMValTool/pull/2651)) [@tomaslovato](https://github.com/tomaslovato)
- Extend monitor diagnostics with multi-dataset plots ([Pull request #2657](https://github.com/ESMValGroup/ESMValTool/pull/2657)) [@schlunma](https://github.com/schlunma)
- Recipe and diagnostics to plot climate change hotspots: Cos et al., ESD 2022 ([Pull request #2614](https://github.com/ESMValGroup/ESMValTool/pull/2614)) [@pepcos](https://github.com/pepcos)
- Update plots of consecutive dry days recipe ([Pull request #2671](https://github.com/ESMValGroup/ESMValTool/pull/2671)) [@bouweandela](https://github.com/bouweandela)
- Fix the format of ids in Hype forcing files ([Pull request #2679](https://github.com/ESMValGroup/ESMValTool/pull/2679)) [@SarahAlidoost](https://github.com/SarahAlidoost)
- WFlow diagnostic script: remove manual rechunking ([Pull request #2680](https://github.com/ESMValGroup/ESMValTool/pull/2680)) [@Peter9192](https://github.com/Peter9192)

### Observational and re-analysis dataset support

- Extending the HadCRUT5 cmorizer ([Pull request #2509](https://github.com/ESMValGroup/ESMValTool/pull/2509)) [@LisaBock](https://github.com/LisaBock)
- Cmorize Kadow2020 dataset ([Pull request #2513](https://github.com/ESMValGroup/ESMValTool/pull/2513)) [@LisaBock](https://github.com/LisaBock)
- Cmorize NOAAGlobalTemp dataset ([Pull request #2515](https://github.com/ESMValGroup/ESMValTool/pull/2515)) [@LisaBock](https://github.com/LisaBock)
- Add option to CMORize ts as tos in ESACCI data ([Pull request #2731](https://github.com/ESMValGroup/ESMValTool/pull/2731)) [@sloosvel](https://github.com/sloosvel)

### Automatic testing

- Add a tool for comparing recipe runs to previous runs ([Pull request #2613](https://github.com/ESMValGroup/ESMValTool/pull/2613)) [@bouweandela](https://github.com/bouweandela)
- Ignore NCL interface files when comparing recipe runs ([Pull request #2673](https://github.com/ESMValGroup/ESMValTool/pull/2673)) [@bouweandela](https://github.com/bouweandela)
- Add a short version of recipe deangelis15nat for testing ([Pull request #2685](https://github.com/ESMValGroup/ESMValTool/pull/2685)) [@katjaweigel](https://github.com/katjaweigel)
- Expanded recipe output comparison tool to better handle absolute paths in output ([Pull request #2709](https://github.com/ESMValGroup/ESMValTool/pull/2709)) [@schlunma](https://github.com/schlunma)
- Update development infrastructure ([Pull request #2663](https://github.com/ESMValGroup/ESMValTool/pull/2663)) [@bouweandela](https://github.com/bouweandela)

### Installation

- Removed package/meta.yaml and all references to it ([Pull request #2612](https://github.com/ESMValGroup/ESMValTool/pull/2612)) [@schlunma](https://github.com/schlunma)

### Improvements

- Improved handling of weights in MLR diagnostics ([Pull request #2625](https://github.com/ESMValGroup/ESMValTool/pull/2625)) [@schlunma](https://github.com/schlunma)
- Fixed order of variables in perfemetrics plot of Anav13jclim recipe ([Pull request #2706](https://github.com/ESMValGroup/ESMValTool/pull/2706)) [@schlunma](https://github.com/schlunma)
- Added input file sorting to many diagnostic to make output exactly reproducible ([Pull request #2710](https://github.com/ESMValGroup/ESMValTool/pull/2710)) [@schlunma](https://github.com/schlunma)
- Removed ‘ancestors’ attributes before saving netcdf files in emergent constraints diagnostics ([Pull request #2713](https://github.com/ESMValGroup/ESMValTool/pull/2713)) [@schlunma](https://github.com/schlunma)

<a id="changelog-v2-5-0"></a>

## v2.5.0

### Highlights

- A new recipe to plot generic preprocessor output is now available. For details, see [Monitor](recipes/recipe_monitor.html.md#recipe-monitor).
- The CMORization of observational and other datasets has been overhauled. For many datasets, an automatic download script is now available. For details, see [Observations](input.html.md#inputdata-observations) and [Writing a CMORizer script for an additional dataset](develop/dataset.html.md#new-cmorizer).

Please also note the highlights from the corresponding ESMValCore release [here](https://docs.esmvaltool.org/projects/ESMValCore/en/latest/changelog.html#changelog-v2-5-0).
Thanks to that ESMValTool has gained the following features:

- The new preprocessor `extract_location` can extract arbitrary locations on the Earth.
- Time ranges can now be extracted using the [ISO 8601 format](https://en.wikipedia.org/wiki/ISO_8601).
- The new preprocessor `ensemble_statistics` can calculate arbitrary statistics over all ensemble members of a simulation.

This release includes

### Backwards incompatible changes

- Streamline observations download ([Pull request #1657](https://github.com/ESMValGroup/ESMValTool/pull/1657)) [Javier Vegas-Regidor](https://github.com/jvegreg). This change removes the `cmorize_obs` command which has previously been used to CMORize observations and other datasets. The new command `esmvaltool data` provides many new features apart from the CMORization (`esmvaltool data format`), for example, automatic downloading of observational datasets (`esmvaltool data download`). More details on this can be found [here](input.html.md#inputdata-observations) and [here](develop/dataset.html.md#new-cmorizer).
- Dropped Python 3.7 ([Pull request #2585](https://github.com/ESMValGroup/ESMValTool/pull/2585)) [@schlunma](https://github.com/schlunma). ESMValTool v2.5.0 dropped support for Python 3.7. From now on Python >=3.8 is required to install ESMValTool. The main reason for this is that conda-forge dropped support for Python 3.7 for OSX and arm64 (more details are given [here](https://github.com/ESMValGroup/ESMValTool/issues/2584#issuecomment-1063853630)).

### Bug fixes

- Remove the use of esmvalgroup channel from the conda install Github Action workflow ([Pull request #2420](https://github.com/ESMValGroup/ESMValTool/pull/2420)) [@valeriupredoi](https://github.com/valeriupredoi)
- Ignore .pymon-journal file in test discovery ([Pull request #2491](https://github.com/ESMValGroup/ESMValTool/pull/2491)) [@zklaus](https://github.com/zklaus)
- Relocate pytest-monitor outputted database .pymon so .pymon-journal file should not be looked for by pytest ([Pull request #2501](https://github.com/ESMValGroup/ESMValTool/pull/2501)) [@valeriupredoi](https://github.com/valeriupredoi)
- Re-establish Python 3.7 compatibility ([Pull request #2506](https://github.com/ESMValGroup/ESMValTool/pull/2506)) [@zklaus](https://github.com/zklaus)
- Update intersphinx mapping ([Pull request #2531](https://github.com/ESMValGroup/ESMValTool/pull/2531)) [@zklaus](https://github.com/zklaus)
- Fixed KeyError in recipe_ocean_bgc.yml ([Pull request #2540](https://github.com/ESMValGroup/ESMValTool/pull/2540)) [@schlunma](https://github.com/schlunma)
- Corrected ESACCI-SEA-SURFACE-SALINITY from OBS to OBS6 ([Pull request #2542](https://github.com/ESMValGroup/ESMValTool/pull/2542)) [@axel-lauer](https://github.com/axel-lauer)
- Fixed recipe_kcs.yml ([Pull request #2541](https://github.com/ESMValGroup/ESMValTool/pull/2541)) [@schlunma](https://github.com/schlunma)
- Fix MDER diagnostic regression_stepwise ([Pull request #2545](https://github.com/ESMValGroup/ESMValTool/pull/2545)) [@axel-lauer](https://github.com/axel-lauer)
- Fix for recipe_wenzel16nat ([Pull request #2547](https://github.com/ESMValGroup/ESMValTool/pull/2547)) [@axel-lauer](https://github.com/axel-lauer)
- Fixed recipe_carvalhais14nat and removed deprecated use of np.float ([Pull request #2558](https://github.com/ESMValGroup/ESMValTool/pull/2558)) [@schlunma](https://github.com/schlunma)
- Fix recipe_wenzel14jgr ([Pull request #2577](https://github.com/ESMValGroup/ESMValTool/pull/2577)) [@remi-kazeroni](https://github.com/remi-kazeroni)
- Fixed various recipes by removing faulty or non-available datasets ([Pull request #2563](https://github.com/ESMValGroup/ESMValTool/pull/2563)) [@schlunma](https://github.com/schlunma)
- Remove missing CMIP5 data from 2 recipes ([Pull request #2579](https://github.com/ESMValGroup/ESMValTool/pull/2579)) [@remi-kazeroni](https://github.com/remi-kazeroni)
- Fix recipe_seaice ([Pull request #2578](https://github.com/ESMValGroup/ESMValTool/pull/2578)) [@remi-kazeroni](https://github.com/remi-kazeroni)
- Fix recipe_climwip_brunner20esd ([Pull request #2581](https://github.com/ESMValGroup/ESMValTool/pull/2581)) [@remi-kazeroni](https://github.com/remi-kazeroni)

### Deprecations

- Remove –use-feature=2020-resolver command line option for obsolete pip 2020 solver ([Pull request #2493](https://github.com/ESMValGroup/ESMValTool/pull/2493)) [@valeriupredoi](https://github.com/valeriupredoi)
- Renamed vertical regridding schemes in affected recipes ([Pull request #2487](https://github.com/ESMValGroup/ESMValTool/pull/2487)) [@schlunma](https://github.com/schlunma)

### Documentation

- Update release manager for v2.5 ([Pull request #2429](https://github.com/ESMValGroup/ESMValTool/pull/2429)) [@axel-lauer](https://github.com/axel-lauer)
- Mention ENES Climate Analytics service ([Pull request #2438](https://github.com/ESMValGroup/ESMValTool/pull/2438)) [@bouweandela](https://github.com/bouweandela)
- Add recipe overview page ([Pull request #2439](https://github.com/ESMValGroup/ESMValTool/pull/2439)) [@bouweandela](https://github.com/bouweandela)
- Fix pointer to Tutorial lesson on preprocessor from 05 to 06 ([Pull request #2473](https://github.com/ESMValGroup/ESMValTool/pull/2473)) [@valeriupredoi](https://github.com/valeriupredoi)
- Removed obsolete option synda-download from documentation ([Pull request #2485](https://github.com/ESMValGroup/ESMValTool/pull/2485)) [@schlunma](https://github.com/schlunma)
- Update CMUG XCH4 docu figure ([Pull request #2502](https://github.com/ESMValGroup/ESMValTool/pull/2502)) [@axel-lauer](https://github.com/axel-lauer)
- Add Python=3.10 to package info, update Circle CI auto install and documentation for Python=3.10 ([Pull request #2503](https://github.com/ESMValGroup/ESMValTool/pull/2503)) [@schlunma](https://github.com/schlunma)
- Unify user configuration file ([Pull request #2507](https://github.com/ESMValGroup/ESMValTool/pull/2507)) [@schlunma](https://github.com/schlunma)
- Synchronized config-user.yml with version from ESMValCore ([Pull request #2516](https://github.com/ESMValGroup/ESMValTool/pull/2516)) [@schlunma](https://github.com/schlunma)
- CITATION.cff fix and automatic validation of your citation metadata ([Pull request #2517](https://github.com/ESMValGroup/ESMValTool/pull/2517)) [@abelsiqueira](https://github.com/abelsiqueira)
- Add backwards incompatible changes at the top of the release notes draft ([Pull request #2431](https://github.com/ESMValGroup/ESMValTool/pull/2431)) [@bouweandela](https://github.com/bouweandela)
- Fixed intersphinx mapping of scipy ([Pull request #2523](https://github.com/ESMValGroup/ESMValTool/pull/2523)) [@schlunma](https://github.com/schlunma)
- Add authors to citation cff ([Pull request #2525](https://github.com/ESMValGroup/ESMValTool/pull/2525)) [@SarahAlidoost](https://github.com/SarahAlidoost)
- Update documentation on running a recipe ([Pull request #2432](https://github.com/ESMValGroup/ESMValTool/pull/2432)) [@bouweandela](https://github.com/bouweandela)
- Fix recipe hydrology/recipe_wflow.yml ([Pull request #2549](https://github.com/ESMValGroup/ESMValTool/pull/2549)) [@remi-kazeroni](https://github.com/remi-kazeroni)
- Update draft_release_notes.py for new release ([Pull request #2553](https://github.com/ESMValGroup/ESMValTool/pull/2553)) [@schlunma](https://github.com/schlunma)
- Added stand with Ukraine badge ([Pull request #2565](https://github.com/ESMValGroup/ESMValTool/pull/2565)) [@valeriupredoi](https://github.com/valeriupredoi)
- Updated CREM docu (recipe_williams09climdyn.yml) ([Pull request #2567](https://github.com/ESMValGroup/ESMValTool/pull/2567)) [@axel-lauer](https://github.com/axel-lauer)
- First draft for v2.5.0 changelog ([Pull request #2554](https://github.com/ESMValGroup/ESMValTool/pull/2554)) [@schlunma](https://github.com/schlunma)
- Replace nonfunctional Github Actions badge with cool one in README ([Pull request #2582](https://github.com/ESMValGroup/ESMValTool/pull/2582)) [@valeriupredoi](https://github.com/valeriupredoi)
- Updated changelog ([Pull request #2589](https://github.com/ESMValGroup/ESMValTool/pull/2589)) [@schlunma](https://github.com/schlunma)
- Updated release strategy with current release and upcoming release ([Pull request #2597](https://github.com/ESMValGroup/ESMValTool/pull/2597)) [@schlunma](https://github.com/schlunma)
- Increased ESMValTool version to 2.5.0 ([Pull request #2600](https://github.com/ESMValGroup/ESMValTool/pull/2600)) [@schlunma](https://github.com/schlunma)

### Diagnostics

- AutoAssess: Add new diagnostic for radiation budget ([Pull request #2282](https://github.com/ESMValGroup/ESMValTool/pull/2282)) [@Jon-Lillis](https://github.com/Jon-Lillis)
- CMUG Sea Surface Salinity dataset and diagnostic ([Pull request #1832](https://github.com/ESMValGroup/ESMValTool/pull/1832)) [Javier Vegas-Regidor](https://github.com/jvegreg)
- Recipe with new diagnostics for ESA-CMUG H2O ([Pull request #1834](https://github.com/ESMValGroup/ESMValTool/pull/1834)) [@katjaweigel](https://github.com/katjaweigel)
- Cleaned Schlund et al. (2020) recipe and fixed small bugs in corresponding diagnostic ([Pull request #2484](https://github.com/ESMValGroup/ESMValTool/pull/2484)) [@schlunma](https://github.com/schlunma)
- Add ESA CCI LST cmorizer and diagnostic ([Pull request #1897](https://github.com/ESMValGroup/ESMValTool/pull/1897)) [@morobking](https://github.com/morobking)
- XCH4 ESA CMUG diagnostics (subset of the MPQB diagnostics) ([Pull request #1960](https://github.com/ESMValGroup/ESMValTool/pull/1960)) [@hb326](https://github.com/hb326)
- Add support for ESACCI Ocean Color (Chlorophyll) observations ([Pull request #2055](https://github.com/ESMValGroup/ESMValTool/pull/2055)) [ulrikaw-cloud](https://github.com/ulrikaw-cloud)
- Updated recipe_zmnam.yml with hemisphere selection ([Pull request #2230](https://github.com/ESMValGroup/ESMValTool/pull/2230)) [@fserva](https://github.com/fserva)
- Add recipe and diagnostic scripts to compute figures of D9.4 of ISENES3 ([Pull request #2441](https://github.com/ESMValGroup/ESMValTool/pull/2441)) [@sloosvel](https://github.com/sloosvel)
- Save resampled climates from KCS diagnostic local_resampling.py ([Pull request #2221](https://github.com/ESMValGroup/ESMValTool/pull/2221)) [@Emmadd](https://github.com/Emmadd)
- Use years from KCS recipe ([Pull request #2223](https://github.com/ESMValGroup/ESMValTool/pull/2223)) [@Emmadd](https://github.com/Emmadd)
- Recipe to plot generic output from the preprocessor ([Pull request #2184](https://github.com/ESMValGroup/ESMValTool/pull/2184)) [Javier Vegas-Regidor](https://github.com/jvegreg)
- Fixed provenance tracking for emergent constraint diagnostics ([Pull request #2573](https://github.com/ESMValGroup/ESMValTool/pull/2573)) [@schlunma](https://github.com/schlunma)

### Observational and re-analysis dataset support

- Ensure dummy data for cmorize_obs_woa test are written to the correct directory ([Pull request #2451](https://github.com/ESMValGroup/ESMValTool/pull/2451)) [@ehogan](https://github.com/ehogan)
- Add ESA CCI LST cmorizer and diagnostic (see previous section Diagnostics)

### Automatic testing

- Run a nightly Github Actions workflow to monitor tests memory per test (configurable for other metrics too) and lists the slowest 100 tests ([Pull request #2449](https://github.com/ESMValGroup/ESMValTool/pull/2449)) [@valeriupredoi](https://github.com/valeriupredoi)
- Fix individual pytest runs broken due to missing explicit imports from iris and adding a couple missing package markers ([Pull request #2455](https://github.com/ESMValGroup/ESMValTool/pull/2455)) [@valeriupredoi](https://github.com/valeriupredoi)
- Add Python=3.10 to Github Actions and switch to Python=3.10 for the Github Action that builds the PyPi package ([Pull request #2488](https://github.com/ESMValGroup/ESMValTool/pull/2488)) [@valeriupredoi](https://github.com/valeriupredoi)
- Switch all github actions from miniconda to mambaforge ([Pull request #2498](https://github.com/ESMValGroup/ESMValTool/pull/2498)) [@zklaus](https://github.com/zklaus)
- Pin flake8<4 to have actual FLAKE8 error printed if tests fail and not garbage ([Pull request #2492](https://github.com/ESMValGroup/ESMValTool/pull/2492)) [@valeriupredoi](https://github.com/valeriupredoi)
- Implementing conda lock ([Pull request #2193](https://github.com/ESMValGroup/ESMValTool/pull/2193)) [@valeriupredoi](https://github.com/valeriupredoi)
- [Docker] Update Docker container builds with correct installations of Julia ([Pull request #2530](https://github.com/ESMValGroup/ESMValTool/pull/2530)) [@valeriupredoi](https://github.com/valeriupredoi)
- Update Linux condalock file (various pull requests) github-actions[bot]

### Installation

- Comment out release candidate channel in environment.yml ([Pull request #2417](https://github.com/ESMValGroup/ESMValTool/pull/2417)) [@zklaus](https://github.com/zklaus)
- Comment out rc channel in osx environment file ([Pull request #2421](https://github.com/ESMValGroup/ESMValTool/pull/2421)) [@valeriupredoi](https://github.com/valeriupredoi)
- Add python-cdo as conda-forge dependency in environment files to ensure cdo gets used from conda-forge and not pip ([Pull request #2469](https://github.com/ESMValGroup/ESMValTool/pull/2469)) [@valeriupredoi](https://github.com/valeriupredoi)
- Install rasterio from conda-forge and avoid issues from python=3.10 ([Pull request #2479](https://github.com/ESMValGroup/ESMValTool/pull/2479)) [@valeriupredoi](https://github.com/valeriupredoi)
- Updated dependencies with new ESMValCore version ([Pull request #2599](https://github.com/ESMValGroup/ESMValTool/pull/2599)) [@schlunma](https://github.com/schlunma)

### Improvements

- Remove use of OBS and use CMIP instead in examples/recipe_ncl.yml ([Pull request #2494](https://github.com/ESMValGroup/ESMValTool/pull/2494)) [@valeriupredoi](https://github.com/valeriupredoi)
- Expanded recipe_preprocessor_test.yml to account for new multi_model_statistics features ([Pull request #2519](https://github.com/ESMValGroup/ESMValTool/pull/2519)) [@schlunma](https://github.com/schlunma)
- Updated piControl periods for recipes that use KACE-1-0-G ([Pull request #2537](https://github.com/ESMValGroup/ESMValTool/pull/2537)) [@schlunma](https://github.com/schlunma)
- Reduced time range in recipe_globwat.yml ([Pull request #2548](https://github.com/ESMValGroup/ESMValTool/pull/2548)) [@schlunma](https://github.com/schlunma)
- Removed models with missing data from recipe_williams09climdyn.yml ([Pull request #2566](https://github.com/ESMValGroup/ESMValTool/pull/2566)) [@axel-lauer](https://github.com/axel-lauer)
- Restored original versions of recipe_schlund20esd.yml and recipe_meehl20sciadv.yml ([Pull request #2583](https://github.com/ESMValGroup/ESMValTool/pull/2583)) [@schlunma](https://github.com/schlunma)

<a id="changelog-v2-4-0"></a>

## v2.4.0

### Highlights

- ESMValTool is moving from Conda to Mamba as the preferred installation method. This will speed up the
  installation and comes with some improvements behind the scenes.
  Read more about it in [the installation guide](quickstart/installation.html.md#install).

Please also note the highlights from the corresponding ESMValCore release [here](https://docs.esmvaltool.org/projects/ESMValCore/en/latest/changelog.html#changelog-v2-4-0).
Thanks to that ESMValTool has gained the following features:

- Download any missing data that is available on the ESGF automatically.
- Resume previous runs, reusing expensive pre-processing results.

This release includes

### Bug fixes

- Fixed recipe_meehl20sciadv.yml for ESMValCore 2.3 ([Pull request #2253](https://github.com/ESMValGroup/ESMValTool/pull/2253)) [@schlunma](https://github.com/schlunma)
- Fix provenance of NCL figures created using the log_provenance function ([Pull request #2279](https://github.com/ESMValGroup/ESMValTool/pull/2279)) [@bouweandela](https://github.com/bouweandela)
- Fix bug in ClimWIP brunner19 recipe when plotting ([Pull request #2226](https://github.com/ESMValGroup/ESMValTool/pull/2226)) [@lukasbrunner](https://github.com/lukasbrunner)
- Pin docutils <0.17 to fix sphinx build with rtd theme ([Pull request #2312](https://github.com/ESMValGroup/ESMValTool/pull/2312)) [@zklaus](https://github.com/zklaus)
- Fix example recipes ([Pull request #2338](https://github.com/ESMValGroup/ESMValTool/pull/2338)) [@valeriupredoi](https://github.com/valeriupredoi)
- Do not add bounds to plev (plev19) in era interim cmorizer ([Pull request #2328](https://github.com/ESMValGroup/ESMValTool/pull/2328)) [@valeriupredoi](https://github.com/valeriupredoi)
- Fix problem with pip 21.3 that prevents installation from source ([Pull request #2344](https://github.com/ESMValGroup/ESMValTool/pull/2344)) [@zklaus](https://github.com/zklaus)
- Add title to recipe embedded in test_diagnostic_run.py ([Pull request #2353](https://github.com/ESMValGroup/ESMValTool/pull/2353)) [@zklaus](https://github.com/zklaus)
- Fix capitalization of obs4MIPs ([Pull request #2368](https://github.com/ESMValGroup/ESMValTool/pull/2368)) [@bouweandela](https://github.com/bouweandela)
- Specify that areacella is needed for area statistics in the Python example recipe ([Pull request #2371](https://github.com/ESMValGroup/ESMValTool/pull/2371)) [@bouweandela](https://github.com/bouweandela)
- Enabling variable obs550lt1aer in recipes ([Pull request #2388](https://github.com/ESMValGroup/ESMValTool/pull/2388)) [@remi-kazeroni](https://github.com/remi-kazeroni)
- Update a diagnostic to new Iris version ([Pull request #2390](https://github.com/ESMValGroup/ESMValTool/pull/2390)) [@katjaweigel](https://github.com/katjaweigel)
- Fixed bug in provenance tracking of ecs_scatter.ncl ([Pull request #2391](https://github.com/ESMValGroup/ESMValTool/pull/2391)) [@schlunma](https://github.com/schlunma)
- Fix provenance issue in pv_capacity_factor.R ([Pull request #2392](https://github.com/ESMValGroup/ESMValTool/pull/2392)) [@katjaweigel](https://github.com/katjaweigel)
- Remove obsolete write_plots option from R diagnostics ([Pull request #2395](https://github.com/ESMValGroup/ESMValTool/pull/2395)) [@zklaus](https://github.com/zklaus)
- Fix arctic ocean diagnostic ([Pull request #2397](https://github.com/ESMValGroup/ESMValTool/pull/2397)) [@zklaus](https://github.com/zklaus)
- Fix sea ice drift recipe and script ([Pull request #2404](https://github.com/ESMValGroup/ESMValTool/pull/2404)) [@sloosvel](https://github.com/sloosvel)
- Adapt diagnostic script to new version of iris ([Pull request #2403](https://github.com/ESMValGroup/ESMValTool/pull/2403)) [@zklaus](https://github.com/zklaus)
- Fix ocean multimap ([Pull request #2406](https://github.com/ESMValGroup/ESMValTool/pull/2406)) [@zklaus](https://github.com/zklaus)
- Fix diagnostic that uses xarray: dtype correctly set and harmonize xarray and matplotlib ([Pull request #2409](https://github.com/ESMValGroup/ESMValTool/pull/2409)) [@zklaus](https://github.com/zklaus)
- Deactivate provenance logging for plots in thermodyn toolbox ([Pull request #2414](https://github.com/ESMValGroup/ESMValTool/pull/2414)) [@zklaus](https://github.com/zklaus)

### Deprecations

- Removed write_plots and write_netcdf from some NCL diagnostics ([Pull request #2293](https://github.com/ESMValGroup/ESMValTool/pull/2293)) [@schlunma](https://github.com/schlunma)
- Fixed provenance logging of all python diagnostics by removing ‘plot_file’ entry ([Pull request #2296](https://github.com/ESMValGroup/ESMValTool/pull/2296)) [@schlunma](https://github.com/schlunma)
- Do not deprecate classes Variable, Variables and Datasets on a specific version ([Pull request #2286](https://github.com/ESMValGroup/ESMValTool/pull/2286)) [@schlunma](https://github.com/schlunma)
- Remove obsolete write_netcdf option from ncl diagnostic scripts ([Pull request #2387](https://github.com/ESMValGroup/ESMValTool/pull/2387)) [@zklaus](https://github.com/zklaus)
- Remove write plots from ocean diagnostics ([Pull request #2393](https://github.com/ESMValGroup/ESMValTool/pull/2393)) [@valeriupredoi](https://github.com/valeriupredoi)
- More removals of instances of write_plots from Python diagnostics (appears to be the final removal from Py diags) ([Pull request #2394](https://github.com/ESMValGroup/ESMValTool/pull/2394)) [@valeriupredoi](https://github.com/valeriupredoi)

### Documentation

- List Manuel Schlund as release manager for v2.5 ([Pull request #2268](https://github.com/ESMValGroup/ESMValTool/pull/2268)) [@bouweandela](https://github.com/bouweandela)
- GlobWat fix download links and gdal command ([Pull request #2334](https://github.com/ESMValGroup/ESMValTool/pull/2334)) [@babdollahi](https://github.com/babdollahi)
- Add titles to recipes authored by predoi_valeriu ([Pull request #2333](https://github.com/ESMValGroup/ESMValTool/pull/2333)) [@valeriupredoi](https://github.com/valeriupredoi)
- Added titles to recipes maintained by lauer_axel ([Pull request #2332](https://github.com/ESMValGroup/ESMValTool/pull/2332)) [@axel-lauer](https://github.com/axel-lauer)
- Update the documentation of the GRACE CMORizer ([Pull request #2349](https://github.com/ESMValGroup/ESMValTool/pull/2349)) [@remi-kazeroni](https://github.com/remi-kazeroni)
- Add titles in BSC recipes ([Pull request #2351](https://github.com/ESMValGroup/ESMValTool/pull/2351)) [@sloosvel](https://github.com/sloosvel)
- Update esmvalcore dependency to 2.4.0rc1 ([Pull request #2348](https://github.com/ESMValGroup/ESMValTool/pull/2348)) [@zklaus](https://github.com/zklaus)
- Add titles to recipes maintained by Peter Kalverla ([Pull request #2356](https://github.com/ESMValGroup/ESMValTool/pull/2356)) [@Peter9192](https://github.com/Peter9192)
- Adding titles to the recipes with maintainer hb326 ([Pull request #2358](https://github.com/ESMValGroup/ESMValTool/pull/2358)) [@hb326](https://github.com/hb326)
- Add title for zmnam as for #2354 ([Pull request #2363](https://github.com/ESMValGroup/ESMValTool/pull/2363)) [@fserva](https://github.com/fserva)
- Added recipe titles the the ocean recipes.  ([Pull request #2364](https://github.com/ESMValGroup/ESMValTool/pull/2364)) [@ledm](https://github.com/ledm)
- Update recipe_thermodyn_diagtool.yml - add title ([Pull request #2365](https://github.com/ESMValGroup/ESMValTool/pull/2365)) [@ValerioLembo](https://github.com/ValerioLembo)
- Fix provenance of figures of several R diagnostics ([Pull request #2300](https://github.com/ESMValGroup/ESMValTool/pull/2300)) [@bouweandela](https://github.com/bouweandela)
- Adding titles to Mattia’s recipes ([Pull request #2367](https://github.com/ESMValGroup/ESMValTool/pull/2367)) [@remi-kazeroni](https://github.com/remi-kazeroni)
- Adding titles to wenzel recipes ([Pull request #2366](https://github.com/ESMValGroup/ESMValTool/pull/2366)) [@hb326](https://github.com/hb326)
- Fix formatting of some recipe titles merged from PR 2364 ([Pull request #2372](https://github.com/ESMValGroup/ESMValTool/pull/2372)) [@zklaus](https://github.com/zklaus)
- Adding titles to Bjoern’s recipes ([Pull request #2369](https://github.com/ESMValGroup/ESMValTool/pull/2369)) [@remi-kazeroni](https://github.com/remi-kazeroni)
- Add titles to ocean recipes (maintainer Lovato) ([Pull request #2375](https://github.com/ESMValGroup/ESMValTool/pull/2375)) [@tomaslovato](https://github.com/tomaslovato)
- Add titles for three c3s-magic recipes ([Pull request #2378](https://github.com/ESMValGroup/ESMValTool/pull/2378)) [@zklaus](https://github.com/zklaus)
- Add title for recipe maintained by Ruth Lorenz ([Pull request #2379](https://github.com/ESMValGroup/ESMValTool/pull/2379)) [@zklaus](https://github.com/zklaus)
- Fix toymodel recipe ([Pull request #2381](https://github.com/ESMValGroup/ESMValTool/pull/2381)) Javier Vegas-Regidor
- Added titles for recipes of maintainer schlund_manuel ([Pull request #2377](https://github.com/ESMValGroup/ESMValTool/pull/2377)) [@schlunma](https://github.com/schlunma)
- Write_plots and titles for deangelis15nat, li17natcc, martin18grl, pv_capacity_factor ([Pull request #2382](https://github.com/ESMValGroup/ESMValTool/pull/2382)) [@katjaweigel](https://github.com/katjaweigel)
- Add titles for some recipes ([Pull request #2383](https://github.com/ESMValGroup/ESMValTool/pull/2383)) [@zklaus](https://github.com/zklaus)
- Adding titles for recipes by von Hardenberg and Arnone ([Pull request #2384](https://github.com/ESMValGroup/ESMValTool/pull/2384)) [@zklaus](https://github.com/zklaus)
- Last two missing titles ([Pull request #2386](https://github.com/ESMValGroup/ESMValTool/pull/2386)) [@valeriupredoi](https://github.com/valeriupredoi)
- Update documentation on downloading data ([Pull request #2370](https://github.com/ESMValGroup/ESMValTool/pull/2370)) [@bouweandela](https://github.com/bouweandela)
- Fix installation instructions for Julia ([Pull request #2335](https://github.com/ESMValGroup/ESMValTool/pull/2335)) [@zklaus](https://github.com/zklaus)
- Fix provenance of Julia example diagnostic ([Pull request #2289](https://github.com/ESMValGroup/ESMValTool/pull/2289)) [@bouweandela](https://github.com/bouweandela)
- Added notes on use of mamba in the installation documentation chapter ([Pull request #2236](https://github.com/ESMValGroup/ESMValTool/pull/2236)) [@valeriupredoi](https://github.com/valeriupredoi)
- Update version number for 2.4.0 release ([Pull request #2410](https://github.com/ESMValGroup/ESMValTool/pull/2410)) [@zklaus](https://github.com/zklaus)
- Update release schedule for 2.4.0 ([Pull request #2412](https://github.com/ESMValGroup/ESMValTool/pull/2412)) [@zklaus](https://github.com/zklaus)
- Update changelog for 2.4.0 release ([Pull request #2411](https://github.com/ESMValGroup/ESMValTool/pull/2411)) [@zklaus](https://github.com/zklaus)

### Diagnostics

- Add all available CMIP5 and CMIP6 models to recipe_impact.yml ([Pull request #2251](https://github.com/ESMValGroup/ESMValTool/pull/2251)) [@bouweandela](https://github.com/bouweandela)
- Add Fig. 6, 7 and 9 of Bock20jgr ([Pull request #2252](https://github.com/ESMValGroup/ESMValTool/pull/2252)) [@LisaBock](https://github.com/LisaBock)
- Generalize recipe_validation\* diagnostic to work with identical control and experiment dataset names ([Pull request #2284](https://github.com/ESMValGroup/ESMValTool/pull/2284)) [@valeriupredoi](https://github.com/valeriupredoi)
- Add missing preprocessor to recipe_gier2020bg and adapt to available data ([Pull request #2399](https://github.com/ESMValGroup/ESMValTool/pull/2399)) [@bettina-gier](https://github.com/bettina-gier)
- Removed custom version of AtmosphereSigmaFactory in diagnostics ([Pull request #2405](https://github.com/ESMValGroup/ESMValTool/pull/2405)) [@schlunma](https://github.com/schlunma)

### Observational and re-analysis dataset support

- Replace recipe_era5.yml with recipe_daily_era5.yml ([Pull request #2182](https://github.com/ESMValGroup/ESMValTool/pull/2182)) [@SarahAlidoost](https://github.com/SarahAlidoost)
- Update WOA cmorizer for WOA18 and WOA13v2 ([Pull request #1812](https://github.com/ESMValGroup/ESMValTool/pull/1812)) [@LisaBock](https://github.com/LisaBock)
- GLODAP v2.2016 ocean data cmorizer ([Pull request #2185](https://github.com/ESMValGroup/ESMValTool/pull/2185)) [@tomaslovato](https://github.com/tomaslovato)
- Updated GCP CMORizer ([Pull request #2295](https://github.com/ESMValGroup/ESMValTool/pull/2295)) [@schlunma](https://github.com/schlunma)

### Automatic testing

- Add a cylc suite to run all recipes ([Pull request #2219](https://github.com/ESMValGroup/ESMValTool/pull/2219)) [@bouweandela](https://github.com/bouweandela)
- Retire test with Python 3.6 from full development Github Actions test ([Pull request #2229](https://github.com/ESMValGroup/ESMValTool/pull/2229)) [@valeriupredoi](https://github.com/valeriupredoi)
- Remove Python 3.6 tests from GitHub Actions ([Pull request #2264](https://github.com/ESMValGroup/ESMValTool/pull/2264)) [@valeriupredoi](https://github.com/valeriupredoi)
- Unpin upper bound for iris (previously was at <3.0.4) ([Pull request #2266](https://github.com/ESMValGroup/ESMValTool/pull/2266)) [@valeriupredoi](https://github.com/valeriupredoi)
- Pin latest esmvalcore to allow use of the bugfix release 2.3.1 always ([Pull request #2269](https://github.com/ESMValGroup/ESMValTool/pull/2269)) [@valeriupredoi](https://github.com/valeriupredoi)
- Add apt update so Julia gets found and installed by Docker ([Pull request #2290](https://github.com/ESMValGroup/ESMValTool/pull/2290)) [@valeriupredoi](https://github.com/valeriupredoi)
- Use mamba for environment update and creation in the Docker container build on DockerHub ([Pull request #2297](https://github.com/ESMValGroup/ESMValTool/pull/2297)) [@valeriupredoi](https://github.com/valeriupredoi)
- Docker container experimental - run a full env solve with mamba instead of a conda update ([Pull request #2306](https://github.com/ESMValGroup/ESMValTool/pull/2306)) [@valeriupredoi](https://github.com/valeriupredoi)
- Full use of mamba in Github Actions source install test and use generic Python 3.7 (removing the very specific 3.7.10) ([Pull request #2287](https://github.com/ESMValGroup/ESMValTool/pull/2287)) [@valeriupredoi](https://github.com/valeriupredoi)
- Replace use of conda with mamba for conda_install test on Circle CI ([Pull request #2237](https://github.com/ESMValGroup/ESMValTool/pull/2237)) [@valeriupredoi](https://github.com/valeriupredoi)
- Update circleci configuration ([Pull request #2357](https://github.com/ESMValGroup/ESMValTool/pull/2357)) [@zklaus](https://github.com/zklaus)

### Installation

- Remove mpich from conda dependencies list ([Pull request #2343](https://github.com/ESMValGroup/ESMValTool/pull/2343)) [@valeriupredoi](https://github.com/valeriupredoi)

### Improvements

- Add script for extracting a list of input files from the provenance ([Pull request #2278](https://github.com/ESMValGroup/ESMValTool/pull/2278)) [@bouweandela](https://github.com/bouweandela)
- Update github actions ([Pull request #2360](https://github.com/ESMValGroup/ESMValTool/pull/2360)) [@zklaus](https://github.com/zklaus)
- Removed ‘write_plots’ from all NCL diagnostics ([Pull request #2331](https://github.com/ESMValGroup/ESMValTool/pull/2331)) [@axel-lauer](https://github.com/axel-lauer)
- Update and modernize config-user-example.yml ([Pull request #2374](https://github.com/ESMValGroup/ESMValTool/pull/2374)) [@valeriupredoi](https://github.com/valeriupredoi)

<a id="changelog-v2-3-0"></a>

## v2.3.0

This release includes

### Bug fixes

- Indent block to pick up and raise exception if cmorizer data not found (TierX dir is not there) ([Pull request #1877](https://github.com/ESMValGroup/ESMValTool/pull/1877)) [@valeriupredoi](https://github.com/valeriupredoi)
- Skip recipe filler tests until we have a new release since GA tests are failing ([Pull request #2089](https://github.com/ESMValGroup/ESMValTool/pull/2089)) [@valeriupredoi](https://github.com/valeriupredoi)
- Fixed broken link to contributions in README ([Pull request #2102](https://github.com/ESMValGroup/ESMValTool/pull/2102)) [@schlunma](https://github.com/schlunma)
- Fix recipe filler for the case the variable doesn’t contain short_name ([Pull request #2104](https://github.com/ESMValGroup/ESMValTool/pull/2104)) [@valeriupredoi](https://github.com/valeriupredoi)
- Add fix for iris longitude bug to ClimWIP ([Pull request #2107](https://github.com/ESMValGroup/ESMValTool/pull/2107)) [@lukasbrunner](https://github.com/lukasbrunner)
- Update for outdated link to reference Déandreis et al. (2014). ([Pull request #2076](https://github.com/ESMValGroup/ESMValTool/pull/2076)) [@katjaweigel](https://github.com/katjaweigel)
- Fixed recipes for ESMValCore 2.3.0 ([Pull request #2203](https://github.com/ESMValGroup/ESMValTool/pull/2203)) [@schlunma](https://github.com/schlunma)
- Fix the WFDE5 cmorizer ([Pull request #2211](https://github.com/ESMValGroup/ESMValTool/pull/2211)) [@remi-kazeroni](https://github.com/remi-kazeroni)
- Fix broken CMORizer log message if no Tier directory exists ([Pull request #2207](https://github.com/ESMValGroup/ESMValTool/pull/2207)) [@jmrgonza](https://github.com/jmrgonza)
- Fix bug in ClimWIP basic test recipe when plotting ([Pull request #2225](https://github.com/ESMValGroup/ESMValTool/pull/2225)) [@lukasbrunner](https://github.com/lukasbrunner)
- Fix bug in ClimWIP advanced test recipe when plotting ([Pull request #2227](https://github.com/ESMValGroup/ESMValTool/pull/2227)) [@lukasbrunner](https://github.com/lukasbrunner)
- Adjust time range for the WDFE5 dataset in the recipe_check_obs.yml ([Pull request #2232](https://github.com/ESMValGroup/ESMValTool/pull/2232)) [@remi-kazeroni](https://github.com/remi-kazeroni)
- Fix plot and provenance of recipe_consecdrydays ([Pull request #2244](https://github.com/ESMValGroup/ESMValTool/pull/2244)) [@bouweandela](https://github.com/bouweandela)

### Documentation

- Improving the README.md file with a more appealing look and bit more info ([Pull request #2065](https://github.com/ESMValGroup/ESMValTool/pull/2065)) [@valeriupredoi](https://github.com/valeriupredoi)
- Update plot title martin18grl ([Pull request #2080](https://github.com/ESMValGroup/ESMValTool/pull/2080)) [@katjaweigel](https://github.com/katjaweigel)
- Update contribution guidelines ([Pull request #2031](https://github.com/ESMValGroup/ESMValTool/pull/2031)) [@bouweandela](https://github.com/bouweandela)
- Update links in pull request template to point to latest documentation ([Pull request #2083](https://github.com/ESMValGroup/ESMValTool/pull/2083)) [@bouweandela](https://github.com/bouweandela)
- Update release schedule ([Pull request #2081](https://github.com/ESMValGroup/ESMValTool/pull/2081)) [@bouweandela](https://github.com/bouweandela)
- Updates to contribution guidelines ([Pull request #2092](https://github.com/ESMValGroup/ESMValTool/pull/2092)) [@bouweandela](https://github.com/bouweandela)
- Update documentation for ERA5 with new variables ([Pull request #2111](https://github.com/ESMValGroup/ESMValTool/pull/2111)) [@lukasbrunner](https://github.com/lukasbrunner)
- Add OSX installation instructions to docs ([Pull request #2115](https://github.com/ESMValGroup/ESMValTool/pull/2115)) [@bvreede](https://github.com/bvreede)
- Instructions to use pre-installed versions on HPC clusters ([Pull request #2197](https://github.com/ESMValGroup/ESMValTool/pull/2197)) [@remi-kazeroni](https://github.com/remi-kazeroni)
- Add functional Autoassess diagnostics: land surface metrics: permafrost, soil moisture, surface radiation ([Pull request #2170](https://github.com/ESMValGroup/ESMValTool/pull/2170)) [@valeriupredoi](https://github.com/valeriupredoi)
- Add citation info in recipe_eady_growth_rate.yml ([Pull request #2188](https://github.com/ESMValGroup/ESMValTool/pull/2188)) [@sloosvel](https://github.com/sloosvel)
- Update version number to 2.3.0 ([Pull request #2213](https://github.com/ESMValGroup/ESMValTool/pull/2213)) [@zklaus](https://github.com/zklaus)
- Update release schedule for 2.3.0 ([Pull request #2247](https://github.com/ESMValGroup/ESMValTool/pull/2247)) [@zklaus](https://github.com/zklaus)
- Changelog update to v2.3.0 ([Pull request #2214](https://github.com/ESMValGroup/ESMValTool/pull/2214)) [@zklaus](https://github.com/zklaus)

### Diagnostics

- Added figures 8 and 10 to recipe_bock20jgr.yml ([Pull request #2074](https://github.com/ESMValGroup/ESMValTool/pull/2074)) [@schlunma](https://github.com/schlunma)
- Add hydrological forcing comparison recipe ([Pull request #2013](https://github.com/ESMValGroup/ESMValTool/pull/2013)) [@stefsmeets](https://github.com/stefsmeets)
- Added recipe for Meehl et al., Sci. Adv. (2020) ([Pull request #2094](https://github.com/ESMValGroup/ESMValTool/pull/2094)) [@schlunma](https://github.com/schlunma)
- Add GlobWat recipe and diagnostic  ([Pull request #1808](https://github.com/ESMValGroup/ESMValTool/pull/1808)) [@babdollahi](https://github.com/babdollahi)
- Add ClimWIP recipe to reproduce Brunner et al. 2019 ([Pull request #2109](https://github.com/ESMValGroup/ESMValTool/pull/2109)) [@lukasbrunner](https://github.com/lukasbrunner)
- Update Climwip recipe to reproduce brunner2020esd ([Pull request #1859](https://github.com/ESMValGroup/ESMValTool/pull/1859)) [@ruthlorenz](https://github.com/ruthlorenz)
- Update recipe_thermodyn_diagtool.yml: code improvements and more user options ([Pull request #1391](https://github.com/ESMValGroup/ESMValTool/pull/1391)) [@ValerioLembo](https://github.com/ValerioLembo)
- Remove model AWI-CM-1-1-MR from recipe_impact.yml ([Pull request #2238](https://github.com/ESMValGroup/ESMValTool/pull/2238)) [@bouweandela](https://github.com/bouweandela)
- PV capacity factor for ESMValTool GMD paper  ([Pull request #2153](https://github.com/ESMValGroup/ESMValTool/pull/2153)) [@katjaweigel](https://github.com/katjaweigel)

### Observational and re-analysis dataset support

- Cmorize wfde5 ([Pull request #1991](https://github.com/ESMValGroup/ESMValTool/pull/1991)) [@mwjury](https://github.com/mwjury)
- Make cmorizer utils funcs public in utilities.py and add some numpy style docstrings ([Pull request #2206](https://github.com/ESMValGroup/ESMValTool/pull/2206)) [@valeriupredoi](https://github.com/valeriupredoi)
- CMORizer for CLARA-AVHRR cloud data ([Pull request #2101](https://github.com/ESMValGroup/ESMValTool/pull/2101)) [@axel-lauer](https://github.com/axel-lauer)
- Update of ESACCI-CLOUD CMORizer ([Pull request #2144](https://github.com/ESMValGroup/ESMValTool/pull/2144)) [@axel-lauer](https://github.com/axel-lauer)

### Automatic testing

- Force latest Python in empty environment in conda install CI test ([Pull request #2069](https://github.com/ESMValGroup/ESMValTool/pull/2069)) [@valeriupredoi](https://github.com/valeriupredoi)
- Removed imports from private sklearn modules and improved test coverage of custom_sklearn.py ([Pull request #2078](https://github.com/ESMValGroup/ESMValTool/pull/2078)) [@schlunma](https://github.com/schlunma)
- Move private \_(global)_stock_cube from esmvacore.preprocessor._regrid to cmorizer ([Pull request #2087](https://github.com/ESMValGroup/ESMValTool/pull/2087)) [@valeriupredoi](https://github.com/valeriupredoi)
- Try mamba install esmvaltool ([Pull request #2125](https://github.com/ESMValGroup/ESMValTool/pull/2125)) [@valeriupredoi](https://github.com/valeriupredoi)
- Reinstate OSX Github Action tests ([Pull request #2110](https://github.com/ESMValGroup/ESMValTool/pull/2110)) [@valeriupredoi](https://github.com/valeriupredoi)
- Pin mpich to avoid default install of 3.4.1 and 3.4.2 with external_0 builds ([Pull request #2220](https://github.com/ESMValGroup/ESMValTool/pull/2220)) [@valeriupredoi](https://github.com/valeriupredoi)
- Include test sources in distribution ([Pull request #2234](https://github.com/ESMValGroup/ESMValTool/pull/2234)) [@zklaus](https://github.com/zklaus)
- Pin iris<3.0.4 to ensure we still (sort of) support Python 3.6 ([Pull request #2246](https://github.com/ESMValGroup/ESMValTool/pull/2246)) [@valeriupredoi](https://github.com/valeriupredoi)

### Installation

- Fix conda build by skipping documentation test ([Pull request #2058](https://github.com/ESMValGroup/ESMValTool/pull/2058)) Javier Vegas-Regidor
- Update pin on esmvalcore pick up esmvalcore=2.3.0 ([Pull request #2200](https://github.com/ESMValGroup/ESMValTool/pull/2200)) [@valeriupredoi](https://github.com/valeriupredoi)
- Pin Python to 3.9 for development installation ([Pull request #2208](https://github.com/ESMValGroup/ESMValTool/pull/2208)) [@bouweandela](https://github.com/bouweandela)

### Improvements

- Add EUCP and IS-ENES3 projects to config-references ([Pull request #2066](https://github.com/ESMValGroup/ESMValTool/pull/2066)) [@Peter9192](https://github.com/Peter9192)
- Fix flake8 tests on CircleCI ([Pull request #2070](https://github.com/ESMValGroup/ESMValTool/pull/2070)) [@bouweandela](https://github.com/bouweandela)
- Added recipe filler. ([Pull request #1707](https://github.com/ESMValGroup/ESMValTool/pull/1707)) [@ledm](https://github.com/ledm)
- Update use of fx vars to new syntax  ([Pull request #2145](https://github.com/ESMValGroup/ESMValTool/pull/2145)) [@sloosvel](https://github.com/sloosvel)
- Add recipe for climate impact research ([Pull request #2072](https://github.com/ESMValGroup/ESMValTool/pull/2072)) [@Peter9192](https://github.com/Peter9192)
- Update references “master” to “main” ([Pull request #2172](https://github.com/ESMValGroup/ESMValTool/pull/2172)) [@axel-lauer](https://github.com/axel-lauer)
- Force git to ignore VSCode workspace files ([Pull request #2186](https://github.com/ESMValGroup/ESMValTool/pull/2186)) Javier Vegas-Regidor
- Update to new ESMValTool logo ([Pull request #2168](https://github.com/ESMValGroup/ESMValTool/pull/2168)) [@axel-lauer](https://github.com/axel-lauer)
- Python cmorizers for CDR1 and CDR2 ESACCI H2O (TCWV=prw) data. ([Pull request #2152](https://github.com/ESMValGroup/ESMValTool/pull/2152)) [@katjaweigel](https://github.com/katjaweigel)
- Remove obsolete conda package (closes #2100) ([Pull request #2103](https://github.com/ESMValGroup/ESMValTool/pull/2103)) [@zklaus](https://github.com/zklaus)

<a id="changelog-v2-2-0"></a>

## v2.2.0

### Highlights

ESMValTool is now using the recently released [Iris 3](https://scitools-iris.readthedocs.io/en/latest/whatsnew/3.0.html).
We acknowledge that this change may impact your work, as Iris 3 introduces
several changes that are not backward-compatible, but we think that moving forward is the best
decision for the tool in the long term.

This release includes

### Bug fixes

- Bugfix: time weights in time_operations ([Pull request #1956](https://github.com/ESMValGroup/ESMValTool/pull/1956)) [@axel-lauer](https://github.com/axel-lauer)
- Fix issues with bibtex references ([Pull request #1955](https://github.com/ESMValGroup/ESMValTool/pull/1955)) [@stefsmeets](https://github.com/stefsmeets)
- Fix ImportError for configure_logging ([Pull request #1976](https://github.com/ESMValGroup/ESMValTool/pull/1976)) [@stefsmeets](https://github.com/stefsmeets)
- Add required functional parameters for extract time in recipe_er5.yml ([Pull request #1978](https://github.com/ESMValGroup/ESMValTool/pull/1978)) [@valeriupredoi](https://github.com/valeriupredoi)
- Revert “Fix ImportError for configure_logging” ([Pull request #1992](https://github.com/ESMValGroup/ESMValTool/pull/1992)) [@bouweandela](https://github.com/bouweandela)
- Fix import of esmvalcore \_logging module in cmorize_obs.py ([Pull request #2020](https://github.com/ESMValGroup/ESMValTool/pull/2020)) [@valeriupredoi](https://github.com/valeriupredoi)
- Fix logging import in cmorize_obs again since last merge was nulled by pre-commit hooks ([Pull request #2022](https://github.com/ESMValGroup/ESMValTool/pull/2022)) [@valeriupredoi](https://github.com/valeriupredoi)
- Refactor the functions in derive_evspsblpot due to new iris ([Pull request #2023](https://github.com/ESMValGroup/ESMValTool/pull/2023)) [@SarahAlidoost](https://github.com/SarahAlidoost)
- Avoid importing private ESMValCore functions in CMORizer ([Pull request #2027](https://github.com/ESMValGroup/ESMValTool/pull/2027)) [@bouweandela](https://github.com/bouweandela)
- Fix extract_seasons in validation recipe  ([Pull request #2054](https://github.com/ESMValGroup/ESMValTool/pull/2054)) Javier Vegas-Regidor

### Deprecations

- Deprecate classes Variable, Variables and Datasets ([Pull request #1944](https://github.com/ESMValGroup/ESMValTool/pull/1944)) [@schlunma](https://github.com/schlunma)
- Python 3.9: remove pynio as dependency and replace with rasterio and pin Matplotlib>3.3.1 and pin cartopy>=0.18 ([Pull request #1997](https://github.com/ESMValGroup/ESMValTool/pull/1997)) [@valeriupredoi](https://github.com/valeriupredoi)
- Removed write_plots and write_netcdf in some python diagnostics ([Pull request #2036](https://github.com/ESMValGroup/ESMValTool/pull/2036)) [@schlunma](https://github.com/schlunma)

### Documentation

- Update instructions on making a release ([Pull request #1867](https://github.com/ESMValGroup/ESMValTool/pull/1867)) [@bouweandela](https://github.com/bouweandela)
- Update review.rst ([Pull request #1917](https://github.com/ESMValGroup/ESMValTool/pull/1917)) [@axel-lauer](https://github.com/axel-lauer)
- Add guidance on how to review a pull request ([Pull request #1872](https://github.com/ESMValGroup/ESMValTool/pull/1872)) [@bouweandela](https://github.com/bouweandela)
- Adding tutorial links to documentation ([Pull request #1927](https://github.com/ESMValGroup/ESMValTool/pull/1927)) [@hb326](https://github.com/hb326)
- Added bibtex file for schlund20jgr ([Pull request #1928](https://github.com/ESMValGroup/ESMValTool/pull/1928)) [@schlunma](https://github.com/schlunma)
- Documentation contact added the actual email for the mailing list ([Pull request #1938](https://github.com/ESMValGroup/ESMValTool/pull/1938)) [@valeriupredoi](https://github.com/valeriupredoi)
- Make CircleCI badge specific to main branch ([Pull request #1831](https://github.com/ESMValGroup/ESMValTool/pull/1831)) [@bouweandela](https://github.com/bouweandela)
- Documentation on how to move code from a private repository to a public repository ([Pull request #1920](https://github.com/ESMValGroup/ESMValTool/pull/1920)) [@hb326](https://github.com/hb326)
- Refine pull request review guidelines ([Pull request #1924](https://github.com/ESMValGroup/ESMValTool/pull/1924)) [@stefsmeets](https://github.com/stefsmeets)
- Update release schedule ([Pull request #1948](https://github.com/ESMValGroup/ESMValTool/pull/1948)) [@zklaus](https://github.com/zklaus)
- Improve contact info and move to more prominent location ([Pull request #1950](https://github.com/ESMValGroup/ESMValTool/pull/1950)) [@bouweandela](https://github.com/bouweandela)
- Add some maintainers to some recipes that are missing them ([Pull request #1970](https://github.com/ESMValGroup/ESMValTool/pull/1970)) [@valeriupredoi](https://github.com/valeriupredoi)
- Update core team info ([Pull request #1973](https://github.com/ESMValGroup/ESMValTool/pull/1973)) [@axel-lauer](https://github.com/axel-lauer)
- Combine installation from source instructions and add common issues ([Pull request #1971](https://github.com/ESMValGroup/ESMValTool/pull/1971)) [@bouweandela](https://github.com/bouweandela)
- Update iris documentation URL for sphinx ([Pull request #2003](https://github.com/ESMValGroup/ESMValTool/pull/2003)) [@bouweandela](https://github.com/bouweandela)
- Fix iris documentation link(s) with new iris3 location on readthedocs ([Pull request #2012](https://github.com/ESMValGroup/ESMValTool/pull/2012)) [@valeriupredoi](https://github.com/valeriupredoi)
- Document how to run tests for installation verification  ([Pull request #1847](https://github.com/ESMValGroup/ESMValTool/pull/1847)) [@valeriupredoi](https://github.com/valeriupredoi)
- List Remi Kazeroni as a code owner and sole merger of CMORizers ([Pull request #2017](https://github.com/ESMValGroup/ESMValTool/pull/2017)) [@bouweandela](https://github.com/bouweandela)
- Install documentation: mention that we build conda package with python>=3.7 ([Pull request #2030](https://github.com/ESMValGroup/ESMValTool/pull/2030)) [@valeriupredoi](https://github.com/valeriupredoi)
- Recipe and documentation update for ERA5-Land. ([Pull request #1906](https://github.com/ESMValGroup/ESMValTool/pull/1906)) [@katjaweigel](https://github.com/katjaweigel)
- Update changelog and changelog tool for v2.2.0 ([Pull request #2043](https://github.com/ESMValGroup/ESMValTool/pull/2043)) Javier Vegas-Regidor
- Final update to the changelog for v2.2.0 ([Pull request #2056](https://github.com/ESMValGroup/ESMValTool/pull/2056)) Javier Vegas-Regidor

### Diagnostics

- Add mapplot diagnostic to ClimWIP ([Pull request #1864](https://github.com/ESMValGroup/ESMValTool/pull/1864)) [@lukasbrunner](https://github.com/lukasbrunner)
- Add the option to weight variable groups in ClimWIP ([Pull request #1856](https://github.com/ESMValGroup/ESMValTool/pull/1856)) [@lukasbrunner](https://github.com/lukasbrunner)
- Implementation of ensemble member recognition to the ClimWIP diagnostic ([Pull request #1852](https://github.com/ESMValGroup/ESMValTool/pull/1852)) [@lukasbrunner](https://github.com/lukasbrunner)
- Restructure ClimWIP ([Pull request #1919](https://github.com/ESMValGroup/ESMValTool/pull/1919)) [@lukasbrunner](https://github.com/lukasbrunner)
- Diagnostic for recipe_eyring13jgr.yml Fig. 12 ([Pull request #1922](https://github.com/ESMValGroup/ESMValTool/pull/1922)) [@LisaBock](https://github.com/LisaBock)
- Added changes in shared functions necessary for schlund20esd ([Pull request #1967](https://github.com/ESMValGroup/ESMValTool/pull/1967)) [@schlunma](https://github.com/schlunma)
- Adding recipe and diagnostics for Gier et al 2020 ([Pull request #1914](https://github.com/ESMValGroup/ESMValTool/pull/1914)) [@bettina-gier](https://github.com/bettina-gier)
- Added recipe, diagnostics and documentation for Schlund et al., ESD (2020) ([Pull request #2015](https://github.com/ESMValGroup/ESMValTool/pull/2015)) [@schlunma](https://github.com/schlunma)
- Add PRIMAVERA Eady Growth Rate diagnostic ([Pull request #1285](https://github.com/ESMValGroup/ESMValTool/pull/1285)) [@sloosvel](https://github.com/sloosvel)
- Implement shape parameter calibration for ClimWIP ([Pull request #1905](https://github.com/ESMValGroup/ESMValTool/pull/1905)) [@lukasbrunner](https://github.com/lukasbrunner)

### Observational and re-analysis dataset support

- Extended ESRL cmorizer ([Pull request #1937](https://github.com/ESMValGroup/ESMValTool/pull/1937)) [@bettina-gier](https://github.com/bettina-gier)
- Cmorizer for GRACE data ([Pull request #1694](https://github.com/ESMValGroup/ESMValTool/pull/1694)) [@bascrezee](https://github.com/bascrezee)
- Cmorizer for latest ESACCI-SST data ([Pull request #1895](https://github.com/ESMValGroup/ESMValTool/pull/1895)) [@valeriupredoi](https://github.com/valeriupredoi)
- Fix longitude in ESRL cmorizer ([Pull request #1988](https://github.com/ESMValGroup/ESMValTool/pull/1988)) [@bettina-gier](https://github.com/bettina-gier)
- Selectively turn off fixing bounds for coordinates during cmorization with utilities.py ([Pull request #2014](https://github.com/ESMValGroup/ESMValTool/pull/2014)) [@valeriupredoi](https://github.com/valeriupredoi)
- Cmorize hadcrut5 ([Pull request #1977](https://github.com/ESMValGroup/ESMValTool/pull/1977)) [@mwjury](https://github.com/mwjury)
- Cmorize gpcc masking ([Pull request #1995](https://github.com/ESMValGroup/ESMValTool/pull/1995)) [@mwjury](https://github.com/mwjury)
- Cmorize_utils_save_1mon_Amon ([Pull request #1990](https://github.com/ESMValGroup/ESMValTool/pull/1990)) [@mwjury](https://github.com/mwjury)
- Cmorize gpcc fix ([Pull request #1982](https://github.com/ESMValGroup/ESMValTool/pull/1982)) [@mwjury](https://github.com/mwjury)
- Fix flake8 raised by develop test in cmorize_obs_gpcc.py ([Pull request #2038](https://github.com/ESMValGroup/ESMValTool/pull/2038)) [@valeriupredoi](https://github.com/valeriupredoi)

### Automatic testing

- Switched miniconda conda setup hooks for Github Actions workflows ([Pull request #1913](https://github.com/ESMValGroup/ESMValTool/pull/1913)) [@valeriupredoi](https://github.com/valeriupredoi)
- Fix style issue ([Pull request #1929](https://github.com/ESMValGroup/ESMValTool/pull/1929)) [@bouweandela](https://github.com/bouweandela)
- Fix mlr test with solution that works for CentOS too ([Pull request #1936](https://github.com/ESMValGroup/ESMValTool/pull/1936)) [@valeriupredoi](https://github.com/valeriupredoi)
- Temporary deactivation Github Actions on OSX ([Pull request #1939](https://github.com/ESMValGroup/ESMValTool/pull/1939)) [@valeriupredoi](https://github.com/valeriupredoi)
- Fix conda installation test on CircleCI ([Pull request #1952](https://github.com/ESMValGroup/ESMValTool/pull/1952)) [@bouweandela](https://github.com/bouweandela)
- Github Actions: change time for cron job that installs from conda ([Pull request #1969](https://github.com/ESMValGroup/ESMValTool/pull/1969)) [@valeriupredoi](https://github.com/valeriupredoi)
- CI upload relevant artifacts for test job ([Pull request #1999](https://github.com/ESMValGroup/ESMValTool/pull/1999)) [@valeriupredoi](https://github.com/valeriupredoi)
- Github Actions test that runs with the latest ESMValCore main ([Pull request #1989](https://github.com/ESMValGroup/ESMValTool/pull/1989)) [@valeriupredoi](https://github.com/valeriupredoi)
- Introduce python 39 in Github Actions tests ([Pull request #2029](https://github.com/ESMValGroup/ESMValTool/pull/2029)) [@valeriupredoi](https://github.com/valeriupredoi)
- Remove test for conda package installation on Python 3.6 ([Pull request #2033](https://github.com/ESMValGroup/ESMValTool/pull/2033)) [@valeriupredoi](https://github.com/valeriupredoi)
- Update codacy coverage reporter to fix coverage ([Pull request #2039](https://github.com/ESMValGroup/ESMValTool/pull/2039)) [@bouweandela](https://github.com/bouweandela)

### Installation

- Simplify installation of R development dependencies ([Pull request #1930](https://github.com/ESMValGroup/ESMValTool/pull/1930)) [@bouweandela](https://github.com/bouweandela)
- Fix docker build ([Pull request #1934](https://github.com/ESMValGroup/ESMValTool/pull/1934)) [@bouweandela](https://github.com/bouweandela)
- Use new conda environment for installing ESMValTool in Docker containers ([Pull request #1993](https://github.com/ESMValGroup/ESMValTool/pull/1993)) [@bouweandela](https://github.com/bouweandela)
- Fix conda build ([Pull request #2026](https://github.com/ESMValGroup/ESMValTool/pull/2026)) [@bouweandela](https://github.com/bouweandela)

### Improvements

- Allow multiple references for a cmorizer script ([Pull request #1953](https://github.com/ESMValGroup/ESMValTool/pull/1953)) [@SarahAlidoost](https://github.com/SarahAlidoost)
- Add GRACE to the recipe check_obs ([Pull request #1963](https://github.com/ESMValGroup/ESMValTool/pull/1963)) [@remi-kazeroni](https://github.com/remi-kazeroni)
- Align ESMValTool to ESMValCore=2.2.0 (adopt iris3, fix environment for new Core release) ([Pull request #1874](https://github.com/ESMValGroup/ESMValTool/pull/1874)) [@stefsmeets](https://github.com/stefsmeets)
- Make it possible to use write_plots and write_netcdf from recipe instead of config-user.yml ([Pull request #2018](https://github.com/ESMValGroup/ESMValTool/pull/2018)) [@bouweandela](https://github.com/bouweandela)
- Revise lisflood and hype recipes ([Pull request #2035](https://github.com/ESMValGroup/ESMValTool/pull/2035)) [@SarahAlidoost](https://github.com/SarahAlidoost)
- Set version to 2.2.0 ([Pull request #2042](https://github.com/ESMValGroup/ESMValTool/pull/2042)) Javier Vegas-Regidor

<a id="changelog-v2-1-1"></a>

## v2.1.1

This release includes

### Improvements

- Fix the conda build on CircleCI ([Pull request #1883](https://github.com/ESMValGroup/ESMValTool/pull/1883)) [@bouweandela](https://github.com/bouweandela)
- Pin matplotlib to <3.3 and add compilers ([Pull request #1898](https://github.com/ESMValGroup/ESMValTool/pull/1898)) [@bouweandela](https://github.com/bouweandela)
- Pin esmvaltool subpackages to the same version and build as the esmvaltool conda package ([Pull request #1899](https://github.com/ESMValGroup/ESMValTool/pull/1899)) [@bouweandela](https://github.com/bouweandela)

### Documentation

- Release notes v2.1.1 ([Pull request #1932](https://github.com/ESMValGroup/ESMValTool/pull/1932)) [@valeriupredoi](https://github.com/valeriupredoi)

<a id="changelog-v2-1-0"></a>

## v2.1.0

This release includes

### Diagnostics

- Add extra steps to diagnostic to make output of hydrology/recipe_lisflood.yml usable by the LISFLOOD model ([Pull request #1737](https://github.com/ESMValGroup/ESMValTool/pull/1737)) [@JaroCamphuijsen](https://github.com/JaroCamphuijsen)
- Recipe to reproduce the 2014 KNMI Climate Scenarios (kcs). ([Pull request #1667](https://github.com/ESMValGroup/ESMValTool/pull/1667)) [@Peter9192](https://github.com/Peter9192)
- Implement the climwip weighting scheme in a recipe and diagnostic ([Pull request #1648](https://github.com/ESMValGroup/ESMValTool/pull/1648)) [@JaroCamphuijsen](https://github.com/JaroCamphuijsen)
- Remove unreviewed autoassess recipes ([Pull request #1840](https://github.com/ESMValGroup/ESMValTool/pull/1840)) [@valeriupredoi](https://github.com/valeriupredoi)
- Changes in shared scripts for Schlund et al., JGR: Biogeosciences, 2020 ([Pull request #1845](https://github.com/ESMValGroup/ESMValTool/pull/1845)) [@schlunma](https://github.com/schlunma)
- Updated derivation test recipe ([Pull request #1790](https://github.com/ESMValGroup/ESMValTool/pull/1790)) [@schlunma](https://github.com/schlunma)
- Support for multiple model occurrence in perf main ([Pull request #1649](https://github.com/ESMValGroup/ESMValTool/pull/1649)) [@bettina-gier](https://github.com/bettina-gier)
- Add recipe and diagnostics for Schlund et al., JGR: Biogeosciences, 2020 ([Pull request #1860](https://github.com/ESMValGroup/ESMValTool/pull/1860)) [@schlunma](https://github.com/schlunma)
- Adjust recipe_extract_shape.yml to recent changes in the example diagnostic.py ([Pull request #1880](https://github.com/ESMValGroup/ESMValTool/pull/1880)) [@bouweandela](https://github.com/bouweandela)

### Documentation

- Add pip installation instructions ([Pull request #1783](https://github.com/ESMValGroup/ESMValTool/pull/1783)) [@bouweandela](https://github.com/bouweandela)
- Add installation instruction for R and Julia dependencies tot pip install ([Pull request #1787](https://github.com/ESMValGroup/ESMValTool/pull/1787)) [@bouweandela](https://github.com/bouweandela)
- Avoid autodocsumm 0.2.0 and update documentation build dependencies ([Pull request #1794](https://github.com/ESMValGroup/ESMValTool/pull/1794)) [@bouweandela](https://github.com/bouweandela)
- Add more information on working on cluster attached to ESGF node ([Pull request #1821](https://github.com/ESMValGroup/ESMValTool/pull/1821)) [@bouweandela](https://github.com/bouweandela)
- Add release strategy to community documentation ([Pull request #1809](https://github.com/ESMValGroup/ESMValTool/pull/1809)) [@zklaus](https://github.com/zklaus)
- Update esmvaltool run command everywhere in documentation ([Pull request #1820](https://github.com/ESMValGroup/ESMValTool/pull/1820)) [@bouweandela](https://github.com/bouweandela)
- Add more info on documenting a recipe ([Pull request #1795](https://github.com/ESMValGroup/ESMValTool/pull/1795)) [@bouweandela](https://github.com/bouweandela)
- Improve the Python example diagnostic and documentation ([Pull request #1827](https://github.com/ESMValGroup/ESMValTool/pull/1827)) [@bouweandela](https://github.com/bouweandela)
- Improve description of how to use draft_release_notes.py ([Pull request #1848](https://github.com/ESMValGroup/ESMValTool/pull/1848)) [@bouweandela](https://github.com/bouweandela)
- Update changelog for release 2.1 ([Pull request #1886](https://github.com/ESMValGroup/ESMValTool/pull/1886)) [@valeriupredoi](https://github.com/valeriupredoi)

### Improvements

- Fix R installation in WSL ([Pull request #1789](https://github.com/ESMValGroup/ESMValTool/pull/1789)) Javier Vegas-Regidor
- Add pre-commit for linting/formatting ([Pull request #1796](https://github.com/ESMValGroup/ESMValTool/pull/1796)) [@stefsmeets](https://github.com/stefsmeets)
- Speed up tests on CircleCI and use pytest to run them ([Pull request #1804](https://github.com/ESMValGroup/ESMValTool/pull/1804)) [@bouweandela](https://github.com/bouweandela)
- Move pre-commit excludes to top-level and correct order of lintr and styler ([Pull request #1805](https://github.com/ESMValGroup/ESMValTool/pull/1805)) [@stefsmeets](https://github.com/stefsmeets)
- Remove isort setup to fix formatting conflict with yapf ([Pull request #1815](https://github.com/ESMValGroup/ESMValTool/pull/1815)) [@stefsmeets](https://github.com/stefsmeets)
- GitHub Actions ([Pull request #1806](https://github.com/ESMValGroup/ESMValTool/pull/1806)) [@valeriupredoi](https://github.com/valeriupredoi)
- Fix yapf-isort import formatting conflict ([Pull request #1822](https://github.com/ESMValGroup/ESMValTool/pull/1822)) [@stefsmeets](https://github.com/stefsmeets)
- Replace vmprof with vprof as the default profiler ([Pull request #1829](https://github.com/ESMValGroup/ESMValTool/pull/1829)) [@bouweandela](https://github.com/bouweandela)
- Update ESMValCore v2.1.0 requirement ([Pull request #1839](https://github.com/ESMValGroup/ESMValTool/pull/1839)) Javier Vegas-Regidor
- Pin iris to version 2 ([Pull request #1881](https://github.com/ESMValGroup/ESMValTool/pull/1881)) [@bouweandela](https://github.com/bouweandela)
- Pin eccodes to not use eccodes=2.19.0 for cdo to work fine ([Pull request #1869](https://github.com/ESMValGroup/ESMValTool/pull/1869)) [@valeriupredoi](https://github.com/valeriupredoi)
- Increase version to 2.1.0 and add release notes ([Pull request #1868](https://github.com/ESMValGroup/ESMValTool/pull/1868)) [@valeriupredoi](https://github.com/valeriupredoi)
- Github Actions Build Packages and Deploy tests (conda and PyPi) ([Pull request #1858](https://github.com/ESMValGroup/ESMValTool/pull/1858)) [@valeriupredoi](https://github.com/valeriupredoi)

### Observational and re-analysis dataset support

- Added CMORizer for Scripps-CO2-KUM ([Pull request #1857](https://github.com/ESMValGroup/ESMValTool/pull/1857)) [@schlunma](https://github.com/schlunma)

<a id="changelog-v2-0-0"></a>

## v2.0.0

This release includes

### Bug fixes

- Fix pep8-naming errors and fix zmnam diagnostic ([Pull request #1702](https://github.com/ESMValGroup/ESMValTool/pull/1702)) [@bouweandela](https://github.com/bouweandela)
- Fix keyword argument in cmorize_obs ([Pull request #1721](https://github.com/ESMValGroup/ESMValTool/pull/1721)) [@mattiarighi](https://github.com/mattiarighi)
- Fixed JMA-TRANSCOM CMORizer ([Pull request #1735](https://github.com/ESMValGroup/ESMValTool/pull/1735)) [@schlunma](https://github.com/schlunma)
- Fix bug in extract_doi_value ([Pull request #1734](https://github.com/ESMValGroup/ESMValTool/pull/1734)) [@bascrezee](https://github.com/bascrezee)
- Fix small errors in the arctic_ocean diagnostic ([Pull request #1722](https://github.com/ESMValGroup/ESMValTool/pull/1722)) [@koldunovn](https://github.com/koldunovn)
- Flatten ancestor lists for diag_spei.R and diag_spi.R. ([Pull request #1745](https://github.com/ESMValGroup/ESMValTool/pull/1745)) [@katjaweigel](https://github.com/katjaweigel)
- Fix for recipe_ocean_ice_extent.yml ([Pull request #1744](https://github.com/ESMValGroup/ESMValTool/pull/1744)) [@mattiarighi](https://github.com/mattiarighi)
- Fix recipe_combined_indices.yml provenance ([Pull request #1746](https://github.com/ESMValGroup/ESMValTool/pull/1746)) Javier Vegas-Regidor
- Fix provenance in recipe_multimodel_products ([Pull request #1747](https://github.com/ESMValGroup/ESMValTool/pull/1747)) Javier Vegas-Regidor
- Exclude FGOALS-g2 due to ESMValCore issue #728 ([Pull request #1749](https://github.com/ESMValGroup/ESMValTool/pull/1749)) [@mattiarighi](https://github.com/mattiarighi)
- Fix recipe_modes_of_variability ([Pull request #1753](https://github.com/ESMValGroup/ESMValTool/pull/1753)) Javier Vegas-Regidor
- Flatten lists for ancestors for hyint to prevent nested lists. ([Pull request #1752](https://github.com/ESMValGroup/ESMValTool/pull/1752)) [@katjaweigel](https://github.com/katjaweigel)
- Fix bug in cmorize_obs_eppley_vgpm_modis.py (#1729) ([Pull request #1759](https://github.com/ESMValGroup/ESMValTool/pull/1759)) [@tomaslovato](https://github.com/tomaslovato)
- Correct mip for clltkisccp in example derive preprocessor recipe ([Pull request #1768](https://github.com/ESMValGroup/ESMValTool/pull/1768)) [@bouweandela](https://github.com/bouweandela)
- Update date conversion in recipe_hype.yml ([Pull request #1769](https://github.com/ESMValGroup/ESMValTool/pull/1769)) [@bouweandela](https://github.com/bouweandela)
- Fix recipe_correlation.yml ([Pull request #1767](https://github.com/ESMValGroup/ESMValTool/pull/1767)) [@bouweandela](https://github.com/bouweandela)
- Add attribute positive: down to plev coordinate in ERA-Interim CMORizer ([Pull request #1771](https://github.com/ESMValGroup/ESMValTool/pull/1771)) [@bouweandela](https://github.com/bouweandela)
- Fix sispeed in recipe_preprocessor_derive_test ([Pull request #1772](https://github.com/ESMValGroup/ESMValTool/pull/1772)) Javier Vegas-Regidor
- Fix extreme events and extreme index ancestors ([Pull request #1774](https://github.com/ESMValGroup/ESMValTool/pull/1774)) [@katjaweigel](https://github.com/katjaweigel)
- Correct date in output filenames of ERA5 CMORizer recipe ([Pull request #1773](https://github.com/ESMValGroup/ESMValTool/pull/1773)) [@bouweandela](https://github.com/bouweandela)
- Exclude WOA from multi-model stats in recipe_ocean_bgc ([Pull request #1778](https://github.com/ESMValGroup/ESMValTool/pull/1778)) [@mattiarighi](https://github.com/mattiarighi)

### Diagnostics

- Enhancement of the hyint recipe to include etccdi indices ([Pull request #1133](https://github.com/ESMValGroup/ESMValTool/pull/1133)) [@earnone](https://github.com/earnone)
- Add lazy regridding for wflow diagnostic ([Pull request #1630](https://github.com/ESMValGroup/ESMValTool/pull/1630)) [@bouweandela](https://github.com/bouweandela)
- Miles default domains to include lat=0 ([Pull request #1626](https://github.com/ESMValGroup/ESMValTool/pull/1626)) [@jhardenberg](https://github.com/jhardenberg)
- Miles: selection of reference dataset based on experiment ([Pull request #1632](https://github.com/ESMValGroup/ESMValTool/pull/1632)) [@jhardenberg](https://github.com/jhardenberg)
- New recipe/diagnostic:  recipe_li17natcc.yml for Axels GMD Paper ([Pull request #1567](https://github.com/ESMValGroup/ESMValTool/pull/1567)) [@katjaweigel](https://github.com/katjaweigel)
- New recipe/diagnostics: recipe_deangelis_for_gmdpart4.yml for Axels GMD Paper ([Pull request #1576](https://github.com/ESMValGroup/ESMValTool/pull/1576)) [@katjaweigel](https://github.com/katjaweigel)
- EWaterCycle: Add recipe to prepare input for LISFLOOD ([Pull request #1298](https://github.com/ESMValGroup/ESMValTool/pull/1298)) [@sverhoeven](https://github.com/sverhoeven)
- Use area weighted regridding in wflow diagnostic ([Pull request #1643](https://github.com/ESMValGroup/ESMValTool/pull/1643)) [@bouweandela](https://github.com/bouweandela)
- Workaround for permetrics recipe until Iris3 ([Pull request #1674](https://github.com/ESMValGroup/ESMValTool/pull/1674)) [@mattiarighi](https://github.com/mattiarighi)
- C3S_511_MPQB_bas-features ([Pull request #1465](https://github.com/ESMValGroup/ESMValTool/pull/1465)) [@bascrezee](https://github.com/bascrezee)
- Additional Land perfmetrics ([Pull request #1641](https://github.com/ESMValGroup/ESMValTool/pull/1641)) [@bettina-gier](https://github.com/bettina-gier)
- Necessary diagnostic from eyring06jgr for the release of version2 ([Pull request #1686](https://github.com/ESMValGroup/ESMValTool/pull/1686)) [@hb326](https://github.com/hb326)
- Drought characteristics based on Martin2018 and SPI for gmd paper ([Pull request #1689](https://github.com/ESMValGroup/ESMValTool/pull/1689)) [@katjaweigel](https://github.com/katjaweigel)
- Additional features and bugfixes for recipe anav13clim ([Pull request #1723](https://github.com/ESMValGroup/ESMValTool/pull/1723)) [@bettina-gier](https://github.com/bettina-gier)
- Gmd laueretal2020 revisions ([Pull request #1725](https://github.com/ESMValGroup/ESMValTool/pull/1725)) [@axel-lauer](https://github.com/axel-lauer)
- Wenzel16nature ([Pull request #1692](https://github.com/ESMValGroup/ESMValTool/pull/1692)) [@zechlau](https://github.com/zechlau)
- Add mask albedolandcover ([Pull request #1673](https://github.com/ESMValGroup/ESMValTool/pull/1673)) [@bascrezee](https://github.com/bascrezee)
- IPCC AR5 fig. 9.3 (seasonality) ([Pull request #1726](https://github.com/ESMValGroup/ESMValTool/pull/1726)) [@axel-lauer](https://github.com/axel-lauer)
- Added additional emergent constraints on ECS ([Pull request #1585](https://github.com/ESMValGroup/ESMValTool/pull/1585)) [@schlunma](https://github.com/schlunma)
- A diagnostic to evaluate the turnover times of land ecosystem carbon ([Pull request #1395](https://github.com/ESMValGroup/ESMValTool/pull/1395)) koir-su
- Removed multi_model_statistics step in recipe_oceans_example.yml as a workaround ([Pull request #1779](https://github.com/ESMValGroup/ESMValTool/pull/1779)) [@valeriupredoi](https://github.com/valeriupredoi)

### Documentation

- Extend getting started instructions to obtain config-user.yml ([Pull request #1642](https://github.com/ESMValGroup/ESMValTool/pull/1642)) [@Peter9192](https://github.com/Peter9192)
- Extend information about native6 support on RTD ([Pull request #1652](https://github.com/ESMValGroup/ESMValTool/pull/1652)) [@Peter9192](https://github.com/Peter9192)
- Update citation of ESMValTool paper in the doc ([Pull request #1664](https://github.com/ESMValGroup/ESMValTool/pull/1664)) [@mattiarighi](https://github.com/mattiarighi)
- Updated references to documentation (now docs.esmvaltool.org) ([Pull request #1679](https://github.com/ESMValGroup/ESMValTool/pull/1679)) [@axel-lauer](https://github.com/axel-lauer)
- Replace dead link with ESGF link. ([Pull request #1681](https://github.com/ESMValGroup/ESMValTool/pull/1681)) [@mattiarighi](https://github.com/mattiarighi)
- Add all European grants to Zenodo ([Pull request #1682](https://github.com/ESMValGroup/ESMValTool/pull/1682)) [@bouweandela](https://github.com/bouweandela)
- Update Sphinx to v3 or later ([Pull request #1685](https://github.com/ESMValGroup/ESMValTool/pull/1685)) [@bouweandela](https://github.com/bouweandela)
- Small fix to number of models in ensclus documentation ([Pull request #1691](https://github.com/ESMValGroup/ESMValTool/pull/1691)) [@jhardenberg](https://github.com/jhardenberg)
- Move draft_release_notes.py from ESMValCore to here and update ([Pull request #1701](https://github.com/ESMValGroup/ESMValTool/pull/1701)) [@bouweandela](https://github.com/bouweandela)
- Improve the installation instructions ([Pull request #1634](https://github.com/ESMValGroup/ESMValTool/pull/1634)) [@valeriupredoi](https://github.com/valeriupredoi)
- Improve description of how to implement provenance in diagnostic ([Pull request #1750](https://github.com/ESMValGroup/ESMValTool/pull/1750)) [@SarahAlidoost](https://github.com/SarahAlidoost)
- Update command line interface documentation and add links to ESMValCore configuration documentation ([Pull request #1776](https://github.com/ESMValGroup/ESMValTool/pull/1776)) [@bouweandela](https://github.com/bouweandela)
- Documentation on how to find shapefiles for hydrology recipes ([Pull request #1777](https://github.com/ESMValGroup/ESMValTool/pull/1777)) [@JaroCamphuijsen](https://github.com/JaroCamphuijsen)

### Improvements

- Pin flake8<3.8.0 ([Pull request #1635](https://github.com/ESMValGroup/ESMValTool/pull/1635)) [@valeriupredoi](https://github.com/valeriupredoi)
- Update conda package path in more places ([Pull request #1636](https://github.com/ESMValGroup/ESMValTool/pull/1636)) [@bouweandela](https://github.com/bouweandela)
- Remove curly brackets around issue number in pull request template ([Pull request #1637](https://github.com/ESMValGroup/ESMValTool/pull/1637)) [@bouweandela](https://github.com/bouweandela)
- Fix style issue in test ([Pull request #1639](https://github.com/ESMValGroup/ESMValTool/pull/1639)) [@bouweandela](https://github.com/bouweandela)
- Update Codacy badges ([Pull request #1662](https://github.com/ESMValGroup/ESMValTool/pull/1662)) [@bouweandela](https://github.com/bouweandela)
- Support extra installation methods in R ([Pull request #1360](https://github.com/ESMValGroup/ESMValTool/pull/1360)) Javier Vegas-Regidor
- Add ncdf4.helpers package as a dependency again ([Pull request #1678](https://github.com/ESMValGroup/ESMValTool/pull/1678)) [@bouweandela](https://github.com/bouweandela)
- Speed up conda installation ([Pull request #1677](https://github.com/ESMValGroup/ESMValTool/pull/1677)) [@bouweandela](https://github.com/bouweandela)
- Update CMORizers and recipes for ESMValCore v2.0.0 ([Pull request #1699](https://github.com/ESMValGroup/ESMValTool/pull/1699)) [@SarahAlidoost](https://github.com/SarahAlidoost)
- Update setup.py for PyPI package ([Pull request #1700](https://github.com/ESMValGroup/ESMValTool/pull/1700)) [@bouweandela](https://github.com/bouweandela)
- Cleanup recipe headers before the release ([Pull request #1740](https://github.com/ESMValGroup/ESMValTool/pull/1740)) [@mattiarighi](https://github.com/mattiarighi)
- Add colortables as esmvaltool subcommand ([Pull request #1666](https://github.com/ESMValGroup/ESMValTool/pull/1666)) Javier Vegas-Regidor
- Increase version to v2.0.0 ([Pull request #1756](https://github.com/ESMValGroup/ESMValTool/pull/1756)) [@bouweandela](https://github.com/bouweandela)
- Update job script ([Pull request #1757](https://github.com/ESMValGroup/ESMValTool/pull/1757)) [@mattiarighi](https://github.com/mattiarighi)
- Read authors and description from .zenodo.json ([Pull request #1758](https://github.com/ESMValGroup/ESMValTool/pull/1758)) [@bouweandela](https://github.com/bouweandela)
- Update docker recipe to install from source ([Pull request #1651](https://github.com/ESMValGroup/ESMValTool/pull/1651)) Javier Vegas-Regidor

### Observational and re-analysis dataset support

- Cmorize aphro ma ([Pull request #1555](https://github.com/ESMValGroup/ESMValTool/pull/1555)) [@mwjury](https://github.com/mwjury)
- Respectable testing for cmorizers/obs/utilities.py and cmorizers/obs/cmorize_obs.py ([Pull request #1517](https://github.com/ESMValGroup/ESMValTool/pull/1517)) [@valeriupredoi](https://github.com/valeriupredoi)
- Fix start year in recipe_check_obs ([Pull request #1638](https://github.com/ESMValGroup/ESMValTool/pull/1638)) [@mattiarighi](https://github.com/mattiarighi)
- Cmorizer for the PERSIANN-CDR precipitation data ([Pull request #1633](https://github.com/ESMValGroup/ESMValTool/pull/1633)) [@hb326](https://github.com/hb326)
- Cmorize eobs ([Pull request #1554](https://github.com/ESMValGroup/ESMValTool/pull/1554)) [@mwjury](https://github.com/mwjury)
- Update download cds satellite lai fapar ([Pull request #1654](https://github.com/ESMValGroup/ESMValTool/pull/1654)) [@bascrezee](https://github.com/bascrezee)
- Added monthly mean vars (ta, va, zg) to era5 cmorizer via recipe ([Pull request #1644](https://github.com/ESMValGroup/ESMValTool/pull/1644)) [@egalytska](https://github.com/egalytska)
- Make format time check more flexible ([Pull request #1661](https://github.com/ESMValGroup/ESMValTool/pull/1661)) [@mattiarighi](https://github.com/mattiarighi)
- Exclude od550lt1aer from recipe_check_obs.yml ([Pull request #1720](https://github.com/ESMValGroup/ESMValTool/pull/1720)) [@mattiarighi](https://github.com/mattiarighi)
- PERSIANN-CDR cmorizer update: adding the capability to save monthly mean files ([Pull request #1728](https://github.com/ESMValGroup/ESMValTool/pull/1728)) [@hb326](https://github.com/hb326)
- Add standard_name attribute to lon and lat in cmorize_obs_esacci_oc.py ([Pull request #1760](https://github.com/ESMValGroup/ESMValTool/pull/1760)) [@tomaslovato](https://github.com/tomaslovato)
- Allow for incomplete months on daily frequency in cmorizer ncl utilities ([Pull request #1754](https://github.com/ESMValGroup/ESMValTool/pull/1754)) [@mattiarighi](https://github.com/mattiarighi)
- Fix AURA-TES cmorizer ([Pull request #1766](https://github.com/ESMValGroup/ESMValTool/pull/1766)) [@mattiarighi](https://github.com/mattiarighi)

<a id="changelog-v2-0-0b4"></a>

## v2.0.0b4

This release includes

### Bug fixes

- Fix HALOE plev coordinate ([Pull request #1590](https://github.com/ESMValGroup/ESMValTool/pull/1590)) [@mattiarighi](https://github.com/mattiarighi)
- Fix tro3 units in HALOE ([Pull request #1591](https://github.com/ESMValGroup/ESMValTool/pull/1591)) [@mattiarighi](https://github.com/mattiarighi)

### Diagnostics

- Applicate sea ice negative feedback ([Pull request #1299](https://github.com/ESMValGroup/ESMValTool/pull/1299)) Javier Vegas-Regidor
- Add Russell18jgr ocean diagnostics ([Pull request #1592](https://github.com/ESMValGroup/ESMValTool/pull/1592)) [@bouweandela](https://github.com/bouweandela)
- Refactor marrmot recipe and diagnostic to use ERA5 daily data made by new cmorizer ([Pull request #1600](https://github.com/ESMValGroup/ESMValTool/pull/1600)) [@SarahAlidoost](https://github.com/SarahAlidoost)
- In recipe_wflow, use daily ERA5 data from the new cmorizer. ([Pull request #1599](https://github.com/ESMValGroup/ESMValTool/pull/1599)) [@Peter9192](https://github.com/Peter9192)
- In wflow diagnostic, calculate PET after(!) interpolation and lapse rate correction ([Pull request #1618](https://github.com/ESMValGroup/ESMValTool/pull/1618)) [@jeromaerts](https://github.com/jeromaerts)
- Fixed wenz14jgr ([Pull request #1562](https://github.com/ESMValGroup/ESMValTool/pull/1562)) [@zechlau](https://github.com/zechlau)
- Update portrait_plot.ncl ([Pull request #1625](https://github.com/ESMValGroup/ESMValTool/pull/1625)) [@bettina-gier](https://github.com/bettina-gier)

### Documentation

- Restructure documentation ([Pull request #1587](https://github.com/ESMValGroup/ESMValTool/pull/1587)) [@bouweandela](https://github.com/bouweandela)
- Add more links to documentation ([Pull request #1595](https://github.com/ESMValGroup/ESMValTool/pull/1595)) [@bouweandela](https://github.com/bouweandela)
- Update links in readme ([Pull request #1598](https://github.com/ESMValGroup/ESMValTool/pull/1598)) [@bouweandela](https://github.com/bouweandela)
- Minor improvements to installation documentation ([Pull request #1608](https://github.com/ESMValGroup/ESMValTool/pull/1608)) [@bouweandela](https://github.com/bouweandela)
- Add info for new mailing list to documentation. ([Pull request #1607](https://github.com/ESMValGroup/ESMValTool/pull/1607)) [@bjoernbroetz](https://github.com/bjoernbroetz)
- Update making a release documentation ([Pull request #1627](https://github.com/ESMValGroup/ESMValTool/pull/1627)) [@bouweandela](https://github.com/bouweandela)

### Improvements

- Avoid broken pytest-html plugin ([Pull request #1583](https://github.com/ESMValGroup/ESMValTool/pull/1583)) [@bouweandela](https://github.com/bouweandela)
- Remove reference section in config-references.yml ([Pull request #1545](https://github.com/ESMValGroup/ESMValTool/pull/1545)) [@SarahAlidoost](https://github.com/SarahAlidoost)
- Various improvements to development infrastructure ([Pull request #1570](https://github.com/ESMValGroup/ESMValTool/pull/1570)) [@bouweandela](https://github.com/bouweandela)
- Install scikit-learn from conda, remove libunwind as a direct dependency ([Pull request #1611](https://github.com/ESMValGroup/ESMValTool/pull/1611)) [@valeriupredoi](https://github.com/valeriupredoi)
- Create conda subpackages and enable tests ([Pull request #1624](https://github.com/ESMValGroup/ESMValTool/pull/1624)) [@bouweandela](https://github.com/bouweandela)

### Observational and re-analysis dataset support

- Cmorizer for HALOE ([Pull request #1581](https://github.com/ESMValGroup/ESMValTool/pull/1581)) [@mattiarighi](https://github.com/mattiarighi)
- Add CMORizer for CT2019 ([Pull request #1604](https://github.com/ESMValGroup/ESMValTool/pull/1604)) [@schlunma](https://github.com/schlunma)

For older releases, see the release notes on [https://github.com/ESMValGroup/ESMValTool/releases](https://github.com/ESMValGroup/ESMValTool/releases).
