====== PMIP4 and the CMIP6 Data Request ======

===== Goal =====

The CMIP6 data request for PMIP is a document that allows PMIP participants to specify which variables they are interested in, at which frequency, and for which scientific purpose. This documents specifies which variable type/frequency will be generated for each PMIP experiment, as well as the length of the experiments. It also specifies which experiments from other endorsed MIPs will be used by PMIP participants. See the actual spreadsheet below for more details

The variables requested for PMIP come from several sources (see the //Documents// section below for details)

  * The PMIP 2 variables
  * The CMIP5 variables
  * Variables from other CMIP5-related MIPs (C4MIP, CORDEX, ...)
  * New isotope related variables suggested by Didier Roche
  * Variables suggested by Yves Balkanski for dust

===== Documents =====

  * [[https://pmip2.lsce.ipsl.fr/design/variables/|Variables requested for PMIP 2]]

  * From the [[http://cmip-pcmdi.llnl.gov/cmip5/data_description.html|CMIP5 Data Description page]]
    * [[http://cmip-pcmdi.llnl.gov/cmip5/docs/standard_output.xls|The CMIP5 standard output document]] : this Excel spreadsheet describes all the variables that were requested for CMIP5

  * [[http://wcrp-climate.org/images/modelling/WGCM/WGCM19/documents/4c_wgcm_dreq_v1.pdf|The CMIP6 Data Request]], Martin Juckes, [[http://wcrp-climate.org/modelling-wgcm-meetings/64-unifying-themes/modelling-wgcm/modelling-wgcm-sessions/705-wgcm19|WGCM Dubrovnik meeting]], October 2015


===== The PMIP4 request =====

==== Some history ====

In addition to many discussions, we have also used the following documents to create the PMIP4 request:
  * [[https://www.wcrp-climate.org/images/modelling/WGCM/WGCM19/documents/4c_wgcm_dreq_v1.pdf|The CMIP6 Data Request (Martin Juckes, October 2015)]]
  * [[https://www.earthsystemcog.org/doc/list/wip/?type=&query=&filter_by=All&order_by=update_date|Documents describing the Data Request creation process]]
  * [[https://pmip2.lsce.ipsl.fr/|Variables requested for PMIP 2]]
  * [[http://cmip-pcmdi.llnl.gov/cmip5/docs/standard_output.xls|Variables requested for CMIP5 (and PMIP 3!)]]
  * [[https://docs.google.com/spreadsheets/d/1Kg0TbXE_-qJvQCgdxIfLVrXc8joqPf1ACkP4PYUDdHk/|A google spreadsheet combining several requests]] (this was our working document)

==== Resulting request ====


The actual data request is composed of 2 Excel spreadheets:
  * An annotated version of the //CMIP5 standard output document// where we have specified a PMIP priority for each variable (see the rightmost column of each tab): same priority as CMIP5 (''1''), higher priority (''2''), not requested for PMIP (''0'')
    * {{ :database:pmip_standard_output_v150228_final.xls |}}
  * The //CMIP6DataRequestCompilationTemplate// document
    * {{ :database:cmip6datarequestcompilationtemplate_20141218_pmip_v150228_final.xls |}}

===== The CMIP6 Data Request =====

<WRAP center round important 60%>
Please note that the **full CMIP6 Data Request** is still a <wrap hi>work in progress</wrap>! It is a combination of [[#the_pmip4_request|what has been requested by PMIP4]] **and** by all the other endorsed projects

Current version (as of October 10th 2018): ''01.00.27''

Make sure you check the [[https://earthsystemcog.org/projects/wip/CMIP6DataRequest|CMIP6 Data Request web site]] to access the latest information available !
</WRAP>

Data Request (//DR//) web site: [[https://earthsystemcog.org/projects/wip/CMIP6DataRequest]]

  * Understanding the [[https://earthsystemcog.org/projects/wip/mip_table_about|CMIP6 DR MIP tables names]]

  * [[http://proj.badc.rl.ac.uk/svn/exarch/CMIP6dreq/tags/latest/dreqPy/docs/CMIP6_MIP_tables.xlsx|Spreadsheet view of the variable definitions]]: a **big** spreadsheet (slightly similar to the [[http://cmip-pcmdi.llnl.gov/cmip5/docs/standard_output.xls| CMIP5 standard output document]]).\\ You get all the variables at all the frequencies, requested by all the projects, grouped by //(CMOR) tables//. A //table// lists the variables requested for a given //realm// (atmosphere, ocean, ...) at a given //frequency// (daily, monthly, ...). You get at the end of each line the projects that have requested the given variable in the current table.

  * There are **lots** of ways to access the complex content of the DR and you may want to use the [[http://clipc-services.ceda.ac.uk/dreq/index.html|browsable HTML view of the request]] if you want to navigate some **human-readable views** of the DR
    * [[http://clipc-services.ceda.ac.uk/dreq/index/mip.html|Model Intercomparison Project [mip] ]] section
      * [[http://clipc-services.ceda.ac.uk/dreq/u/PMIP.html|PMIP]] section

  * Data request related **issues** (on //github//):
    * [[https://github.com/cmip6dr/CMIP6_DataRequest_VariableDefinitions/issues|CMIP6_DataRequest_VariableDefinitions]]
    * [[https://github.com/cmip6dr/Request/issues|Request]]
    * [[https://github.com/cmip6dr/dreqPy/issues|dreqPy]]