Update Cookbook Content

Revise notebook and landing page

notebooks/datasets/SWOT_USGS_Comparison.ipynb

@@ -23,12 +23,11 @@
     "\n",
     "## Requirements\n",
     "\n",
-    "### 1. Compute environment \n",
+    "### Compute environment:\n",
     "\n",
     "This tutorial is written to run in the following environment:\n",
     "- **Local compute environment** e.g. laptop, server: this tutorial can be run on your local machine\n",
-    "\n",
-    "- GDAL must be installed (https://gdal.org/)\n",
+    "- **GDAL** must be installed (https://gdal.org/)\n",
     "\n",
     "### Import libraries"
    ]
@@ -58,9 +57,11 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "1. USGS Lake/Reservoir Water Surface Elevation dataset can be acccessed using the [DataRetrieval](https://github.com/DOI-USGS/dataretrieval-python) python module with the parameter code 62615. \n",
+    "**1. USGS Lake/Reservoir Water Surface Elevation dataset** can be acccessed using the [DataRetrieval](https://github.com/DOI-USGS/dataretrieval-python) python module with the parameter code 62615. \n",
+    "\n",
+    "**2. SWOT LakeSP dataset** can be accessed using the [Earthaccess](https://earthaccess.readthedocs.io/en/latest/) python module or the [PO.DAAC Data Downloader](https://podaac.github.io/tutorials/quarto_text/DataSubscriberDownloader.html). \n",
     "\n",
-    "2. SWOT LakeSP dataset can be accessed using the [Earthaccess](https://earthaccess.readthedocs.io/en/latest/) python module or the [PO.DAAC Data Downloader](https://podaac.github.io/tutorials/quarto_text/DataSubscriberDownloader.html). \n",
+    "The above data were combined outside of this tutorial into a csv file called 'usgs_swot_merged_example.csv'.\n",
     "\n",
     "### Datum Transformation to Compare with SWOT Data\n",
     "\n",
@@ -336,7 +337,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.10.14"
+   "version": "3.8.13"
   }
  },
  "nbformat": 4,

quarto_text/SWOT_Datum.qmd

@@ -1,26 +1,20 @@
 ---
 title: Datum Conversion for SWOT Data
 subtitle: Community Tutorials
-jupyter:
-  jupytext:
-    text_representation:
-      extension: .qmd
-      format_name: quarto
-      format_version: '1.0'
-      jupytext_version: 1.16.1
-  kernelspec:
-    display_name: Python 3 (ipykernel)
-    language: python
-    name: python3
 ---
 
-# Datum Conversion for SWOT Data
+### Use the Handbook
 
 Please first see the [SWOT Data User Handbook](https://archive.podaac.earthdata.nasa.gov/podaac-ops-cumulus-docs/web-misc/swot_mission_docs/D-109532_SWOT_UserHandbook_20240502.pdf?_ga=2.76536725.1816513343.1724259518-1354658737.1715875596) sections 3.3.3 on the reference ellipsoid and 11.3.1 on the geoid. In addition, section 3.1.23 gives detailed information about Height with section 3.1.24 elaborating on Sea Surface Height Anomalies and 3.1.25 elaborating on Water Surface Elevation over inland waters.
 
+## Community Tutorials
+
 As a summary, SWOT data is referenced to the WGS84 reference ellipsoid as a first step, and in a second step referenced to the EGM2008 geoid that references WGS84. To get a direct conversion with another dataset, it is easiest to transform all local data to the EGM2008 geoid. We recognize this conversion is different globally and depending on the data being used to compare, but we have collected a few community examples of direct comparisons to share below:
 
-1. Comparing USGS gage data and SWOT data in the United States - [Python Notebook](../notebooks/datasets/SWOT_USGS_Comparison.ipynb)
-2. Converting the SWOT Frame and Geoid in Canada - [Google Colab Section from Canadian Colleagues](https://colab.research.google.com/drive/1we0a24gBKbs-CFMVBfRIUm4SSW8RdwmA#scrollTo=cu09EYYRxxd4)
+#### 1. Comparing **USGS gage** data and SWOT data in the **United States** - [Python Notebook](../notebooks/datasets/SWOT_USGS_Comparison.ipynb)
+
+#### 2. Converting the SWOT Frame and Geoid in **Canada** - [Google Colab Section from Canadian Colleagues](https://colab.research.google.com/drive/1we0a24gBKbs-CFMVBfRIUm4SSW8RdwmA#scrollTo=cu09EYYRxxd4)
+
+### For More Help
 
 If you have any questions for your specific region, please ask in the [Earthdata Forum](https://forum.earthdata.nasa.gov/viewforum.php?f=7) and experts should be able to help.