<a id="recipes-wenzel16nat"></a>

# Legacy recipe: Projected land photosynthesis constrained by changes in the seasonal cycle of atmospheric CO<sub>2</sub>

#### NOTE
This recipe has been retired and moved to the folder “archive”. This recipe
is only included for documentation purposes and not maintained any more. The
last known ESMValTool version supporting this recipe is version 2.13.0.

## Overview

Selected figures from [Wenzel et al. (2016)](https://www.nature.com/articles/nature19772) are reproduced with recipe_wenzel16nat.yml. Gross primary productivity (gpp) and atmospheric CO<sub>2</sub> concentrations at the surface  (co2s) are analyzed for the carbon cycle - concentration feedback in the historical (esmHistorical) and uncoupled (esmFixCLim1, here the carbon cycle is uncoupled to the climate response) simulations. The recipe includes a set of routines to diagnose the long-term carbon cycle - concentration feedback parameter (beta) from an ensemble of CMIP5 models and the observable change in the CO<sub>2</sub> seasonal cycle amplitude due to rising atmospheric CO<sub>2</sub> levels. As a key figure of this recipe, the diagnosed values from the models beta vs. the change in CO<sub>2</sub> amplitude are compared in a scatter plot constituting an emergent constraint.

## Available recipe and diagnostics

Recipes are stored in archive/legacy_recipes

> * recipe_wenzel16nat.yml

Diagnostics are stored in archive/legacy_diag_scripts/carbon_ec

> * carbon_beta: (1) scatter plot of annual gpp vs. annual CO<sub>2</sub> and
>   (2) barchart of gpp(2xCO<sub>2</sub>)/gpp(1xCO<sub>2</sub>); calculates beta
>   for emergent constraint (carbon_co2_cycle.ncl)
> * carbon_co2_cycle.ncl: (1) scatter plot of CO<sub>2</sub> amplitude vs.
>   annual CO<sub>2</sub>, (2) barchart of sensitivity of CO<sub>2</sub> amplitude
>   to CO<sub>2</sub>, (3) emergent constraint:
>   gpp(2xCO<sub>2</sub>)/gpp(1xCO<sub>2</sub>) vs. sensitivity of CO<sub>2</sub>
>   amplitude to CO<sub>2</sub>, (4) probability density function of constrained
>   and unconstrained sensitivity of CO<sub>2</sub> amplitude to CO<sub>2</sub>

## User settings

#### NOTE
Make sure to run this recipe with the [configuration option](https://docs.esmvaltool.org/projects/ESMValCore/en/latest/quickstart/configure.html#config-options) `max_parallel_tasks: 1`.

1. Script carbon_beta.ncl

   *Required Settings (scripts)*
   * styleset: project style for lines, colors and symbols

   *Optional Settings (scripts)*
   * bc_xmax_year: end year to calculate beta (default: use last available year of all models)
   * bc_xmin_year: start year to calculate beta (default: use first available year of all models)

   *Required settings (variables)*

   none

   *Optional settings (variables)*

   none
2. Script carbon_co2_cycle.ncl

   *Required Settings (scripts)*
   * nc_infile: path of netCDF file containing beta (output from carbon_beta.ncl)
   * styleset: project style for lines, colors and symbols

   *Optional Settings (scripts)*
   * bc_xmax_year: end year (default = last year of all model datasets available)
   * bc_xmin_year: start year (default = first year of all model datasets available)

   *Required settings (variables)*
   * reference_dataset: name of reference dataset (observations)

   *Optional settings (variables)*

   none

## Variables

* co2s (atmos, monthly mean, plev longitude latitude time)
* gpp (land, monthly mean, longitude latitude time)

## Observations and reformat scripts

* ESRL: Earth System Research Laboratory, ground-based CO<sub>2</sub> measurements

## References

* Wenzel, S., Cox, P., Eyring, V. et al., 2016, Projected land photosynthesis constrained by changes in the seasonal cycle of atmospheric CO<sub>2</sub>. Nature 538, 499501, doi: doi.org/10.1038/nature19772

## Example plots

![image](recipes/figures/wenzel16nat/fig_1.png)![image](recipes/figures/wenzel16nat/fig_2.png)![image](recipes/figures/wenzel16nat/fig_3.png)
