ISIMIP3 simulation protocol

Table of Contents

The simulation protocol describes the simulation scenarios, input data sets and output variables necessary to participate in the ISIMIP3 simulation round.

Please select the simulation round (ISIMIP3a, ISIMIP3b) and the sectors you are interested in from the menu on the right. The page will then adjust to your selection. The parts of the protocol, which are specific to a simulation round or sector are marked accordingly.

Last updated: 27 January 2022

Commit hash: 13363ba35db2b6545486203ea0ae9ff9097bc35f

Direct link for this selection:

Introduction

General concept

The Inter-Sectoral Impact Model Intercomparison Project (ISIMIP) provides a framework for the collation of a consistent set of climate impact data across sectors and scales. It also provides a unique opportunity for considering interactions between climate change impacts across sectors through consistent scenarios.

ISIMIP is intended to be structured in successive rounds connected to the different phases of the climate model intercomparison CMIP (ISIMIP Mission & Implementation document).

The main components of the ISIMIP framework are:

Simulation round

Historical model evaluation and attribution runs

The ISIMIP3a part of the third round framework is dedicated to i) impact model evaluation and improvement and ii) detection and attribution of observed impacts according to the framework of IPCC AR5 Working Group II Chapter 18. To this end all simulations are forced by observed climate and socio-economic information and a de-trended version of the observed climate allowing for the generation of a “no climate change” baseline (counterfactual).

GCM-based simulations assuming fixed 2015 direct human influences for the future

The ISIMIP3b part of the third simulation round is dedicated to a quantification of climate-related risks at different levels of climate change and socio-economic conditions. The group 1 simulations refer to the pre-industrial and historical period of the CMIP6-based climate simulations. Group 2 covers all future projections assuming fixed 2015 levels of socio-economic forcing and different future projections of climate (SSP126, SSP37 and SSP585). Group3 simulations account for future changes in socio-economic drivers and are intended to be started in summer 2021.

Simulation protocol

In this protocol we describe the scenarios & experiments, the different input datasets, the output variables, and how to report model results.

Throughout the protocol we use specifiers that denote a particular scenario, experiment, variable or other parameter. We use these specifiers in the tables below, in the filenames of the input data sets, and ask you to use the same specifiers in your output files. More on reporting data can be found at the end of this document.

Model versioning

To ensure consistency between ISIMIP3a and ISIMIP3b as well as the different experiments within a simulation round, we require that modelling groups use the same version of an impact model for the experiments in ISIMIP3a and ISIMIP3b. If you cannot fulfill this, please indicate that by using a suffix for your model name (e.g. simple version numbering: MODEL-v1, MODEL-v2 or following semantic versioning: MODEL-2.0.0, see also reporting model results).

This versioning does not only apply to changes in the computational logic of the model, but also to input parameters, calibration or setup. If model versions are not reported, we will name them according to the simulation round (e.g. MODEL-isimip3a). We require the strict versioning to ensure that differences between model results are fully attributable to the changes in model forcings.

Experiments & Scenarios

Experiments

In Table 1, we describe the different experiments for ISIMIP3. Each experiment contains information on climate forcing (CF) and direct human forcing (DHF). The entries for the different simulation periods denote the scenario specifiers, as explained in Tables 2-4. These specifiers are used in the file names of the corresponding input files and should also be used for the names of the output files (see report model results).

Please note that the experiments are different for ISIMIP3a and ISIMIP3b and some are sector specific. You can use the menu on the top-right of the page to select the sumulation round and sectors you are interested in.

Note regarding models requiring spin-up

For models requiring spin-up, we provide 100 years of spinclim data which is identical with the first 100 years of the counterclim data. The files are located under ISIMIP3a/InputData/climate/atmosphere/spinclim at DKRZ and in the ISIMIP Repository. If more than 100 years of spin-up are needed, these data can be repeated as often as needed.

