Skip to content

Commit 40f78a2

Browse files
forsyth2forsyth2
authored
Add v2.1 data (#50)
* Add v2.1 data * Updates on Perlmutter * Address comments
1 parent b712bc6 commit 40f78a2

18 files changed

+4581
-32
lines changed

‎docs/source/index.rst‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -16,10 +16,12 @@ simulations.
1616
:caption: Contents:
1717

1818
v2/index
19+
v2.1/index
1920
SCREAMv0/index
2021
SCREAMv1/index
2122

2223

24+
2325
.. Indices and tables
2426
.. ==================
2527
..

‎docs/source/v2.1/WaterCycle/index.rst‎

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
E3SMv2.1 (Water Cycle)
2+
====================
3+
4+
The simulation campaign for E3SMv2.1 was performed with Low Resolution (LR) configuration
5+
6+
* **v2_1.LR** (lower resolution)
7+
8+
If you use data from this simulation campaign, please cite the following overview
9+
manuscript:
10+
11+
* `Smith et al. 2024 (GMD) <https://gmd.copernicus.org/preprints/gmd-2024-149>`_
12+
13+
.. toctree::
14+
:maxdepth: 2
15+
:caption: Contents:
16+
17+
simulation_data/index

‎docs/source/v2.1/WaterCycle/simulation_data/index.rst‎

Lines changed: 56 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,56 @@
1+
***************
2+
Simulation Data
3+
***************
4+
5+
The E3SMv2.1 simulation data is available on **ESGF** and **NERSC HPSS**.
6+
7+
The preferred retrieval method is **ESGF**. Native output is available at `ESGF <https://esgf-node.cels.anl.gov/search?project=CMIP6&activeFacets=%7B%22source_id%22%3A%22E3SM-2-1%22%7D>`_, and a subset of the data is reformatted to conform to CMIP conventions and submmited to the CMIP6 ESGF archive (ESGF links are provided in the table below for published data).
8+
9+
Additionally, all native model output data has also been archived on **NERSC HPSS** using `zstash <https://e3sm-project.github.io/zstash>`_.
10+
11+
**If you have an account on NERSC**, you can retrieve the data locally or remotely using Globus.
12+
13+
To download simulation data locally on a NERSC machine: ::
14+
15+
zstash extract --hpss=<HPSS path below>
16+
17+
To download simulation data remotely using the zstash Globus interface: ::
18+
19+
zstash extract --hpss=globus://nersc/<HPSS path below>
20+
21+
or ::
22+
23+
zstash extract --hpss=globus://9cd89cfd-6d04-11e5-ba46-22000b92c6ec/<HPSS path below>
24+
25+
Note that the data management tool `zstash <https://github.com/E3SM-Project/zstash>`_ is available from the `E3SM-Unified <https://github.com/E3SM-Project/e3sm-unified>`_ conda environment. An example of retrieving all **eam.h0** (monthly atmosphere output files) between **years 0030 and 0049** for the v2_1.LR.piControl simulation at NERSC locally is demonstrated as below in two steps:
26+
27+
1. To activate E3SM-Unified environment by:
28+
::
29+
30+
source /global/common/software/e3sm/anaconda_envs/load_latest_e3sm_unified_pm-cpu.sh
31+
32+
2. To retrieve files with zstash command:
33+
::
34+
35+
zstash extract --hpss=/home/projects/e3sm/www/WaterCycle/E3SMv2_1/v2_1.LR.piControl "*.eam.h0.00[3-4]?-??.nc"
36+
37+
38+
For more information, refer to `zstash usage <https://e3sm-project.github.io/zstash/_build/html/master/usage.html#extract>`_.
39+
40+
41+
**If you do not have access to NERSC**, you can download simulation data directly through the NERSC HPSS
42+
`web interface <https://portal.nersc.gov/archive/home/projects/e3sm/www/WaterCycle/E3SMv2_1>`_.
43+
Note that this will be slow and inefficient since you'll have to download the tar files.
44+
45+
**v2_1.LR** simulations data has been archived on NERSC HPSS under: ::
46+
47+
/home/projects/e3sm/www/WaterCycle/E3SMv2_1
48+
49+
50+
Original run scripts can be found `here <https://github.com/E3SM-Project/e3sm_data_docs/tree/main/run_scripts/v2.1/original>`_.
51+
52+
.. toctree::
53+
:maxdepth: 2
54+
:caption: Contents:
55+
56+
simulation_table

‎docs/source/v2.1/WaterCycle/simulation_data/simulation_table.rst‎

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,29 @@
1+
**********************************
2+
v2.1 WaterCycle simulation table
3+
**********************************
4+
5+
+-------------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------+
6+
| Simulation | Data Size (TB) | ESGF Links | HPSS Path |
7+
+===================================================================+=================+==================================================================================================================================================================================================================================================================================================================================================================================================================+==================================================================================+
8+
| **LR > DECK** | | | |
9+
+-------------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------+
10+
| v2_1.LR.piControl | 45 | `CMIP <https://esgf-node.cels.anl.gov/search/?project=CMIP6&activeFacets=%7B%22source_id%22%3A%22E3SM-2-1%22%2C%22experiment_id%22%3A%22piControl%22%2C%22variant_label%22%3A%22r1i1p1f1%22%7D>`_ | /home/projects/e3sm/www/WaterCycle/E3SMv2_1/v2_1.LR.piControl |
11+
+-------------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------+
12+
| v2_1.LR.1pctCO2_0101 | 14 | `CMIP <https://esgf-node.cels.anl.gov/search/?project=CMIP6&activeFacets=%7B%22source_id%22%3A%22E3SM-2-1%22%2C%22experiment_id%22%3A%221pctCO2%22%2C%22variant_label%22%3A%22r1i1p1f1%22%7D>`_ | /home/projects/e3sm/www/WaterCycle/E3SMv2_1/v2_1.LR.1pctCO2_0101 |
13+
+-------------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------+
14+
| v2_1.LR.abrupt-4xCO2_0101 | 14 | `CMIP <https://esgf-node.cels.anl.gov/search/?project=CMIP6&activeFacets=%7B%22source_id%22%3A%22E3SM-2-1%22%2C%22experiment_id%22%3A%22abrupt-4xCO2%22%2C%22variant_label%22%3A%22r1i1p1f1%22%7D>`_ | /home/projects/e3sm/www/WaterCycle/E3SMv2_1/v2_1.LR.abrupt-4xCO2_0101 |
15+
+-------------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------+
16+
| v2_1.LR.amip_0101 | 1 | `CMIP <https://esgf-node.cels.anl.gov/search/?project=CMIP6&activeFacets=%7B%22source_id%22%3A%22E3SM-2-1%22%2C%22experiment_id%22%3A%22amip%22%2C%22variant_label%22%3A%22r1i1p1f1%22%7D>`_ | /home/projects/e3sm/www/WaterCycle/E3SMv2_1/v2_1.LR.amip_0101 |
17+
+-------------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------+
18+
| **LR > Historical** | | | |
19+
+-------------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------+
20+
| v2_1.LR.historical_0101 | 14 | `CMIP <https://esgf-node.cels.anl.gov/search/?project=CMIP6&activeFacets=%7B%22source_id%22%3A%22E3SM-2-1%22%2C%22experiment_id%22%3A%22historical%22%2C%22variant_label%22%3A%22r1i1p1f1%22%7D>`_ | /home/projects/e3sm/www/WaterCycle/E3SMv2_1/v2_1.LR.historical_0101 |
21+
+-------------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------+
22+
| v2_1.LR.historical_0151 | 15 | `CMIP <https://esgf-node.cels.anl.gov/search/?project=CMIP6&activeFacets=%7B%22source_id%22%3A%22E3SM-2-1%22%2C%22experiment_id%22%3A%22historical%22%2C%22variant_label%22%3A%22r2i1p1f1%22%7D>`_ | /home/projects/e3sm/www/WaterCycle/E3SMv2_1/v2_1.LR.historical_0151 |
23+
+-------------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------+
24+
| v2_1.LR.historical_0201 | 15 | `CMIP <https://esgf-node.cels.anl.gov/search/?project=CMIP6&activeFacets=%7B%22source_id%22%3A%22E3SM-2-1%22%2C%22experiment_id%22%3A%22historical%22%2C%22variant_label%22%3A%22r3i1p1f1%22%7D>`_ | /home/projects/e3sm/www/WaterCycle/E3SMv2_1/v2_1.LR.historical_0201 |
25+
+-------------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------+
26+
| v2_1.LR.historical_0251 | 15 | `CMIP <https://esgf-node.cels.anl.gov/search/?project=CMIP6&activeFacets=%7B%22source_id%22%3A%22E3SM-2-1%22%2C%22experiment_id%22%3A%22historical%22%2C%22variant_label%22%3A%22r4i1p1f1%22%7D>`_ | /home/projects/e3sm/www/WaterCycle/E3SMv2_1/v2_1.LR.historical_0251 |
27+
+-------------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------+
28+
| v2_1.LR.historical_0301 | 15 | `CMIP <https://esgf-node.cels.anl.gov/search/?project=CMIP6&activeFacets=%7B%22source_id%22%3A%22E3SM-2-1%22%2C%22experiment_id%22%3A%22historical%22%2C%22variant_label%22%3A%22r5i1p1f1%22%7D>`_ | /home/projects/e3sm/www/WaterCycle/E3SMv2_1/v2_1.LR.historical_0301 |
29+
+-------------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------+

‎docs/source/v2.1/index.rst‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
v2.1
2+
==========================================
3+
4+
.. toctree::
5+
:maxdepth: 2
6+
:caption: Contents:
7+
8+
WaterCycle/index

0 commit comments

Comments
 (0)