Add v2.1 BGC data

Author: forsyth2

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

@@ -0,0 +1,17 @@
+E3SMv2.1 (BGC)
+====================
+
+The simulation campaign for E3SMv2.1 was performed with Low Resolution (LR) configuration
+
+* **v2_1.LR** (lower resolution)
+
+If you use data from this simulation campaign, please cite the following overview
+manuscript:
+
+* Note: Link will be provided upon publication
+
+.. toctree::
+   :maxdepth: 2
+   :caption: Contents:
+
+   simulation_data/index

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

@@ -0,0 +1,56 @@
+***************
+Simulation Data 
+***************
+
+The E3SMv2.1 simulation data is available on **ESGF** and **NERSC HPSS**.
+
+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).
+
+Additionally, all native model output data has also been archived on **NERSC HPSS** using `zstash <https://e3sm-project.github.io/zstash>`_.
+
+**If you have an account on NERSC**, you can retrieve the data locally or remotely using Globus.
+
+To download simulation data locally on a NERSC machine: ::
+
+   zstash extract --hpss=<HPSS path below>
+
+To download simulation data remotely using the zstash Globus interface: ::
+
+   zstash extract --hpss=globus://nersc/<HPSS path below>
+
+or ::
+
+   zstash extract --hpss=globus://9cd89cfd-6d04-11e5-ba46-22000b92c6ec/<HPSS path below>
+
+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:
+
+1. To activate E3SM-Unified environment by:
+   ::
+
+    source /global/common/software/e3sm/anaconda_envs/load_latest_e3sm_unified_pm-cpu.sh
+
+2. To retrieve files with zstash command:
+   ::
+
+    zstash extract --hpss=/home/projects/e3sm/www/WaterCycle/E3SMv2_1/v2_1.LR.piControl "*.eam.h0.00[3-4]?-??.nc"
+
+
+For more information, refer to `zstash usage <https://e3sm-project.github.io/zstash/_build/html/master/usage.html#extract>`_. 
+
+
+**If you do not have access to NERSC**, you can download simulation data directly through the  NERSC HPSS
+`web interface <https://portal.nersc.gov/archive/home/projects/e3sm/www/WaterCycle/E3SMv2_1>`_.
+Note that this will be slow and inefficient since you'll have to download the tar files.
+
+**v2_1.LR** simulations data has been archived on NERSC HPSS under: ::
+
+  /home/projects/e3sm/www/BGC/E3SMv2_1
+
+
+Original run scripts can be found `here <https://github.com/E3SM-Project/e3sm_data_docs/tree/main/run_scripts/v2.1/original>`_.
+
+.. toctree::
+   :maxdepth: 2
+   :caption: Contents:
+
+   simulation_table

docs/source/v2.1/BGC/simulation_data/simulation_data.rst

@@ -270,4 +270,5 @@ def construct_pages(csv_file: str, model_version: str, group_name: str, include_
 
 if __name__ == "__main__":
     #construct_pages("simulations_v2.csv", "v2", "WaterCycle")
-    construct_pages("simulations_v2_1.csv", "v2.1", "WaterCycle")
+    #construct_pages("simulations_v2_1.csv", "v2.1", "WaterCycle")
+    construct_pages("simulations_v2_1.csv", "v2.1", "BGC")

utils/generate_tables.py

@@ -1,4 +1,7 @@
 model_version, group, resolution, category, simulation_name,    machine, checksum, experiment, ensemble_num, cmip_only, node,
+v2.1, BGC,        LR, DECK        v2_1.LR.land-historical-transient,
+v2.1, BGC,        LR, DECK        v2.LR.BGC-LNDATM.SPINUPp,
+v2.1, BGC,        LR, DECK        v2.1.LR.land-atm-historical-trainsient,
 v2.1, WaterCycle, LR, DECK,       v2_1.LR.piControl,            chrysalis, ebc5565e182e8b1cc887c185ca3eb144, piControl,    1, cmip_only, cels.anl,
 v2.1, WaterCycle, LR, DECK,       v2_1.LR.1pctCO2_0101,         chrysalis, b7676ccc791941d1bdadde05c59d70b0, 1pctCO2,      1, cmip_only, cels.anl,
 v2.1, WaterCycle, LR, DECK,       v2_1.LR.abrupt-4xCO2_0101,    chrysalis, fe50274534774678d55cb320412d1667, abrupt-4xCO2, 1, cmip_only, cels.anl,