For historical runs, use historical CO2 concentration and varying DHF, for the transition period from spin-up to the start of the experiment (1850-1900). When using a longer spin-up period that (nominally) extends back further than 1850, please keep CO₂ concentration and DHF constant at 1850 level until reaching the year corresponding to 1850.

For experiments with fixed direct human influences (1901soc, 2015soc), the spin-up should be based on the 1901 DHF or 2015 DHF, respectively.

For sector-specific experiments without direct human influence (nat), the spin-up should not use any DHF as well.

For models requiring spin-up, please use the pre-industrial control data and CO₂ concentration and DHF fixed at 1850 levels for the spin up as long as needed.

Please note that the "pre-industrial control run" from 1601-1849 is part of the regular experiments that should be reported and hence the spin-up has to be finished before that.

For experiments with fixed year-2015 direct human influences (2015soc), spin-up should be based on the 2015 DHF.

For sector-specific experiments without direct human influence (nat), the spin-up should not use any DHF as well.

Please note that there is no "pre-industrial control run" from 1601-1849 for these experiments (2015soc, nat) and hence the spin-up links directly to the historical period.

Scenario definitions

Tables 2-4 describe the different scenarios for the different simulation periods as described in Table 1. They are used in the file names of the corresponding input files and should also be used for the names of the output files (see report model results).

General note regarding sensitivity experiments

The sensitivity experiments are meant to be deviations from the default settings. So for example if your model does not at all account for changes in CO₂ concentrations (no option to switch it on or off) the run should be labeled as “default” in the sensitivity specifier of the file name even if the run would be identical to the 1901co2 sensitivity setting.

The particular sensitivity scenario for an experiment is given in the experiments table below. For most experiments no sensitivity scenario is given, so the default label applies.

General note regarding sensitivity experiments

The sensitivity experiments are meant to be deviations from the default settings. So for example if your model does not at all account for changes in CO₂ concentrations (no option to switch it on or off) the run should be labeled as default in the sensitivity specifier of the file name even if the run would be identical to the 1850co2 sensitivity setting.

The particular sensitivity scenario for an experiment is given in the experiments table below. For most experiments no sensitivity scenario is given, so the default label applies.

Input data

The base directory for input data at DKRZ is:

/work/bb0820/ISIMIP/ISIMIP3a/InputData/

The base directory for input data at DKRZ is:

/work/bb0820/ISIMIP/ISIMIP3b/InputData/

Further information on accessing ISIMIP data can be found at ISIMIP - getting started.

Note on mandatory datasets

Some of the datasets are tagged as mandatory. This does not mean that the data must be used in all cases, but if your models uses input data of this kind, we require to use the specified dataset. If an alterntive data set is used instead, we cannot consider it an ISIMIP simulation. If the mandatory label is not given, you may use alternative data (please document this clearly).

Climate forcing

The climate forcing input files can be found on DKRZ using the following pattern:

climate/atmosphere/<climate-scenario>/global/daily/historical/<climate-forcing>/<climate-forcing>_<climate-scenario>_<climate-variable>_global_daily_<start-year>_<end-year>.nc

The climate forcing input files can be found on DKRZ using the following pattern:

climate/atmosphere/bias-adjusted/global/daily/<climate-scenario>/<climate-forcing>/<climate-forcing>_<ensemble-member>_<bias-adjustment>_<climate-scenario>_<climate-variable>_global_daily_<start-year>_<end-year>.nc

# ocean data for marine-fishery
climate/ocean/uncorrected/global/monthly/<climate-scenario>/<climate-forcing>/<climate-forcing>_<ensemble-member>_<climate-scenario>_<climate-variable>_onedeg_global_daily_<start-year>_<end-year>.nc  # 1° grid
climate/ocean/uncorrected/global/monthly/<climate-scenario>/<climate-forcing>/<climate-forcing>_<ensemble-member>_<climate-scenario>_<climate-variable>_halfdeg_global_daily_<start-year>_<end-year>.nc  # 0.5° grid

Note on ocean data availability

