Jupyter Notebooks for the soilgrids Data Component

This resource includes two Jupyter Notebooks as a quick start tutorial for the soilgrids Data Component of the PyMT modeling framework (https://pymt.readthedocs.io/en/latest/).

The soilgrids Python package provides a set of functions that allows downloading of the global gridded soil information from SoilGrids https://www.isric.org/explore/soilgrids, a system for global digital soil mapping to map the spatial distribution of soil properties across the globe. The soilgrids package also includes a Basic Model Interface (BMI https://bmi.readthedocs.io/en/latest/) that can be used for data/model coupling under the PyMT modeling framework.

The pymt_soilgrids Python package uses the BMI of the soilgrids package to convert it into a reusable, plug-and-play data component for PyMT modeling framework. This allows the SoilGrids datasets to be easily coupled with other datasets or models that expose a BMI.

HydroShare users can test and run the Jupyter Notebooks (soilgrids.ipynb, pymt_soilgrids.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 soilgrids data component, please create a github issue at https://github.com/gantian127/soilgrids/issues

本资源包含两个Jupyter Notebook，作为PyMT建模框架（https://pymt.readthedocs.io/en/latest/）中土壤网格数据组件的快速入门教程。土壤网格Python包提供了一系列函数，允许从全球土壤网格信息库SoilGrids（https://www.isric.org/explore/soilgrids）下载全球网格化的土壤信息，该系统用于全球数字土壤制图，以绘制全球土壤属性的空间分布。土壤网格包还包括一个基本模型接口（BMI https://bmi.readthedocs.io/en/latest/），可用于在PyMT建模框架下进行数据/模型耦合。pymt_soilgrids Python包利用土壤网格包的BMI将其转换为PyMT建模框架下的可重用、即插即用的数据组件。这使得SoilGrids数据集能够轻松与暴露BMI的其他数据集或模型相耦合。HydroShare用户可以通过以下步骤直接在“CUAHSI JupyterHub”网络应用中测试和运行Jupyter Notebook（soilgrids.ipynb，pymt_soilgrids.ipynb）：对于CUAHSI JupyterHub的新用户，请首先申请加入“CUAHSI云计算组”（https://www.hydroshare.org/group/156）。批准后，用户将获得启动CUAHSI JupyterHub的权限。- 点击页面右上角的“打开方式”按钮。- 选择“CUAHSI JupyterHub”。- 选择“CSDMS工作台”服务器选项。（请确保选择正确的服务器选项。否则，笔记本可能无法正确运行。）如有关于土壤网格数据组件的任何疑问或建议，请创建github issue于https://github.com/gantian127/soilgrids/issues。