From 864628a3fcea9818e46381a4aa40af1ab3a1e614 Mon Sep 17 00:00:00 2001
From: Martin Schupfner <k204212@levante2.lvt.dkrz.de>
Date: Thu, 30 Nov 2023 11:49:51 +0100
Subject: [PATCH] Updated README.md - added part for provision of simulation
 specific information

---
 README.md                                     |  20 ++++++++++++++++++
 docs/source/SimulationSpreadsheet.png         | Bin 0 -> 34858 bytes
 .../SimulationSpreadsheet_ModelingGroups.png  | Bin 0 -> 4425 bytes
 3 files changed, 20 insertions(+)
 create mode 100644 docs/source/SimulationSpreadsheet.png
 create mode 100644 docs/source/SimulationSpreadsheet_ModelingGroups.png

diff --git a/README.md b/README.md
index 21fb890..c0814f5 100644
--- a/README.md
+++ b/README.md
@@ -56,6 +56,26 @@ The following information has to be provided:
   - information regarding forcing data (eg. Link)
 
 
+## Provide simulation specific information
+
+For us to start working on the processing / CMORisation of your simulations, we require some simulation specific information:
+- Where to find the simulation specific model output on disk?
+- What [experiment](#RegisterExperiment) was simulated? What `variant_label` (eg. member id) should be given to that simulation (eg. r1i1p1f1).
+- Branch information, references and variant_info (initialisation, forcing and general realisation or simulation specific information to be added to the netCDF metadata of the CMORised files). 
+- etc.
+
+This information can be provided via a GoogleSpreadsheet: [LINK](https://docs.google.com/spreadsheets/d/10WIxv98KMEIFQXSCVnesfly5u9ymsJW72u_WUamlJq8/edit?usp=sharing)
+Please request editing access for this GoogleSpreadsheet, select your model ...
+
+![SimulationSpreadsheet](docs/source/SimulationISpreadsheet.png)
+
+... and fill in the required information for each simulation. Please use already added simulations as example.
+
+![SimulationModelingGroups](docs/source/SimulationISpreadsheet_ModelingGroups.png)
+
+Please notify us in your [Register a new experiment](#RegisterExperiment) GitLab Issue when you added all simulation specific information or assistance is required.
+
+
 # CMOR tables - variable metadata
 
 Initially, the Palmod2 variable list has been put together in form of an excel document. Out of this document, the CMOR tables have been created, holding all necessary information of the variable metadata to be written to the data files by CMOR or a similar program.
diff --git a/docs/source/SimulationSpreadsheet.png b/docs/source/SimulationSpreadsheet.png
new file mode 100644
index 0000000000000000000000000000000000000000..3a2a641fead5c5a6485b831c7a169e81e123e088
GIT binary patch
literal 34858
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

literal 0
HcmV?d00001

diff --git a/docs/source/SimulationSpreadsheet_ModelingGroups.png b/docs/source/SimulationSpreadsheet_ModelingGroups.png
new file mode 100644
index 0000000000000000000000000000000000000000..c37601e7474000d8a260feba4eff6604c904b4d9
GIT binary patch
literal 4425
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
VhY4}5F#m-B4E0QPOLd-y{|6eo!Px)+

literal 0
HcmV?d00001

-- 
GitLab