Add science use case comparing AORC and CONUS404

Data Access Examples/AORC - Data Collection and Manipulation Primer/requirements.txt

@@ -0,0 +1,11 @@
+fsspec  >= 2024.6.0
+geopandas >= 0.14.4
+numpy     >= 1.26.4
+matplotlib >= 3.9.0
+dask[complete] >= 2024.5.2
+xarray    >= 2024.5.0
+rioxarray >= 0.15.5
+geocube   >= 0.5.2
+s3fs      >= 2024.6.0
+zarr      >= 2.18.2
+jupyterlab >= 4.4.3

Data Access Examples/AORC - Data Collection and Manipulation Primer/sample-data/watershed.cpg

@@ -0,0 +1 @@
+ISO-8859-1

Data Access Examples/AORC - Data Collection and Manipulation Primer/sample-data/watershed.prj

@@ -0,0 +1 @@
+PROJCS["NAD_1983_Contiguous_USA_Albers",GEOGCS["GCS_North_American_1983",DATUM["D_North_American_1983",SPHEROID["GRS_1980",6378137.0,298.257222101]],PRIMEM["Greenwich",0.0],UNIT["Degree",0.0174532925199433]],PROJECTION["Albers"],PARAMETER["False_Easting",0.0],PARAMETER["False_Northing",0.0],PARAMETER["Central_Meridian",-96.0],PARAMETER["Standard_Parallel_1",29.5],PARAMETER["Standard_Parallel_2",45.5],PARAMETER["Latitude_Of_Origin",23.0],UNIT["Meter",1.0]]

Data Access Examples/AORC - Retrieval of AORC Data for Hydrologic Analysis/AORC_LL_PointRetrieval.ipynb

@@ -29,7 +29,7 @@
     "<li>Pabitra Dash <a href=\"mailto:[email protected]\">([email protected])</a></li>\n",
     "</ul>\n",
     "\n",
-    "**Last Updated:** 4/1/2025\n",
+    "**Last Updated:** 7/22/2025\n",
     "\n",
     "**Purpose:**\n",
     "\n",
@@ -52,48 +52,23 @@
     "\n",
     "**Software Requirements:**\n",
     "\n",
