ISIMIP Repository

The ISIMIP repository is available at data.isimip.org.

Data products

The data is organized by simulation round, e.g. ISIMIP3a, and data products:

• Input data - the data used to drive the impact models, exactly as described in the ISIMIP simulation protocols.
• Output data - the climate-impacts simulation data provided by participating modelling groups, corresponding to the output variables described in the ISIMIP simulation protocol.
• Secondary input data - data that have been derived from or are related to the input data, but not described in the simulation protocol (e.g. with a differnt spatial or temporal resolution).
• Secondary output data - simulation data that goes beyond the simulation protocol or data that have been derived by processing the ISIMIP output data, but do not correspond to output variables described in the simulation protocol.
• Derived output data - selected data derived from ISIMIP output data for which a publication describing the data product is available.

Submitted output data are only published after an embargo period and after explicit permission by the modelling group is given (see also: Workflow for contributions to ISIMIP).

Note: The ISIMIP data used to be publicly available via an ESGF service, but that was decommissioned in May, 2022.

Search the repository

Using the advanced search interface you can search the repository in several ways:

• You can enter a search query, e.g. "ISIMIP2b rcp60soc dis", and click Search to filter the results using this string. Please note that this search is exact, meaning that an input like "rcp60so" will not find "rcp60soc".
• You can restrict the search using the tree in the sidebar. By clicking on the check boxes you can select a more and more specific set of results, much like in a file system explorer.
• You can switch the sidebar to facets and select exact specifiers for the different identifiers, e.g. "Simulation round: ISIMIP2a" or "Sector: Water (global)".

Please note that these restrictions are combined to provide you the datasets you are looking for. In the second box on the right, all current constraints are visible and can be deselected using the cross. A list of all files fulfilling the current search can be downloaded and used with e.g. wget. Furthermore, a click on reset will reset the whole interface.

If you don't find the data you're looking for, please don't hesitate to get in touch.

Search results

In the ISIMIP repository, files for the same variable, but different time steps, are combined to datasets, e.g. "gswp3-w5e5_counterclim_tas_global_daily" contains:

• gswp3-w5e5_counterclim_tas_global_daily_1901_1910.nc
• gswp3-w5e5_counterclim_tas_global_daily_1911_1920.nc
• ...

A search as described above, will result in a display of a number of these kind of datasets.

For each dataset, the stored Metadata (e.g. the file size or the specifiers from the protocol) and the different files of the dataset can be viewed. A click on the square icon with an arrow will open a separate page for this dataset or file. These landing pages have a unique URL which identifies the dataset or file and which we will keep available even if we should de-publish the actual file in the future.

If the dataset is part of a DOI registered by us, the corresponding citation is also displayed. Each file of the dataset can be downloaded individually or all files can be downloaded at once (this might take a long time). Using the Configure download link opens the mask service for this dataset (more information below). Finally, a file list can be downloaded. This plain text file can be used for a bulk download with tools like wget (see below).

Configure download

In order to minimize the amount of data you need to download, the repository includes a masking service which can be used to remove all values of a file except a region (a country, a bounding box or just land data). This operation can also be performed on all files of a dataset at once. A link to this interface is included in the search result and on every dateset/file landing page.

Please note that the masking of NetCDF files takes a considerable amount of time. Depending on the size of the dataset, it can take tens of minutes to create the download. It is only possible to mask global files.

Bulk data download using wget

In order to download a large amount of files, usage of the wget tool is advised. If not already installed on you machine, you should be able to install it using your distibution (on Linux) or using homebrew (macOS). For Windows 10 , we recommend to run the wget scripts by installing the Windows Subsystem for Linux.

Once installed, a downloaded file list can be used with wget using (the "-c" (continue) flag ensures that already downloaded file are not downloaded again and the "-i" (input file) tells wget to use the downloaded list of files):

If you already know what files you want, you can use the path of the file directly, e.g.:

You can also download a complete directory using "--mirror --no-parent", e.g.:

Using the API

The API of the repository can be accessed at data.isimip.org/api/v1. The important endpoints are "datasets" and "files". Both accept similar options, therefor we will give examples for "datasets" only. A GET request to

• https://data.isimip.org/api/v1/datasets/

returns a paginated list of datasets. The response is a JSON object with "count" (count of all datasets), "next" (link to the next page), "previous" (link to the previous page) and "results" (the list of the datasets).

Since the API is also used by the search interface described above, searches can be done in a similar way. A few examples:

• https://data.isimip.org/api/v1/datasets/?query=w5e5%20counterclim%20tas
• https://data.isimip.org/api/v1/datasets/?climate_forcing=gswp3-w5e5&climate_scenario=counterclim&climate_variable=tas
• https://data.isimip.org/api/v1/datasets/?tree=ISIMIP3a/InputData/climate/atmosphere/counterclim/gswp3-w5e5/tas

The API can be used for scripted search and download. For Python, we created a small client library with some example Jupyter notebooks.