Checking for non-preferred file/folder path names (may take a long time depending on the number of files/folders) ...

Jupyter Notebooks for the Retrieval of AORC Data for Hydrologic Analysis


Authors:
Owners: This resource does not have an owner who is an active HydroShare user. Contact CUAHSI (help@cuahsi.org) for information on this resource.
Type: Resource
Storage: The size of this resource is 7.5 MB
Created: Mar 18, 2024 at 7:24 p.m.
Last updated: Apr 09, 2025 at 3:23 p.m.
Citation: See how to cite this resource
Content types: Geographic Feature Content 
Sharing Status: Public
Views: 2341
Downloads: 830
+1 Votes: Be the first one to 
 this.
Comments: No comments (yet)

Abstract

This HydroShare resource contains Jupyter Notebooks with instructions and code for accessing and subsetting the NOAA Analysis of Record for Calibration (AORC) dataset. The resource includes four Jupyter Notebooks:
1. AORC_LL_PointRetrieval.ipynb: Retrieves and aggregates data from the latitude-longitude gridded dataset for a specific point specified using geographic coordinates.
2. AORC_LL_ZoneRetrieval.ipynb: Retrieves and aggregates data from the latitude-longitude gridded dataset for an area defined by a polygon shapefile.
3. AORC_NWMProj_PointRetrieval.ipynb: Retrieves and aggregates data from the NWM projected dataset for a specific point specified using geographic coordinates.
4. AORC_NWMProj_ZoneRetrieval.ipynb: Retrieves and aggregates data from the NWM projected dataset for an area defined by a polygon shapefile.

These notebooks programmatically retrieve the data from Amazon Web Services, aggregate it at user-defined time scales (which may differ from NOAA’s original time steps), and, in the case of shapefile-based data retrieval, compute the average over the shapes in the given shapefile.

The provided notebooks are coded to retrieve data from AORC version 1.1 in Zarr format, either from the latitude-longitude gridded dataset (https://registry.opendata.aws/noaa-nws-aorc/) or the NWM projected dataset (https://registry.opendata.aws/nwm-archive/)

Subject Keywords

Coverage

Spatial

Coordinate System/Geographic Projection:
WGS 84 EPSG:4326
Coordinate Units:
Decimal degrees
Place/Area Name:
US
North Latitude
49.1415°
East Longitude
-76.0062°
South Latitude
24.8306°
West Longitude
-125.0495°

Temporal

Start Date:
End Date:

Content

README.md

Jupyter Notebooks for the Retrieval of AORC Data for Hydrologic Analysis

This resource includes the following files:

  • AORC_LL_PointRetrieval.ipynb: Retrieves and aggregates data from the AORC latitude-longitude gridded dataset for a specific point specified using geographic coordinates.
  • AORC_LL_ZoneRetrieval.ipynb: Retrieves and aggregates data from the AORC latitude-longitude gridded dataset for an area defined by a polygon shapefile.
  • AORC_NWMProj_PointRetrieval.ipynb: Retrieves and aggregates data from the NWM projected dataset for a specific point specified using geographic coordinates.
  • AORC_NWMProj_ZoneRetrieval.ipynb: Retrieves and aggregates data from the NWM projected dataset for an area defined by a polygon shapefile.
  • aorc_utils.py: A Python script containing functions used by the notebooks.
  • requirements.txt: Lists the specific python library dependency versions required to run the notebooks.
  • GSLSubbasins: A shapefile of the Great Salt Lake Basin used as an example.
  • AORC_DataRetrieval.pdf: Notes on the coordinate systems and some of the differences between the datasets.
  • README.md: Explains the content of this resource.

To use this resource in HydroShare, select Open With on one of the available application servers to launch the corresponding JupyterHub environment. Then, open the Jupyter Notebook for the format of the data you wish to retrieve and follow the instructions.

This resource is designed to be opened from a JupyterHub platform connected to CUAHSI HydroShare. It has been tested using CUAHSI JupyterHub, CIROH JupyterHub, and CyberGIS-Jupyter for Water. Note: In CyberGIS-Jupyter for Water, use the Python 3-2024-03 kernel to avoid package conflicts.

The development versions of these notebooks are available on GitHub: https://github.com/CUAHSI/notebooks in the Data Access Examples / AORC - Retrieval of AORC Data for Hydrologic Analysis folder.

You may access this resource in HydroShare at: http://www.hydroshare.org/resource/72ea9726187e43d7b50a624f2acf591f

Cite this resource as: Salehabadi, H., D. Tarboton, A. Nassar, A. M. Castronova, P. Dash (2025). Jupyter Notebooks for the Retrieval of AORC Data for Hydrologic Analysis, HydroShare, http://www.hydroshare.org/resource/72ea9726187e43d7b50a624f2acf591f

Data Services

The following web services are available for data contained in this resource. Geospatial Feature and Raster data are made available via Open Geospatial Consortium Web Services. The provided links can be copied and pasted into GIS software to access these data. Multidimensional NetCDF data are made available via a THREDDS Data Server using remote data access protocols such as OPeNDAP. Other data services may be made available in the future to support additional data types.

Related Resources

This resource belongs to the following collections:
Title Owners Sharing Status My Permission
Hydrological Data Retrieval Using CIROH JupyterHUB Ayman Nassar · David Tarboton  Public &  Shareable Open Access
Curated List of Datasets for the CIROH Portal Dan Ames  Public &  Shareable Open Access

Credits

Funding Agencies

This resource was created using funding from the following sources:
Agency Name Award Title Award Number
National Oceanic and Atmospheric Administration (NOAA), University of Alabama CIROH: Enabling collaboration through data and model sharing with CUAHSI HydroShare NA22NWS4320003 to University of Alabama, subaward A23-0266-S001 to Utah State University
National Science Foundation HDR Institute: Geospatial Understanding through an Integrative Discovery Environment 2118329

How to Cite

Salehabadi, H., D. Tarboton, A. Nassar, A. M. Castronova, P. Dash (2025). Jupyter Notebooks for the Retrieval of AORC Data for Hydrologic Analysis, HydroShare, http://www.hydroshare.org/resource/72ea9726187e43d7b50a624f2acf591f

This resource is shared under the Creative Commons Attribution CC BY.

http://creativecommons.org/licenses/by/4.0/
CC-BY

Comments

There are currently no comments

New Comment

required