National Water Model HydroLearn Python Notebooks

This resource contains Jupyter Python notebooks which are intended to be used to learn about the U.S. National Water Model (NWM). These notebooks explore NWM forecasts in various ways. NWM Notebooks 1, 2, and 3, access NWM forecasts directly from the NOAA NOMADS file sharing system. Notebook 4 accesses NWM forecasts from Google Cloud Platform (GCP) storage in addition to NOMADS. A brief summary of what each notebook does is included below:

Notebook 1 (NWM1_Visualization) focuses on visualization. It includes functions for downloading and extracting time series forecasts for any of the 2.7 million stream reaches of the U.S. NWM. It also demonstrates ways to visualize forecasts using Python packages like matplotlib.

Notebook 2 (NWM2_Xarray) explores methods for slicing and dicing NWM NetCDF files using the python library, XArray.

Notebook 3 (NWM3_Subsetting) is focused on subsetting NWM forecasts and NetCDF files for specified reaches and exporting NWM forecast data to CSV files.

Notebook 4 (NWM4_Hydrotools) uses Hydrotools, a new suite of tools for evaluating NWM data, to retrieve NWM forecasts both from NOMADS and from Google Cloud Platform storage where older NWM forecasts are cached. This notebook also briefly covers visualizing, subsetting, and exporting forecasts retrieved with Hydrotools.

**NOTE: Notebook 4 Requires a newer version of NumPy that is not available on the default CUAHSI JupyterHub instance. Please use the instance "HydroLearn - Intelligent Earth" and ensure to run !pip install hydrotools.nwm_client[gcp].**

The notebooks are part of a NWM learning module on HydroLearn.org. When the associated learning module is complete, the link to it will be added here. It is recommended that these notebooks be opened through the CUAHSI JupyterHub App on Hydroshare. This can be done via the 'Open With' button at the top of this resource page.

本资源包含旨在学习美国国家水文模型（NWM）的 Jupyter Python 笔记本。这些笔记本以多种方式探索 NWM 的预报。NWM 笔记本 1、2 和 3 直接从美国国家海洋和大气管理局（NOAA）的 NOMADS 文件共享系统中获取 NWM 预报。笔记本 4 除了从 NOMADS 获取 NWM 预报外，还从 Google Cloud Platform（GCP）存储中获取。以下简要概述了每个笔记本的功能：

笔记本 1（NWM1_可视化）专注于可视化。它包括用于下载和提取美国 NWM 中任何 270 万条河流流域的时间序列预报的功能。它还展示了使用 matplotlib 等 Python 包进行预报可视化的方法。

笔记本 2（NWM2_Xarray）探讨了使用 python 库 XArray 对 NWM NetCDF 文件进行切片和切块的方法。

笔记本 3（NWM3_子集）专注于对 NWM 预报和 NetCDF 文件进行子集处理，并为指定的流域导出 NWM 预报数据至 CSV 文件。

笔记本 4（NWM4_Hydrotools）利用 Hydrotools，一套用于评估 NWM 数据的新工具集，从 NOMADS 和 Google Cloud Platform 存储中检索 NWM 预报，其中较旧的 NWM 预报被缓存。该笔记本还简要介绍了使用 Hydrotools 检索的预报的可视化、子集处理和导出。

**注意：** 笔记本 4 需要一个较新的 NumPy 版本，而该版本在默认的 CUAHSI JupyterHub 实例上不可用。请使用“HydroLearn - Intelligent Earth”实例，并确保运行 !pip install hydrotools.nwm_client[gcp]。

这些笔记本是 HydroLearn.org 上的 NWM 学习模块的一部分。当相关的学习模块完成后，将在此处添加其链接。建议通过 Hydroshare 上的 CUAHSI JupyterHub App 打开这些笔记本。这可以通过资源页面顶部的“打开方式”按钮完成。