HAND Workflow Example for the Little Bear River near Paradise, Utah

This is an example of Geoscience Use Case 4: Height Above the Nearest Drainage (HAND) of "Improving Reproducibility of Geoscience Models with Sciunit" in the Geological Society of America publication. In this resource, there are two notebooks: 1) HANDWorkFlow.ipynb and 2) HAND_Sciunit.ipynb.

Using these two notebooks, we demonstrate the capabilities of Sciunit to encapsulate the HAND TauDEM workflow and create a Sciunit Container, and evaluate differences in HAND due to changing the contributing area threshold used to map the drainage network. During computation of the drainage network, a minimum contributing area threshold is used to identify the channel beginning. With a lower threshold value, the density of the resulting drainage network increases. Scientists running this experiment might be interested in finding out how the threshold makes a difference in the execution and result of the HAND model.

The first notebook demonstrates the general procedure to calculate HAND (Height above the Nearest Drainage) using TauDEM (https://hydrology.usu.edu/taudem/taudem5/).
Then using the second notebook we demonstrate how to create a Sciunit container for HAND Workflow and compare two Sciunit containers (5000 vs 50000 thresholds) using `diff` command.

本例展示了地质科学应用案例4：最近排水面以上高度（HAND）在《美国地质学会出版物中提升地质科学模型可重现性之Sciunit》中的应用。在本资源中，包含两个笔记本：1) HANDWorkFlow.ipynb 和 2) HAND_Sciunit.ipynb。通过这两个笔记本，我们展示了Sciunit在封装HAND TauDEM工作流程并创建Sciunit容器中的能力，并评估了由于改变用于绘制排水网络的贡献区域阈值而引起的HAND差异。在计算排水网络时，使用最低贡献区域阈值来识别渠道起点。阈值值越低，生成的排水网络密度越高。进行此实验的科学家可能感兴趣的是了解阈值如何影响HAND模型的执行和结果。第一个笔记本演示了使用TauDEM（https://hydrology.usu.edu/taudem/taudem5/）计算HAND（最近排水面以上高度）的一般步骤。然后，使用第二个笔记本，我们展示了如何为HAND工作流程创建Sciunit容器，并使用`diff`命令比较两个Sciunit容器（5000与50000阈值）。