-    "This notebook has been tested using Python v3.11.8 using the following library versions:\n",
-    "\n",
-    " >  numpy: 1.26.4  \n",
-    "    geopandas: 0.14.4  \n",
-    "    matplotlib: 3.8.3  \n",
-    "    xarray: 2024.3.0  \n",
-    "    s3fs: 2024.3.1  \n",
-    "    fsspec: 2024.3.1  \n",
-    "    contextily: 1.6.2  \n",
-    "    zarr: 2.17.2  \n",
-    "\n",
-    "It also uses code from aorc_utils.py and environment specifications from requirements.txt, which accompany this notebook."
+    "This notebook uses a number of Python libraries, which are imported in the first cell below. If any of these libraries are not installed, you may need to install them. If installing them results in problems due to package conflicts, we recommend setting up a Conda environment to run this notebook. The notebook [CondaEnvironmentSetup](./conda_env/CondaEnvironmentSetup.ipynb) has been provided to do this for you. Once you have set up the Conda environment, you will need to switch the kernel being used to execute this notebook to the new Conda environment: use *Python [cond env:.conda-aorc]* if this kernel is in the list, otherwise, use *Python3 (AORC)*.  \n"
    ]
   },
   {
    "cell_type": "markdown",
    "id": "51b364f4-93ae-4e44-bea0-7ecc0286125d",
    "metadata": {},
    "source": [
-    "### 1. Prepare the Python Environment"
+    "### 1. Import the Libraries"
    ]
   },
   {
    "cell_type": "markdown",
    "id": "25bd810b-9a55-4da7-8ce8-2089c8209abf",
    "metadata": {},
    "source": [
-    "Use the following command to ensure that all dependencies are installed in your environment. Note, these library versions have been pinned and tested for `Python 3.11.8`. Install and import the libraries needed for this notebook."
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "id": "8b83a7ff-0e3d-4d8f-be62-66b2a12c9bac",
-   "metadata": {
-    "scrolled": true,
-    "tags": []
-   },
-   "outputs": [],
-   "source": [
-    "# note: this cell can be skipped if the dependencies have already been installed.\n",
-    "!pip install -r requirements.txt"
+    "Import the libraries needed to run this notebook:"
    ]
   },
   {
@@ -103,7 +78,6 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "import numpy as np\n",
     "import pandas as pd\n",
     "import matplotlib.pyplot as plt\n",
     "import contextily as ctx \n",
@@ -405,7 +379,9 @@
    "cell_type": "code",
    "execution_count": null,
    "id": "4551ef61-b686-4fd0-91e1-633ae54a5a85",
-   "metadata": {},
+   "metadata": {
+    "tags": []
+   },
    "outputs": [],
    "source": [
     "# Extracting the time (x-axis) and variable data (y-axis) to plot\n",
@@ -441,9 +417,9 @@
  ],
  "metadata": {
   "kernelspec": {
-   "display_name": "Python 3 (ipykernel)",
+   "display_name": "Python [conda env:.conda-aorc]",
    "language": "python",
-   "name": "python3"
+   "name": "conda-env-.conda-aorc-py"
   },
   "language_info": {
    "codemirror_mode": {
@@ -455,7 +431,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.11.8"
+   "version": "3.10.18"
   }
  },
  "nbformat": 4,

Data Access Examples/AORC - Retrieval of AORC Data for Hydrologic Analysis/AORC_LL_ZoneRetrieval.ipynb

@@ -29,7 +29,7 @@
     "<li>Pabitra Dash <a href=\"mailto:[email protected]\">([email protected])</a></li>\n",
     "</ul>\n",
     "\n",
-    "**Last Updated:** 4/1/2025\n",
+    "**Last Updated:** 7/22/2025\n",
     "\n",
     "**Purpose:**\n",
     "\n",
@@ -52,47 +52,23 @@
     "\n",
     "**Software Requirements:**\n",
     "\n",
-    "This notebook has been tested using Python v3.11.8 using the following library versions:\n",
-    "\n",
-    " >  numpy: 1.26.4  \n",
-    "    geopandas: 0.14.4  \n",
-    "    matplotlib: 3.8.3  \n",
-    "    xarray: 2024.3.0  \n",
-    "    s3fs: 2024.3.1  \n",
-    "    fsspec: 2024.3.1  \n",
-    "    contextily: 1.6.2  \n",
-    "    exactextract: 0.2.0  \n",
-    "    zarr: 2.17.2  \n",
-    "\n",
-    "It also uses code from aorc_utils.py and environment specifications from requirements.txt, which accompany this notebook."
+    "This notebook uses a number of Python libraries, which are imported in the first cell below. If any of these libraries are not installed, you may need to install them. If installing them results in problems due to package conflicts, we recommend setting up a Conda environment to run this notebook. The notebook [CondaEnvironmentSetup](./conda_env/CondaEnvironmentSetup.ipynb) has been provided to do this for you. Once you have set up the Conda environment, you will need to switch the kernel being used to execute this notebook to the new Conda environment: use *Python [cond env:.conda-aorc]* if this kernel is in the list, otherwise, use *Python3 (AORC)*.   \n"
    ]
   },
   {
    "cell_type": "markdown",
    "id": "bbe7d469-31ce-41ad-8c9f-6fed524a5787",
    "metadata": {},
    "source": [
-    "### 1. Prepare the Python Environment"
+    "### 1. Import the Libraries"
    ]
   },
   {
    "cell_type": "markdown",
-   "id": "204f080d-b558-46ec-8aef-e90ae7ba48d1",
+   "id": "a3903883-8c25-40cb-b79e-7d5e984432d7",
    "metadata": {},
    "source": [
-    "Use the following command to ensure that all dependencies are installed in your environment. Note, these library versions have been pinned and tested for `Python 3.11.8`. Install and import the libraries needed for this notebook."
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "id": "940edf7c-8ecc-468c-8191-c83413b1e0df",
-   "metadata": {
-    "scrolled": true
-   },
-   "outputs": [],
-   "source": [
-    "!pip install -r requirements.txt"
+    "Import the libraries needed to run this notebook:"
    ]
   },
   {
@@ -106,7 +82,6 @@
     "import xarray as xr\n",
     "import geopandas as gpd\n",
     "import matplotlib.pyplot as plt\n",
-    "import fsspec\n",
     "import s3fs\n",
     "import warnings\n",
     "from shapely.geometry import box\n",
@@ -538,7 +513,9 @@
    "cell_type": "code",
    "execution_count": null,
    "id": "eecbfb4c-79de-473a-8d6a-e1112d6ab9f6",
-   "metadata": {},
+   "metadata": {
+    "tags": []
+   },
    "outputs": [],
    "source": [
     "da_animate(da_over_area, gdf, variable_name, units, agg_interval)"
@@ -547,9 +524,9 @@
  ],
  "metadata": {
   "kernelspec": {
-   "display_name": "Python 3 (ipykernel)",
+   "display_name": "Python [conda env:.conda-aorc]",
    "language": "python",
-   "name": "python3"
+   "name": "conda-env-.conda-aorc-py"
   },
   "language_info": {
    "codemirror_mode": {
@@ -561,7 +538,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.11.8"
+   "version": "3.10.18"
   }
  },
  "nbformat": 4,

Data Access Examples/AORC - Retrieval of AORC Data for Hydrologic Analysis/AORC_NWMProj_PointRetrieval.ipynb

@@ -29,7 +29,7 @@
     "<li>Pabitra Dash <a href=\"mailto:[email protected]\">([email protected])</a></li>\n",
     "</ul>\n",
     "\n",
-    "**Last Updated:** 4/1/2025\n",
+    "**Last Updated:** 7/22/2025\n",
     "\n",
     "**Purpose:**\n",
     "\n",
@@ -52,48 +52,23 @@
     "\n",
     "**Software Requirements:**\n",
     "\n",
-    "This notebook has been tested using Python v3.11.8 using the following library versions:\n",
-    "\n",
-    " >  numpy: 1.26.4  \n",
-    "    geopandas: 0.14.4  \n",
-    "    matplotlib: 3.8.3  \n",
-    "    xarray: 2024.3.0  \n",
-    "    s3fs: 2024.3.1  \n",
-    "    fsspec: 2024.3.1  \n",
-    "    contextily: 1.6.2  \n",
-    "    zarr: 2.17.2  \n",
-    "\n",
-    "It also uses code from aorc_utils.py and environment specifications from requirements.txt, which accompany this notebook."
+    "This notebook uses a number of Python libraries, which are imported in the first cell below. If any of these libraries are not installed, you may need to install them. If installing them results in problems due to package conflicts, we recommend setting up a Conda environment to run this notebook. The notebook [CondaEnvironmentSetup](./conda_env/CondaEnvironmentSetup.ipynb) has been provided to do this for you. Once you have set up the Conda environment, you will need to switch the kernel being used to execute this notebook to the new Conda environment: use *Python [cond env:.conda-aorc]* if this kernel is in the list, otherwise, use *Python3 (AORC)*.   \n"
    ]
   },
   {
    "cell_type": "markdown",
    "id": "931dd8d9-bc19-42b7-a0b0-e7360546c342",
    "metadata": {},
    "source": [
-    "### 1. Prepare the Python Environment"
+    "### 1. Import the Libraries"
    ]
   },
   {
    "cell_type": "markdown",
-   "id": "25bd810b-9a55-4da7-8ce8-2089c8209abf",
+   "id": "3c1dcd45-30af-4ac7-86bd-518307a224a4",
    "metadata": {},
    "source": [
-    "Use the following command to ensure that all dependencies are installed in your environment. Note, these library versions have been pinned and tested for `Python 3.11.8`. Install and import the libraries needed for this notebook."
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "id": "8b83a7ff-0e3d-4d8f-be62-66b2a12c9bac",
-   "metadata": {
-    "scrolled": true,
-    "tags": []
-   },
-   "outputs": [],
-   "source": [
-    "# note: this cell can be skipped if the dependencies have already been installed.\n",
-    "!pip install -r requirements.txt"
+    "Import the libraries needed to run this notebook:"
    ]
   },
   {
@@ -103,7 +78,6 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "import numpy as np\n",
     "import pandas as pd\n",
     "import geopandas as gpd\n",
     "import contextily as ctx \n",
@@ -387,7 +361,9 @@
    "cell_type": "code",
    "execution_count": null,
    "id": "92f695a1-e94f-40a3-ac56-769e2da43843",
-   "metadata": {},
+   "metadata": {
+    "tags": []
+   },
    "outputs": [],
    "source": [
     "# Extracting the time (x-axis) and variable data (y-axis) to plot\n",
@@ -423,9 +399,9 @@
  ],
  "metadata": {
   "kernelspec": {
-   "display_name": "Python 3 (ipykernel)",
+   "display_name": "Python [conda env:.conda-aorc]",
    "language": "python",
-   "name": "python3"
+   "name": "conda-env-.conda-aorc-py"
   },
   "language_info": {
    "codemirror_mode": {
@@ -437,7 +413,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.11.8"
+   "version": "3.10.18"
   }
  },
  "nbformat": 4,