Merge pull request #322 from cecilehannay/main

updating cam challenge to cesm3

Author: cecilehannay

notebooks/challenge/cam/cam.ipynb

@@ -22,7 +22,9 @@
     "- Explain what an **F compset** is and how it differs from a fully coupled **B compset**.\n",
     "- Identify the different forcing options available for F compsets (e.g., climatological and historical forcings).\n",
     "- Use CESM tools and documentation to identify and explore available compsets.\n",
-    "- Modify input datasets using NCO (NetCDF Operators) or Jupyter Notebooks\n",
+    "- Modify input datasets using NCO (NetCDF Operators) or python scripts.\n",
+    "\n",
+    "You will:\n",
     "- Create and run an F compset simulation in CESM.\n",
     "- Design and run simple sensitivity experiments by changing model forcing, datasets, or model parameters."
    ]
@@ -45,23 +47,22 @@
     "\n",
     "In an F compset:\n",
     "\n",
-    "- The atmosphere and land models are active.\n",
+    "- The atmosphere and land models are active. There is no active ocean model.\n",
     "- Sea surface temperatures (SSTs) are prescribed from observations or external datasets.\n",
     "- Sea ice concentration and thickness are also prescribed.\n",
-    "- There is no active ocean model.\n",
     "\n",
     "Because the ocean state is fixed, F compsets are often used to:\n",
     "\n",
     "- Test atmospheric model changes.\n",
     "- Study the atmospheric response to SST anomalies.\n",
     "- Evaluate model physics.\n",
-    "- Run experiments that are computationally much cheaper than fully coupled simulations.\n",
+    "- Run experiments that are computationally cheaper than fully coupled simulations.\n",
     "\n",
     "**Examples of F compsets**  \n",
     "\n",
-    "- ``FHISTC_LTso`` uses time-varying historical forcings, including observed SSTs and sea ice, with the low-top atmosphere configuration. \n",
-    "- ``FHISTC_MTso`` uses time-varying historical forcings, including observed SSTs and sea ice, with the mid-top atmosphere configuration.\n",
-    "- ``F1850C_LTso`` uses repeating pre-industrial (circa 1850) climatological forcings, SSTs, and sea ice with the low-top atmosphere configuration.\n",
+    "- ``FHISTC_LTso`` uses time-varying **historical** forcings, including observed SSTs and sea ice, with the **low-top** atmosphere configuration. \n",
+    "- ``FHISTC_MTso`` uses time-varying **historical** forcings, including observed SSTs and sea ice, with the **mid-top** atmosphere configuration.\n",
+    "- ``F1850C_LTso`` uses repeating **pre-industrial (circa 1850)** climatological forcings, SSTs, and sea ice with the **low-top** atmosphere configuration.\n",
     "  \n",
     "![B compsets versus F compsets](../../../images/challenge/Fcompset.png)\n",
     "\n",
@@ -73,27 +74,21 @@
    "id": "815e0869-0518-4cf9-9417-cd9b08965ca1",
    "metadata": {},
    "source": [
-    "## Overview of CAM Challenge Exercises\n",
-    "Start running a control case with the compset ``FHISTC_LTso``\n",
+    "# Overview of CAM Challenge Exercises\n",
+    "\n",
+    "**Step 1: Control case**\n",
+    "Run a **control** case with the compset ``FHISTC_LTso``\n",
     "\n",
+    "**Step 2: Sensitivity studies**\n",
     "Then choose one or more exercises to try:\n",
     "- Use climatological pre-industrial SSTs/forcings instead of historical (compset change)\n",
-    "- Try running historical starting 1850 with spun-up pre-industrial model\n",
-    "- Increase orographic height over the western US (dataset change)  ???? TO CHANGE  ????\n",
-    "- Modify sea surface temperature in the tropics \n",
+    "- Try running historical starting 1850 with spun-up pre-industrial model (xmlchange) \n",
+    "- Modify sea surface temperature in the tropics (dataset change)\n",
     "- Increase the triggering threshold for deep convection over land (code change--simple)\n",
-    "- Add a (fake) physics parameterization (code change--advanced)\n",
-    "- Compare your test exercise(s) to your control\n"
+    "- Add a (fake) physics parameterization (code change--advanced).\n",
+    "And compare your test exercise(s) to your control\n"
    ]
   },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "id": "52ee1b26-06ae-4e68-9272-1b9846274251",
-   "metadata": {},
-   "outputs": [],
-   "source": []
-  },
   {
    "cell_type": "markdown",
    "id": "f01e969b-ab1a-466a-9cf0-5da2a137c35f",
@@ -107,14 +102,14 @@
     "\n",
     "If you want to run a different configuration from what you’ve learned here, it is important to learn how to find and/or modify a compset.\n",
     "\n",
-    "The tool `query compsets` allows you to find more information about the available compsets. This tool is located in the same directory as `create_newcase` in `/glade/u/home/$USER/code/my_cesm_code/cime/scripts/`:\n",
+    "The tool `query compsets` allows you to find more information about the available compsets. This tool is located in the same directory as `create_newcase` in `/glade/u/home/$USER/code/my_cesm_code/cime/scripts/`.\n",
     "\n",
     "The command is:\n",
     "```\n",
     "cd /glade/u/home/$USER/code/my_cesm_code/cime/scripts/\n",
     "./query_config --compsets\n",
     "```\n",
-    "\n",
+    "Note that this command returns a lot of compsets. \n",
     "\n",
     "<div class=\"alert alert-info\">\n",
     "<strong>Evaluate your understanding</strong>\n",
@@ -136,11 +131,15 @@
     "```\n",
     "  ./query_config --compsets | grep -i CAM7\n",
     "```\n",
+    "To narrow down your choices to include only CAM7 and historical:\n",
+    "```\n",
+    "  ./query_config --compsets | grep -i CAM7 | grep -i HIST\n",
+    "```\n",
     "</details>\n",
     "</div>\n",
     "\n",
-    "\n",
-    "If you want to build your own, you can see all your options, perhaps modify one of the above with changes\u000b",
+    "** Advanced: Building your own compset**\n",
+    "If you want to build your own compset, you can see all your options, perhaps modify one of the above with changes\u000b",
     "\n",
     "```\n",
     "./query_config --components\n",