Skip to content
Merged
Show file tree
Hide file tree
Changes from 12 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
19 changes: 19 additions & 0 deletions doc/sphinx/source/recipes/recipe_ref.rst
Original file line number Diff line number Diff line change
Expand Up @@ -23,6 +23,9 @@ Recipes are stored in recipes
Calculate transient climate response to cumulative CO2 emissions (TCRE)
* ref/recipe_ref_cre.yml:
Maps and zonal means of longwave and shortwave cloud radiative effect
* ref/recipe_ref_sea_ice_area_basic.yml:
Seasonal cycle of Arctic (NH) and Antarctic (SH) sea ice area, time series
of Arctic September (NH) and Antarctic February (SH) sea ice area


Example plots:
Expand All @@ -42,3 +45,19 @@ Example plots:
Zonal averages of the climatological mean longwave cloud radiative
effect from CERES-EBAF Ed4.2 (solid black), ESACCI-CLOUD (dashed black),
ISCCP-FH (dotted black) and the MPI-ESM1-2-LR model (blue).

.. _fig_ref_3:
.. figure:: /recipes/figures/ref/annual_cycle_sea_ice_area_nh_ambiguous_dataset_ambiguous_mip_historical_r1i1p1f1.png
:align: center
:width: 8cm

Average seasonal cycle of the Arctic (NH) sea ice area from MPI-ESM1-2-LR
(red line) compared with OSISAF/CCI (blue line). Created with recipe_ref_sea_ice_area_basic.yml.

.. _fig_ref_4:
.. figure:: /recipes/figures/ref/timeseries_sea_ice_area_nh_sep_ambiguous_dataset_ambiguous_mip_historical_r1i1p1f1.png
:align: center
:width: 8cm

Time series of Arctic (NH) September (NH) sea ice area from MPI-ESM1-2-LR
(red line) compared with OSISAF/CCI (blue line). Created with recipe_ref_sea_ice_area_basic.yml.
168 changes: 168 additions & 0 deletions esmvaltool/recipes/ref/recipe_ref_sea_ice_area_basic.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,168 @@
# ESMValTool
---
documentation:
title: Seasonal cycle of NH/SH sea ice area
description: >
Example plot of the seasonal cycle of NH and SH sea ice area (here: CMIP6 model MPI-ESM1-2-LR).
authors:
- lauer_axel
maintainer:
- lauer_axel


datasets:
- {dataset: MPI-ESM1-2-LR, grid: gn, benchmark_dataset: true}

preprocessors:

pp_nh:
extract_region:
start_longitude: 0
end_longitude: 360
start_latitude: 30
end_latitude: 90
climate_statistics:
period: month
area_statistics:
operator: sum
convert_units:
units: 1e6 km2

pp_nh_sep:
extract_region:
start_longitude: 0
end_longitude: 360
start_latitude: 30
end_latitude: 90
extract_month:
month: 9
area_statistics:
operator: sum
convert_units:
units: 1e6 km2

pp_sh:
extract_region:
start_longitude: 0
end_longitude: 360
start_latitude: -90
end_latitude: -30
climate_statistics:
period: month
area_statistics:
operator: sum
convert_units:
units: 1e6 km2

pp_sh_feb:
extract_region:
start_longitude: 0
end_longitude: 360
start_latitude: -90
end_latitude: -30
extract_month:
month: 2
area_statistics:
operator: sum
convert_units:
units: 1e6 km2


diagnostics:

siarea_seas:
description: Create seasonal cycle plot of sea ice area.
variables:
sea_ice_area_nh: &var_basic
short_name: siconc
timerange: '1995/2014'
preprocessor: pp_nh
project: CMIP6
mip: SImon
exp: historical
ensemble: r1i1p1f1
grid: gr
reference_dataset: OSI-450-nh
additional_datasets:
- {dataset: OSI-450-nh, project: OBS, type: reanaly, version: v3, mip: OImon, tier: 2,
supplementary_variables: [{short_name: areacello, mip: fx}]}
# - {dataset: ESACCI-SEAICE, project: OBS6, tier: 2, type: sat, version: L4-SICONC-RE-SSMI-12.5kmEASE2-fv3.0-SH,
# supplementary_variables: [{short_name: areacello, mip: Ofx}]}
sea_ice_area_sh:
<<: *var_basic
preprocessor: pp_sh
reference_dataset: OSI-450-sh
additional_datasets:
- {dataset: OSI-450-sh, project: OBS, type: reanaly, version: v3, mip: OImon, tier: 2,
supplementary_variables: [{short_name: areacello, mip: fx}]}
scripts:
allplots:
script: monitor/multi_datasets.py
plot_folder: '{plot_dir}'
group_variables_by: variable_group
facet_used_for_labels: dataset
plots:
annual_cycle: &plot_basic
annual_mean_kwargs: False
pyplot_kwargs:
title: 'Sea ice area (million km2)'
plot_kwargs:
'MPI-ESM1-2-LR':
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do we want this to be hard-coded? It probably would need to be a little more flexible when implemented in the REF so that it just refers to the model that is used.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good point. Changed here: 87b2ad5

color: red
label: '{dataset}'
linestyle: '-'
linewidth: 2
zorder: 4
ESACCI-SEAICE:
color: black
label: '{dataset}'
linestyle: '-'
linewidth: 2
zorder: 3
OSI-450-nh:
color: blue
label: 'OSISAF/CCI'
linestyle: '-'
linewidth: 2
zorder: 3
OSI-450-sh:
color: blue
label: 'OSISAF/CCI'
linestyle: '-'
linewidth: 2
zorder: 3
default:
color: lightgray
label: null
linestyle: '-'
linewidth: 1
zorder: 1

siarea_min:
description: Create time series of September/March sea ice area.
variables:
sea_ice_area_nh_sep:
<<: *var_basic
timerange: '1979/2014'
preprocessor: pp_nh_sep
reference_dataset: OSI-450-nh
additional_datasets:
- {dataset: OSI-450-nh, project: OBS, type: reanaly, version: v3, mip: OImon, tier: 2,
supplementary_variables: [{short_name: areacello, mip: fx}], timerange: 1979/2020}
sea_ice_area_sh_feb:
<<: *var_basic
timerange: '1979/2014'
preprocessor: pp_sh_feb
reference_dataset: OSI-450-sh
additional_datasets:
- {dataset: OSI-450-sh, project: OBS, type: reanaly, version: v3, mip: OImon, tier: 2,
supplementary_variables: [{short_name: areacello, mip: fx}], timerange: 1979/2020}
scripts:
allplots:
script: monitor/multi_datasets.py
plot_folder: '{plot_dir}'
group_variables_by: variable_group
facet_used_for_labels: dataset
plots:
timeseries:
<<: *plot_basic
8 changes: 4 additions & 4 deletions esmvaltool/references/osi-450.bibtex
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
@misc{osi-450,
doi = {10.15770/EUM_SAF_OSI_0008},
url = {https://navigator.eumetsat.int/product/EO:EUM:DAT:MULT:OSI-450},
doi = {10.15770/EUM_SAF_OSI_0013},
url = {https://user.eumetsat.int/catalogue/EO:EUM:DAT:0826},
author = {{OSI SAF}},
keywords = {Climate, Thematic Climate Data Record, Ocean, Sea Ice},
language = {en},
title = {Global Sea Ice Concentration Climate Data Record v2.0 - Multimission},
title = {Global Sea Ice Concentration Climate Data Record v3.0 - Multimission},
publisher = {OSI SAF},
year = {2017}
year = {2022}
}