Skip to content

Commit 2c942ae

Browse files
forsyth2forsyth2
authored
Add v2.1 BGC data (#56)
* Add v2.1 BGC data * Generated table * Add original run scripts * Address comments
1 parent 40acfcf commit 2c942ae

File tree

10 files changed

+1973
-13
lines changed

10 files changed

+1973
-13
lines changed

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

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
E3SMv2.1 (BGC)
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+
* Note: Link will be provided upon publication
12+
13+
.. toctree::
14+
:maxdepth: 2
15+
:caption: Contents:
16+
17+
simulation_data/index

‎docs/source/v2.1/BGC/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**. Please note that the BGC numbering system gives ``v2.1`` simulations a prefix of ``v2``.
6+
7+
The data is reformatted to conform to CMIP conventions and was 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 **elm.h0** (monthly land output files) between **years 1930 and 1949** for the v2.LR.BGC-LNDATM.CONTRL 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/BGC/E3SMv2_1/v2.LR.BGC-LNDATM.CONTRL/ "*.elm.h0.19[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/BGC/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/BGC/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/BGC/simulation_data/simulation_table.rst‎

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
**********************************
2+
v2.1 BGC simulation table
3+
**********************************
4+
5+
+-------------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------+
6+
| Simulation | Data Size (TB) | ESGF Links | HPSS Path |
7+
+===================================================================+=================+==================================================================================================================================================================================================================================================================================================================================================================================================================+==================================================================================+
8+
| **LR > SPINUP** | | | |
9+
+-------------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------+
10+
| CBGCv2.r05.chrysalis.I20TRGSWCNP | 8 | | /home/projects/e3sm/www/BGC/E3SMv2_1/CBGCv2.r05.chrysalis.I20TRGSWCNP |
11+
+-------------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------+
12+
| **LR > HISTORICAL** | | | |
13+
+-------------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------+
14+
| v2.LR.BGC-LNDATM.CONTRL | 11 | | /home/projects/e3sm/www/BGC/E3SMv2_1/v2.LR.BGC-LNDATM.CONTRL |
15+
+-------------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------+
16+
| **LR > SSP** | | | |
17+
+-------------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------+
18+
| v2.LR.BGC-LNDATM.SSP370 | 6 | | /home/projects/e3sm/www/BGC/E3SMv2_1/v2.LR.BGC-LNDATM.SSP370 |
19+
+-------------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------+

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

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,4 +5,5 @@ v2.1
55
:maxdepth: 2
66
:caption: Contents:
77

8+
BGC/index
89
WaterCycle/index

0 commit comments

Comments
 (0)