Variable availability is mainly based on the data published in ESGF and may vary between the CMIP experiments.

Some variables are available as extracted versions from vertically resolved data. Their variable names have been suffixed with -bot (ocean bottom), -surf (surface values) or -vint (vertically integrated), respectively.

Note on climate forcing priority

The priority for the different climate forcing datasets is given in the last column of Table 5. If you cannot use all climate forcing datasets, please concentrate on those with a higher priority.

Other climate datasets

Socioeconomic forcing

Static geographic information

Output data

Output dimensions

ISIMIP output variables are usually reported with the dimensions (time,lat,lon). For variables with a number of levels (e.g. layers or depth), an alternative set of dimensions is given in the comment column in the table below. More information about level dimensions can be found here and here on the ISIMIP webpage.

Note on agriculture output

For agricultural output, variables are to be reported with the dimensions (time,lat,lon) where the time axis' unit is growing seasons since 1901-01-01 00:00:00 resp. growing seasons since 1661-01-01 00:00:00 for all variables unless these are reported on a transient time axis, e.g. 'soilmoist1m'. In many cases growing seasons are equivalent to years, as there is always only one planting event per year. However, due to temperature-sensitive growing season lengths, the growing seasons are not fully equivalent to years and users should note the difference. Reported variables on start and end of the growing season are supplied to allow allocating events to transient time axes if desired.

Please note that unless otherwise defined, the variables in ISIMIP should be reported relative to the grid cell land area.

Output variables

Sector specific identifiers

Crop priority and naming

Irrigation

Harmonization

Species

Forest stands

Lake sites

A document with additional information is maintained by the sector coordinators and provided at https://docs.google.com/spreadsheets/d/1UY_KSR02o7LtmNoOs6jOgOxdcFEKrf7MmhR2BYDlm-Q/edit#gid=555498854.

Ocean regions

Catchment gauging stations

No sector specific identifiers are available for this selection of simulation round and sectors.

Sector specific notes

Reporting per growing seasons

