Skip to content

Commit 4412bdb

Browse files
forsyth2forsyth2
committed
Add v1 cryo data
1 parent fb726eb commit 4412bdb

File tree

10 files changed

+190
-17
lines changed

10 files changed

+190
-17
lines changed

‎docs/source/v1/Cryosphere/index.rst‎

Lines changed: 45 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,45 @@
1+
E3SMv1 (Cryosphere)
2+
====================
3+
4+
The `E3SM version 1 cryosphere simulation campaign <https://e3sm.org/research/cryosphere-ocean/v1-cryosphere-ocean/>`_ includes standard set of
5+
Coupled Model Intercomparison Project Phase 6 (`CMIP6 <https://www.geosci-model-dev.net/9/1937/2016/>`_)
6+
Diagnosis, Evaluation, and Characterization of Klima (DECK) simulations.
7+
These E3SM simulations at standard resolution have been completed and the data is publicly available.
8+
9+
Data Resolution:
10+
11+
The standard resolution configuration of E3SM v1.0 water cycle configuration has approximate horizontal resolution of
12+
1 deg latitude by 1 deg longitude in atmosphere (110 km grid spacing),
13+
with ocean and sea ice grid of 60 km in the mid-latitudes and 30 km at the equator and poles,
14+
and river transport at 55 km horizontal resolution.
15+
This model configuration is described in
16+
`“v1 1 deg CMIP” <https://e3sm.org/model/scientifically-validated-configurations/v1-configurations/v1-1-deg-cmip6/>`_ page
17+
in `Scientifically Validated Configurations <https://e3sm.org/model/scientifically-validated-configurations/>`_.
18+
19+
For more details,
20+
refer to `Coupled E3SM v1 Model Overview <https://e3sm.org/overview-paper-on-coupled-model/>`_ or to the reference papers:
21+
22+
* *The DOE E3SM Coupled Model Version 1: Overview and Evaluation at Standard Resolution* `doi: 10.1029/2018MS001603 <https://doi.org/10.1029/2018MS001603>`_
23+
* *Description of historical and future projection simulations by the global coupled E3SMv1.0 model as used in CMIP6* `doi:10.5194/gmd-15-3941-2022 <https://doi.org/10.5194/gmd-15-3941-2022>`_
24+
* *Ensemble Spread Behavior in Coupled Climate Models: Insights From the Energy Exascale Earth System Model Version 1 Large Ensemble* `doi:10.1029/2023MS003653 <https://doi.org/10.1029/2023MS003653>`_
25+
* *The DOE E3SM Coupled Model Version 1: Description and Results at High Resolution* `doi:10.1029/2019MS001870 <https://doi.org/10.1029/2019MS001870>`_
26+
27+
Experiments:
28+
29+
The datasets include the following experiments.
30+
31+
* 1850 PI Control
32+
* 1850 PI control with ice shelf melt fluxes
33+
* CORE-IAF control
34+
* CORE-IAF with ice shelf melt fluxes
35+
* 1850 PI control with ice shelf melt fluxes + 3DGM
36+
* CORE-IAF with ice shelf melt fluxes + 3DGM
37+
* 1850 PI control with ice shelf melt fluxes, bug fix run
38+
* 1850 PI control with ice shelf melt fluxes + 3DGM, bug fix run
39+
40+
41+
.. toctree::
42+
:maxdepth: 2
43+
:caption: Contents:
44+
45+
simulation_data/index

‎docs/source/v1/Cryosphere/simulation_data/index.rst‎

