Checking for non-preferred file/folder path names (may take a long time depending on the number of files/folders) ...
This resource contains some files/folders that have non-preferred characters in their name. Show non-conforming files/folders.
This resource contains content types with files that need to be updated to match with metadata changes. Show content type files that need updating.
| 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 5.1 MB | |
| Created: | Mar 18, 2024 at 7:24 p.m. | |
| Last updated: | Mar 07, 2025 at 11:40 p.m. | |
| Citation: | See how to cite this resource | |
| Content types: | Geographic Feature Content |
| Sharing Status: | Public |
|---|---|
| Views: | 2127 |
| 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 two Jupyter Notebooks:
1. AORC_Point_Data_Retrieval.ipynb: Retrieves data for a specific point within the U.S. AORC coverage area, specified using geographic coordinates.
2. AORC_Zone_Data_Retrieval.ipynb: Retrieves data for an area defined by an uploaded polygon shapefile.
These notebooks programmatically retrieve the data from Amazon Web Services (https://registry.opendata.aws/noaa-nws-aorc/) , aggregate data 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 released in ZARR format in December 2023.
The Analysis Of Record for Calibration (AORC) is a gridded record of near-surface weather conditions covering the continental United States and Alaska and their hydrologically contributing areas (https://registry.opendata.aws/noaa-nws-aorc/) It is defined on a latitude/longitude spatial grid with a mesh length of 30 arc seconds (~800 m), and a temporal resolution of one hour. Elements include hourly total precipitation, temperature, specific humidity, terrain-level pressure, downward longwave and shortwave radiation, and west-east and south-north wind components. It spans the period from 1979 across the Continental U.S. (CONUS) and from 1981 across Alaska, to the near-present (at all locations). This suite of eight variables is sufficient to drive most land-surface and hydrologic models and is used as input to the National Water Model (NWM) retrospective simulation. While the original NOAA process generated AORC data in netCDF format, the data has been post-processed to create a cloud optimized Zarr formatted equivalent that NOAA also disseminates.
Subject Keywords
Coverage
Spatial
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_Point_Data_Retrieval.ipynb: Retrieves and aggregates AORC data for a specific point specified by latitude and longitude or known geographic coordinates.
- AORC_Zone_Data_Retrieval.ipynb: Retrieves and aggregates AORC data for a spatial domain defined by a 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.
- 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: Nassar, A., D. Tarboton, H. Salehabadi, 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
Related Resources
| The content of this resource is similar to | https://github.com/CUAHSI/notebooks/tree/main/Data%20Access%20Examples/AORC%20-%20Retrieval%20of%20AORC%20Data%20for%20Hydrologic%20Analysis |
| 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
This resource is shared under the Creative Commons Attribution CC BY.
http://creativecommons.org/licenses/by/4.0/
Comments
There are currently no comments
New Comment