Jupyter Notebooks for the NWIS Data Component

This resource includes two Jupyter Notebooks as a quick start tutorial for the NWIS Data Component of the PyMT modeling framework (https://pymt.readthedocs.io/) developed by Community Surface Dynamics Modeling System (CSDMS https://csdms.colorado.edu/).

The bmi_nwis package is an implementation of the Basic Model Interface (BMI https://bmi.readthedocs.io/en/latest/) for the USGS NWIS dataset (https://waterdata.usgs.gov/nwis). This package uses the dataretrieval package (https://github.com/USGS-python/dataretrieval) to download the NWIS dataset and wraps the dataset with BMI for data control and query. This package is not implemented for people to use but is the key element to convert the NWIS dataset into a data component for the PyMT modeling framework.

The pymt_nwis package is implemented for people to use as a reusable, plug-and-play NWIS data component for the PyMT modeling framework. This package uses the BMI implementation from the bmi_nwis package and allows the NWIS datasets to be easily coupled with other datasets or models that expose a BMI.

HydroShare users can test and run the Jupyter Notebooks (bmi_nwis.ipynb, pymt_nwis.ipynb) directly through the "CUAHSI JupyterHub" web app with the following steps:
- For the new user of the CUAHSI JupyterHub, please first make a request to join the "CUAHSI Could Computing Group" (https://www.hydroshare.org/group/156). After approval, the user will gain access to launch the CUAHSI JupyterHub.
- Click on the "Open with" button. (on the top right corner of the page)
- Select "CUAHSI JupyterHub".
- Select "CSDMS Workbench" server option. (Make sure to select the right server option. Otherwise, the notebook won't run correctly.)

If there is any question or suggestion about the NWIS data component, please create a github issue at https://github.com/gantian127/bmi_nwis/issues

本资源包含两个 Jupyter Notebook，作为 PyMT 模型框架（https://pymt.readthedocs.io/）中 NWIS 数据组件的快速入门教程（由社区地表动力学建模系统 [CSDMS](https://csdms.colorado.edu/) 开发）。

bmi_nwis 包实现了基本模型接口 [BMI](https://bmi.readthedocs.io/en/latest/)，用于美国地质调查局 (USGS) 的 NWIS 数据集（https://waterdata.usgs.gov/nwis）。此包利用 dataretrieval 包（https://github.com/USGS-python/dataretrieval）下载 NWIS 数据集，并使用 BMI 对数据集进行封装，以实现数据控制和查询。此包并非供用户使用，而是将 NWIS 数据集转换为 PyMT 模型框架数据组件的关键元素。

pymt_nwis 包专为用户使用而实现，作为 PyMT 模型框架的可重用、即插即用的 NWIS 数据组件。此包使用 bmi_nwis 包中的 BMI 实现，使得 NWIS 数据集能够轻松与其他公开 BMI 的数据集或模型耦合。

HydroShare 用户可以通过以下步骤直接在 "CUAHSI JupyterHub