Lines changed: 65 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,65 @@
1+
***************
2+
Simulation Data
3+
***************
4+
5+
The E3SMv1 simulation data is available on **NERSC HPSS**.
6+
7+
All native model output data has also been archived on **NERSC HPSS** using `zstash <https://e3sm-project.github.io/zstash>`_.
8+
9+
**If you have an account on NERSC**, you can retrieve the data locally or remotely using Globus.
10+
11+
To download simulation data locally on a NERSC machine: ::
12+
13+
zstash extract --hpss=<HPSS path in table>
14+
15+
To download simulation data remotely using the zstash Globus interface: ::
16+
17+
zstash extract --hpss=globus://nersc/<HPSS path in table>
18+
19+
or ::
20+
21+
zstash extract --hpss=globus://9cd89cfd-6d04-11e5-ba46-22000b92c6ec/<HPSS path below>
22+
23+
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 **mpaso.hist.am.meridionalHeatTransport** between **years 0003 and 0004** for the "CORE-IAF with ice shelf melt fluxes" simulation at NERSC locally is demonstrated as below in two steps:
24+
25+
1. To activate E3SM-Unified environment by:
26+
::
27+
28+
source /global/common/software/e3sm/anaconda_envs/load_latest_e3sm_unified_pm-cpu.sh
29+
30+
2. To retrieve files with zstash command:
31+
::
32+
33+
zstash extract --hpss=/home/projects/e3sm/www/Cryosphere/E3SMv1/20190225.GMPAS-DIB-IAF-ISMF.T62_oEC60to30v3wLI.cori-knl "*mpaso.hist.am.meridionalHeatTransport.000[3-4]-??-??.nc"
34+
35+
36+
For more information, refer to `zstash usage <https://e3sm-project.github.io/zstash/_build/html/master/usage.html#extract>`_.
37+
38+
39+
**If you do not have access to NERSC**, you can download simulation data directly through the NERSC HPSS
40+
`web interface <https://portal.nersc.gov/archive/home/projects/e3sm/www/Cryosphere/E3SMv1>`_.
41+
Note that this will be slow and inefficient since you'll have to download the tar files.
42+
43+
Simulation data has been archived on NERSC HPSS under: ::
44+
45+
/home/projects/e3sm/www/Cryosphere/E3SMv1
46+
47+
48+
Scripts are not available to reproduce v1 simulations.
49+
50+
Original run scripts are also not available in the `archive <https://github.com/E3SM-Project/e3sm_data_docs/tree/main/run_scripts/v1/original/>`_. A few methods to search for run scripts, in general: ::
51+
52+
# Try looking directly
53+
zstash ls --hpss=/home/projects/e3sm/www/Cryosphere/E3SMv1/<simulation_name>/ case_scripts/run_script_provenance/*
54+
55+
# Try looking for provenance or run
56+
zstash ls --hpss=/home/projects/e3sm/www/Cryosphere/E3SMv1/<simulation_name> > out.txt
57+
grep -in provenance out.txt
58+
grep -in run out.txt
59+
60+
61+
.. toctree::
62+
:maxdepth: 2
63+
:caption: Contents:
64+
65+
simulation_table

‎docs/source/v1/Cryosphere/simulation_data/simulation_table.rst‎

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,25 @@
1+
**********************************
2+
v1 Cryosphere simulation table
3+
**********************************
4+
5+
+---------------------------------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------+
6+
| Simulation | Data Size (TB) | ESGF Links | HPSS Path |
7+
+=======================================================================================+=================+==================================================================================================================================================================================================================================================================================================================================================================================================================+==============================================================================================================================================+
8+
| **LR > v1Cryo** | | | |
9+
+---------------------------------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------+
10+
| 20190225.GMPAS-DIB-IAF-ISMF.T62_oEC60to30v3wLI.cori-knl | 12 | | (symlink) /home/projects/e3sm/www/Cryosphere/E3SMv1/20190225.GMPAS-DIB-IAF-ISMF.T62_oEC60to30v3wLI.cori-knl |
11+
+---------------------------------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------+
12+
| 20190306.A_WCYCL1850-DIB-ISMF_CMIP6.ne30_oECv3wLI.edison | 14 | | (symlink) /home/projects/e3sm/www/Cryosphere/E3SMv1/20190306.A_WCYCL1850-DIB-ISMF_CMIP6.ne30_oECv3wLI.edison |
13+
+---------------------------------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------+
14+
| 20190430.A_WCYCL1850-DIB-ISMF_CMIP6.ne30_oECv3wLI.control.cori-knl | 9 | | (symlink) /home/projects/e3sm/www/Cryosphere/E3SMv1/20190430.A_WCYCL1850-DIB-ISMF_CMIP6.ne30_oECv3wLI.control.cori-knl |
15+
+---------------------------------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------+
16+
| 20190819.GMPAS-DIB-IAF-ISMF.T62_oEC60to30v3wLI.cori-knl.testNewGM | 15 | | (symlink) /home/projects/e3sm/www/Cryosphere/E3SMv1/20190819.GMPAS-DIB-IAF-ISMF.T62_oEC60to30v3wLI.cori-knl.testNewGM |
17+
+---------------------------------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------+
18+
| 20190923.GMPAS-IAF.T62_oEC60to30v3wLI.cori-knl | 7 | | (symlink) /home/projects/e3sm/www/Cryosphere/E3SMv1/20190923.GMPAS-IAF.T62_oEC60to30v3wLI.cori-knl |
19+
+---------------------------------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------+
20+
| 20200610.A_WCYCL1850-DIB-ISMF_CMIP6.ne30_ECwISC30to60E1r2.cori-knl.maint1p2-3DGM | 6 | | (symlink) /home/projects/e3sm/www/Cryosphere/E3SMv1/20200610.A_WCYCL1850-DIB-ISMF_CMIP6.ne30_ECwISC30to60E1r2.cori-knl.maint1p2-3DGM |
21+
+---------------------------------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------+
22+
| 20210614.A_WCYCL1850-DIB-ISMF_CMIP6.ne30_ECwISC30to60E1r2.anvil.DIBbugFixMGM | 13 | | (symlink) /home/projects/e3sm/www/Cryosphere/E3SMv1/20210614.A_WCYCL1850-DIB-ISMF_CMIP6.ne30_ECwISC30to60E1r2.anvil.DIBbugFixMGM |
23+
+---------------------------------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------+
24+
| 20210614.A_WCYCL1850-DIB-ISMF_CMIP6.ne30_oECv3wLI.DIBbugfix.anvil | 12 | | (symlink) /home/projects/e3sm/www/Cryosphere/E3SMv1/20210614.A_WCYCL1850-DIB-ISMF_CMIP6.ne30_oECv3wLI.DIBbugfix.anvil |
25+
+---------------------------------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------+

0 commit comments

Comments
 (0)