Hosted by Department of Energy
Lawrence Livermore National Laboratory
Powered by ESGF logo
Welcome, Guest. | Login | Create Account
obs4MIPs logo
You are at the ESGF@DOE/LLNL node

How to contribute

Criteria for observational data to be included in obs4MIPs

The requirements for a dataset to be published under the obs4MIPs project are summarized here:

  • is a peer reviewed dataset, with measurement source, construction methodology, calibration/validation and uncertainty described in one or more peer reviewed publications.

  • is a variable that is a match to a model variable in the CMIP6 protocol

  • has been converted to the specified obs4MIPs data structure and format (see below)

  • has an accompanying technical note that conforms to the obs4MIPs technical note template. Technical notes will be hosted on the ESGF so that they appear along side the datasets to which they pertain.

  • is version controlled, i.e. any given complete instance of the dataset must have a unique version identifier.

Also expected:

  • has documented use for climate model evaluation, preferably in peer-reviewed publications

  • has a Digital Object Identifier (DOI) issued for the technical note

  • has a DOI issued for the dataset

Some observational datasets that are not strictly a match with a field in the CMIP5 or CMIP6 protocol may be suitable for obs4MIPs if there are straightforward methods that can be made available for comparing them with the model output available through CMIP.  Some potential examples include total column observables, where CMIP output only requests the vertically resolved values, or a variable requiring the application of an operational operator to account for vertical weighting functions associated with satellite sounding techniques.  If you have questions regarding the processes and resources outlined below, please contact us.

Preparing datasets and publishing them on ESGF

In order to host an obs4MIPs dataset on the ESGF it must be formatted according to the obs4MIPs requirements and published in the catalog of an ESGF node so that it can be searchable and accessable. Data contributors should follow the process below that lists the steps to take for contributing to obs4MIPs.  WDAC task team members can assist in identifying a suitable ESGF node to host the dataset.

It is currently recommended that obs4MIPs data be prepared using the Climate Model Output Rewriter version 3 (CMOR3) to ensure that the data can be properly searched through the ESGF. In any case, data files must be prepared to conform to the obs4MIPs Data Specifications v2.1 (ODS v2.1)

The process for submitting and publishing datasets to obs4MIPs

(including the roles and coordination between the data provider and the WDAC Task Team)

Data Provider

Read the information on this page, complete the proposal form, and send it to the Task Team co-chairs

Task Team

Task Team (TT) Co-chairs ensure form is complete and iterate with proposer if necessary.   Once complete, circulate among TT members for feedback and to identify a member to take the lead on the dataset.

TT to consider appropriateness of proposed dateset based on the following criteria:


  • Quantitative comparisions with CMIP5 simulations is possible either via a "one-to-one" match of the proposed variable with a CMIP model output variable or via a quantity that can be derived from the model output.
  • the dataset has a peer-reviewed publication history of some kind


  • Evidence of previous documented use for global or regional model evaluation (e.g., a peer-reviewed publication).
  • Is of sufficient duration, density and "quality" for comparison to model simulations

If the REQUIRED conditions are met and one or more asprects of the STRONGLY DESIRED are met, inform the data provider and encourage them to prepare the dataset and technical note accordingly.

Otherwise, notify the data provideer that the proposed dataset doe not currently meet the obs4MIPs minimum requirements, and discuss what would be needed to meet those requirements.

Data Provider

Read the obs4MIPs Data Specifications v2.1 (ODS v2.1) and the obs4MIPs technical note template and then:

Use CMOR3 to format the dataset to meet the obs4MIPs specifications

Develop a technical note for the dataset

Work with the TT if necessary to identify an ESGF node to host the dataset, and establish a pathway to publish the data on the ESGF 

Seek guideance from the TT where needed on the above items

Submit the dataset and technical note to the TT for review

Task Team

TT to consider "readiness" of proposed dateset based on the following criteria:

1) Does the dataset meet the technical requirements for obs4MIPs? 

2) Has a technical note for the dataset been completed based on the technical note template?   TT members to review, provide feedback and concur on technical note readiness, with at least one member - or external scientist if necessary - having subject matter expertise.

3)  Is there an identified ESGF node for archving?  TT may need to help with this.

TT lead for the dataset to iterate with the data provider to make the dateset ready for publication.  

When conditions 1), 2) and 3) are met the dataset is ready for including in obs4MIPs.

Data Provider

Work with the ESGF node staff that will host the dataset and technical note to get them published on ESGF.

Ensure the dataset and technical note have been published properly on the ESGF.  This can be done by searching for the dataset on the obs4MIPs CoG site, and verifying that both the dataset and technical note are visible, retrievable, and have not be corrupted during the publication process.


Additional resources and information needed to submit and publish datasets to obs4MIPs

Last Update: Nov. 8, 2018, 9:08 a.m. by Robert Ferraro