To resolve potential double harvests within one year, crop yields should be reported per growing season and not per calendar year. Thus, in the NetCDF output files, do not use a time dimension but instead a unitless coordinate variable with integer values; more information on how to construct these files is given below and on the ISIMIP website (https://www.isimip.org/protocol/preparing-simulation-files/).

Cumulative growing season variables such as, e.g., actual evapotranspiration or precipitation are to be accumulated over the growing season. The first season in the file (level=0) is then the first complete growing season of the time period provided by the input data without any assumed spin-up data, which equates to the growing season with the first planting after this date. To ensure that data can be matched to individual years in post-processing, it is essential to also provide the actual planting dates (as day of the year), actual planting years (year), anthesis dates (as day of the year), year of anthesis (year), maturity dates (day of the year), and year of maturity (year). This procedure is identical to the GGCMI convention (Elliott, et al., 2015).

Information about PFT-specific outputs

  • Unless otherwise defined, variables in ISIMIP should be reported relative to the grid cell land area.
  • The output provided per Plant Functional Type (PFT) should be expressed relative to the respective PFT area so that e.g. sum(gpp-pft*pft-pft)=gpp-total.
  • When your model allows several PFTs to grow on the same area and hence the total cover fraction can be more than one, please scale the PFT area to one and report this step in the model documentation on the ISIMIP homepage.
  • When your model grows the same PFT on different land-use classes, e.g. the same c3-grass represents grasses growing on natural grasslands, pasture and possible even as crop, please differentiate this in your output by defining land-use specific PFT such as c3-grass-pasture, c3-grass-natural, c3-grass-crop and report this in model documentation on the ISIMIP homepage.

Additional instructions for the health sector

  • If different realizations of the model are applied, then these should be indicated by the specifier <r>. E.g. to reflect a central, upper, and lower estimate of the ERF: <r> = lower, central, upper. Please explain the meaning of these realizations in the online model documentation; contact the ISIMIP coordination team in case of questions.
  • If data are disaggregated e.g. by age group, gender, etc., they should be reported along an additional dimension, described by an auxiliary coordinate variable, in the NetCDF files. See the example provided at https://www.isimip.org/protocol/preparing-simulation-files/.
  • For local (non-gridded) data, locations (cities/regions/countries) should be reported along an additional dimension called location, with the location name given as string in an auxiliary coordinate variable called location_name, in the NetCDF files. In addition, coordinates of the location should be reported in auxiliary variables called location_lat and location_lon. See the example provided at https://www.isimip.org/protocol/preparing-simulation-files/. The <region> specifier in the file name should be set to local. For gridded data, the <region> specifier in the file name should be global or indicate a region or country.

No sector specific notes are available for this selection of simulation round and sectors.

Reporting model results

The specification on how to submit the data, as well as further information and instructions are given on the ISIMIP website at:

https://www.isimip.org/protocol/preparing-simulation-files

It is important that you comply precisely with the formatting specified there, in order to facilitate the analysis of your simulation results in the ISIMIP framework. Incorrect formatting can seriously delay the analysis. The ISIMIP Team will be glad to assist with the preparation of these files if necessary.

File names consist of a series of identifier, separated by underscores. Things to note:

Please name the files according to a sector specific pattern:

and replace the identifiers with the specifiers given in the tables of this document. For questions or clarifications, please contact info@isimip.org or the data managers directly (isimip-data@pik‐potsdam.de) before submitting files.

References

Compo, G. P., Whitaker, J. S., Sardeshmukh, P. D., Matsui, N., Allan, R. J., Yin, X., Gleason, B. E., Vose, R. S., Rutledge, G., Bessemoulin, P., Brönnimann, S., Brunet, M., Crouthamel, R. I., Grant, A. N., Groisman, P. Y., Jones, P. D., Kruk, M. C., Kruger, A. C., Marshall, G. J., Maugeri, M., Mok, H. Y., Nordli, Ø., Ross, T. F., Trigo, R. M., Wang, X. L., Woodruff, S. D. and Worley, S. J.: The twentieth century reanalysis project, Quarterly Journal of the Royal Meteorological Society, 137(654), 1–28, doi:10.1002/qj.776, 2011.

Cucchi, M., Weedon, G. P., Amici, A., Bellouin, N., Lange, S., Müller Schmied, H., Hersbach, H. and Buontempo, C.: WFDE5: Bias-adjusted ERA5 reanalysis data for impact studies, Earth System Science Data, 12(3), 2097–2120, doi:10.5194/essd-12-2097-2020, 2020.

Dirmeyer, P. A., Gao, X., Zhao, M., Guo, Z., Oki, T. and Hanasaki, N.: GSWP-2: Multimodel Analysis and Implications for Our Perception of the Land Surface, Bulletin of the American Meteorological Society, 87(10), 1381–1398, doi:10.1175/BAMS-87-10-1381, 2006.

Dlugokencky, E. and Tans, P.: Trends in atmospheric carbon dioxide, Natl. Ocean. Atmos. Adm. Earth Syst. Res. Lab. [online] Available from: https://www.esrl.noaa.gov/gmd/ccgg/trends/, 2019.

Geiger, T.: Continuous national gross domestic product (GDP) time series for 195 countries: Past observations (1850–2005) harmonized with future projections according to the Shared Socio-economic Pathways (2006–2100), Earth System Science Data, 10(2), 847–856, doi:10.5194/essd-10-847-2018, 2018.

Hurtt, G. C., Chini, L., Sahajpal, R., Frolking, S., Bodirsky, B. L., Calvin, K., Doelman, J. C., Fisk, J., Fujimori, S., Goldewijk, K. K., Hasegawa, T., Havlik, P., Heinimann, A., Humpenöder, F., Jungclaus, J., Kaplan, J., Kennedy, J., Kristzin, T., Lawrence, D., Lawrence, P., Ma, L., Mertz, O., Pongratz, J., Popp, A., Poulter, B., Riahi, K., Shevliakova, E., Stehfest, E., Thornton, P., Tubiello, F. N., Vuuren, D. P. van and Zhang, X.: Harmonization of Global Land-Use Change and Management for the Period 850–2100 (LUH2) for CMIP6, Geoscientific Model Development Discussions, 1–65, doi:https://doi.org/10.5194/gmd-2019-360, 2020.

Karger, D. N., Lange, S., Hari, C., Reyer, C. P. O. and Zimmermann, N. E.: CHELSA-w5e5 v1.0: W5E5 v1.0 downscaled with chelsa v2.0, v1.0, doi:10.48364/ISIMIP.836809.2, 2022.

Klein Goldewijk, K., Beusen, A., Doelman, J. and Stehfest, E.: Anthropogenic land use estimates for the Holocene – HYDE 3.2, Earth System Science Data, 9(2), 927–953, doi:10.5194/essd-9-927-2017, 2017.

Lange, M., S. and Cagnazzo, C.: WFDE5 over land merged with ERA5 over the ocean (W5E5 v2.0), doi:10.48364/ISIMIP.342217, 2021.

Lange, S.: Trend-preserving bias adjustment and statistical downscaling with ISIMIP3BASD (v1.0), Geoscientific Model Development, 12(7), 3055–3070, doi:10.5194/gmd-12-3055-2019, 2019a.

Lange, S.: WFDE5 over land merged with ERA5 over the ocean (W5E5), v1.0, GFZ Data Services, doi:10.5880/pik.2019.023, 2019b.

Lange, S.: ISIMIP3BASD, v2.4.1, doi:10.5281/zenodo.3898426, 2020.

Lehner, B., Liermann, C. R., Revenga, C., Vörösmarty, C., Fekete, B., Crouzet, P., Döll, P., Endejan, M., Frenken, K., Magome, J., Nilsson, C., Robertson, J. C., Rödel, R., Sindorf, N. and Wisser, D.: Global Reservoir and Dam Database, Version 1 (GRanDv1): Dams, Revision 01. Palisades, NY, NASA Socioeconomic Data and Applications Center (SEDAC), doi:10.7927/H4N877QK, 2011a.

Lehner, B., Liermann, C. R., Revenga, C., Vörösmarty, C., Fekete, B., Crouzet, P., Döll, P., Endejan, M., Frenken, K., Magome, J., Nilsson, C., Robertson, J. C., Rödel, R., Sindorf, N. and Wisser, D.: High-resolution mapping of the world’s reservoirs and dams for sustainable river-flow management, Frontiers in Ecology and the Environment, 9(9), 494–502, doi:10.1890/100125, 2011b.

Meinshausen, M., Smith, S. J., Calvin, K., Daniel, J. S., Kainuma, M. L. T., Lamarque, J.-F., Matsumoto, K., Montzka, S. A., Raper, S. C. B., Riahi, K., Thomson, A., Velders, G. J. M. and Vuuren, D. P. P. van: The RCP greenhouse gas concentrations and their extensions from 1765 to 2300, Climatic Change, 109(1), 213, doi:10.1007/s10584-011-0156-z, 2011.

Meinshausen, M., Nicholls, Z. R. J., Lewis, J., Gidden, M. J., Vogel, E., Freund, M., Beyerle, U., Gessner, C., Nauels, A., Bauer, N., Canadell, J. G., Daniel, J. S., John, A., Krummel, P. B., Luderer, G., Meinshausen, N., Montzka, S. A., Rayner, P. J., Reimann, S., Smith, S. J., Berg, M. van den, Velders, G. J. M., Vollmer, M. K. and Wang, R. H. J.: The shared socio-economic pathway (SSP) greenhouse gas concentrations and their extensions to 2500, Geoscientific Model Development, 13(8), 3571–3605, doi:10.5194/gmd-13-3571-2020, 2020.

Messager, M. L., Lehner, B., Grill, G., Nedeva, I. and Schmitt, O.: Estimating the volume and age of water stored in global lakes using a geo-statistical approach, Nature Communications, 7(1), 13603, doi:10.1038/ncomms13603, 2016.

Murakami, D. and Yamagata, Y.: Estimation of Gridded Population and GDP Scenarios with Spatially Explicit Statistical Downscaling, Sustainability, 11(7), 2106, doi:10.3390/su11072106, 2019.

Portmann, F. T., Siebert, S. and Döll, P.: MIRCA2000—global monthly irrigated and rainfed crop areas around the year 2000: A new high-resolution data set for agricultural and hydrological modeling, Global Biogeochemical Cycles, 24(1), doi:10.1029/2008GB003435, 2010.

Reyer, C., Silveyra Gonzalez, R., Dolos, K., Hartig, F., Hauf, Y., Noack, M., Lasch-Born, P., Rötzer, T., Pretzsch, H., Meesenburg, H., Fleck, S., Wagner, M., Bolte, A., Sanders, T., Kolari, P., Mäkelä, A., Vesala, T., Mammarella, I., Pumpanen, J., Matteucci, G., Collalti, A., D’Andrea, E., Foltýnová, L., Krejza, J., Ibrom, A., Pilegaard, K., Loustau, D., Bonnefond, J.-M., Berbigier, P., Picart, D., Lafont, S., Dietze, M., Cameron, D., Vieno, M., Tian, H., Palacios-Orueta, A., Cicuendez, V., Recuero, L., Wiese, K., Büchner, M., Lange, S., Volkholz, J., Kim, H., Weedon, G., Sheffield, J., Vega del Valle, I., Suckow, F., Horemans, J., Martel, S., Bohn, F., Steinkamp, J., Chikalanov, A. and Frieler, K.: The PROFOUND database for evaluating vegetation models and simulating climate impacts on forests. V. 0.1.12., GFZ Data Services, doi:10.5880/PIK.2019.008, 2019.

Reyer, C. P. O., Silveyra Gonzalez, R., Dolos, K., Hartig, F., Hauf, Y., Noack, M., Lasch-Born, P., Rötzer, T., Pretzsch, H., Meesenburg, H., Fleck, S., Wagner, M., Bolte, A., Sanders, T. G. M., Kolari, P., Mäkelä, A., Vesala, T., Mammarella, I., Pumpanen, J., Collalti, A., Trotta, C., Matteucci, G., D’Andrea, E., Foltýnová, L., Krejza, J., Ibrom, A., Pilegaard, K., Loustau, D., Bonnefond, J.-M., Berbigier, P., Picart, D., Lafont, S., Dietze, M., Cameron, D., Vieno, M., Tian, H., Palacios-Orueta, A., Cicuendez, V., Recuero, L., Wiese, K., Büchner, M., Lange, S., Volkholz, J., Kim, H., Horemans, J. A., Bohn, F., Steinkamp, J., Chikalanov, A., Weedon, G. P., Sheffield, J., Babst, F., Vega del Valle, I., Suckow, F., Martel, S., Mahnken, M., Gutsch, M. and Frieler, K.: The PROFOUND database for evaluating vegetation models and simulating climate impacts on european forests, Earth System Science Data, 12(2), 1295–1320, doi:10.5194/essd-12-1295-2020, 2020.

Tian, H., Yang, J., Lu, C., Xu, R., Canadell, J. G., Jackson, R. B., Arneth, A., Chang, J., Chen, G., Ciais, P., Gerber, S., Ito, A., Huang, Y., Joos, F., Lienert, S., Messina, P., Olin, S., Pan, S., Peng, C., Saikawa, E., Thompson, R. L., Vuichard, N., Winiwarter, W., Zaehle, S., Zhang, B., Zhang, K. and Zhu, Q.: The Global N2O Model Intercomparison Project, Bulletin of the American Meteorological Society, 99(6), 1231–1251, doi:10.1175/BAMS-D-17-0212.1, 2018.