Merge pull request #112 from kafitzgerald/update_wps_coupled

Updates to coupled and WPS lessons

lessons/internal/Lesson-coupled.ipynb

@@ -7,7 +7,7 @@
    },
    "source": [
     "<h1>Table of Contents<span class=\"tocSkip\"></span></h1>\n",
-    "<div class=\"toc\"><ul class=\"toc-item\"><li><span><a href=\"#Overview\" data-toc-modified-id=\"Overview-1\"><span class=\"toc-item-num\">1&nbsp;&nbsp;</span>Overview</a></span><ul class=\"toc-item\"><li><span><a href=\"#Software-and-conventions\" data-toc-modified-id=\"Software-and-conventions-1.1\"><span class=\"toc-item-num\">1.1&nbsp;&nbsp;</span>Software and conventions</a></span></li><li><span><a href=\"#Container-contents\" data-toc-modified-id=\"Container-contents-1.2\"><span class=\"toc-item-num\">1.2&nbsp;&nbsp;</span>Container contents</a></span></li></ul></li><li><span><a href=\"#Running-the-WRF-Preprocessing-System-(WPS)\" data-toc-modified-id=\"Running-the-WRF-Preprocessing-System-(WPS)-2\"><span class=\"toc-item-num\">2&nbsp;&nbsp;</span>Running the WRF Preprocessing System (WPS)</a></span><ul class=\"toc-item\"><li><span><a href=\"#Running-the-geogrid-utility\" data-toc-modified-id=\"Running-the-geogrid-utility-2.1\"><span class=\"toc-item-num\">2.1&nbsp;&nbsp;</span>Running the geogrid utility</a></span></li><li><span><a href=\"#Running-the-ungrib-utility\" data-toc-modified-id=\"Running-the-ungrib-utility-2.2\"><span class=\"toc-item-num\">2.2&nbsp;&nbsp;</span>Running the ungrib utility</a></span></li><li><span><a href=\"#Running-the-metgrid-utility\" data-toc-modified-id=\"Running-the-metgrid-utility-2.3\"><span class=\"toc-item-num\">2.3&nbsp;&nbsp;</span>Running the metgrid utility</a></span></li></ul></li><li><span><a href=\"#Running-the-coupled-WRF-|-WRF-Hydro-modeling-system\" data-toc-modified-id=\"Running-the-coupled-WRF-|-WRF-Hydro-modeling-system-3\"><span class=\"toc-item-num\">3&nbsp;&nbsp;</span>Running the coupled WRF | WRF-Hydro modeling system</a></span><ul class=\"toc-item\"><li><span><a href=\"#Running-real\" data-toc-modified-id=\"Running-real-3.1\"><span class=\"toc-item-num\">3.1&nbsp;&nbsp;</span>Running real</a></span></li><li><span><a href=\"#Running-the-coupled-model\" data-toc-modified-id=\"Running-the-coupled-model-3.2\"><span class=\"toc-item-num\">3.2&nbsp;&nbsp;</span>Running the coupled model</a></span></li></ul></li><li><span><a href=\"#Viewing-your-model-output\" data-toc-modified-id=\"Viewing-your-model-output-4\"><span class=\"toc-item-num\">4&nbsp;&nbsp;</span>Viewing your model output</a></span></li></ul></div>"
+    "<div class=\"toc\"><ul class=\"toc-item\"><li><span><a href=\"#Overview\" data-toc-modified-id=\"Overview-1\"><span class=\"toc-item-num\">1&nbsp;&nbsp;</span>Overview</a></span><ul class=\"toc-item\"><li><span><a href=\"#Software-and-conventions\" data-toc-modified-id=\"Software-and-conventions-1.1\"><span class=\"toc-item-num\">1.1&nbsp;&nbsp;</span>Software and conventions</a></span></li><li><span><a href=\"#Container-contents\" data-toc-modified-id=\"Container-contents-1.2\"><span class=\"toc-item-num\">1.2&nbsp;&nbsp;</span>Container contents</a></span></li><li><span><a href=\"#Lesson-contents\" data-toc-modified-id=\"Lesson-contents-1.3\"><span class=\"toc-item-num\">1.3&nbsp;&nbsp;</span>Lesson contents</a></span></li></ul></li><li><span><a href=\"#Running-the-WRF-Preprocessing-System-(WPS)\" data-toc-modified-id=\"Running-the-WRF-Preprocessing-System-(WPS)-2\"><span class=\"toc-item-num\">2&nbsp;&nbsp;</span>Running the WRF Preprocessing System (WPS)</a></span><ul class=\"toc-item\"><li><span><a href=\"#Running-the-geogrid-utility\" data-toc-modified-id=\"Running-the-geogrid-utility-2.1\"><span class=\"toc-item-num\">2.1&nbsp;&nbsp;</span>Running the geogrid utility</a></span></li><li><span><a href=\"#Running-the-ungrib-utility\" data-toc-modified-id=\"Running-the-ungrib-utility-2.2\"><span class=\"toc-item-num\">2.2&nbsp;&nbsp;</span>Running the ungrib utility</a></span></li><li><span><a href=\"#Running-the-metgrid-utility\" data-toc-modified-id=\"Running-the-metgrid-utility-2.3\"><span class=\"toc-item-num\">2.3&nbsp;&nbsp;</span>Running the metgrid utility</a></span></li></ul></li><li><span><a href=\"#Running-the-coupled-WRF-|-WRF-Hydro-modeling-system\" data-toc-modified-id=\"Running-the-coupled-WRF-|-WRF-Hydro-modeling-system-3\"><span class=\"toc-item-num\">3&nbsp;&nbsp;</span>Running the coupled WRF | WRF-Hydro modeling system</a></span><ul class=\"toc-item\"><li><span><a href=\"#Running-real\" data-toc-modified-id=\"Running-real-3.1\"><span class=\"toc-item-num\">3.1&nbsp;&nbsp;</span>Running real</a></span></li><li><span><a href=\"#Running-the-coupled-model\" data-toc-modified-id=\"Running-the-coupled-model-3.2\"><span class=\"toc-item-num\">3.2&nbsp;&nbsp;</span>Running the coupled model</a></span></li></ul></li><li><span><a href=\"#Viewing-your-model-output\" data-toc-modified-id=\"Viewing-your-model-output-4\"><span class=\"toc-item-num\">4&nbsp;&nbsp;</span>Viewing your model output</a></span></li></ul></div>"
    ]
   },
   {
@@ -34,6 +34,19 @@
     "- Training lesson as a Jupyter Notebook\n",
     "- Jupyter Notebook server\n",
     "\n",
+    "### Lesson contents\n",
+    "This lesson walks through the process of running both the WRF Preprocessing system (WPS) to generate necessary input files and the coupled WRF | WRF-Hydro model. \n",
+    "\n",
+    "In order to run the WPS there are effectively three main steps:\n",
+    "\n",
+    "1. Define a model domain and any nested domains with geogrid.\n",
+    "\n",
+    "2. Extract meteorological fields from GRIB data sets for the simulation period with ungrib.\n",
+    "\n",
+    "3. Horizontally interpolate meteorological fields to the model domains with metgrid.\n",
+    "\n",
+    "From here we use prepared WRF-Hydro input files from the coupled test case and the files generated via the WPS utilities to run real, a utility to produce intial and boundary condition files for the WRF simulation, and finally the coupled model itself.\n",
+    "\n",
     "## Running the WRF Preprocessing System (WPS)\n",
     "\n",
     "We'll start the lesson by running the WRF Preprocessing System (WPS) utilities.\n",
@@ -401,7 +414,7 @@
    "source": [
     "**Now list the files in your run directory**\n",
     "\n",
-    "Note the hydro output file follow the  YYYYMMDDHHMM.* and wrfout_d0x_*.  "
+    "You should notice a number of familiar WRF-Hydro output files as well as some WRF output (`wrfout*`) files.  Note that fields typically found in LDASOUT files for a standalone WRF-Hydro simulation can be found in these WRF output files.   "
    ]
   },
   {
@@ -509,7 +522,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.6.1"
+   "version": "3.6.5"
   },
   "toc": {
    "base_numbering": 1,