Lab-0005: Difference between revisions

From CSDMS
m (Update download and run online URLs)
No edit summary
(8 intermediate revisions by one other user not shown)
Line 2: Line 2:
|Labtitle=Sediment Supply to the Global Ocean
|Labtitle=Sediment Supply to the Global Ocean
|LabCOModule=1 of 1
|LabCOModule=1 of 1
|LabDateContributedOrUpdated=2020/03/26
|LabDateContributedOrUpdated=2020/08/25
|LabDescriptionShort=Investigate river sediment supply to the ocean by exploring the effects of climate changes on river fluxes. We also look at the effect of humans on rivers: the building of a reservoir.
|LabDescriptionShort=Investigate river sediment supply to the ocean by exploring the effects of climate changes on river fluxes. We also look at the effect of humans on rivers: the building of a reservoir.
|LabCODuration=2.0 hrs
|LabCODuration=2.0 hrs
Line 16: Line 16:
}}
}}
{{LabIntro
{{LabIntro
|LabDescription=Investigate river sediment supply to the ocean by exploring the effects of climate changes on river fluxes. We also look at the effect of humans on rivers: the building of a reservoir.  
|LabDescription=In this lab, we use the HydroTrend model to investigate river sediment supply to the ocean by exploring the effects of climate change on river fluxes. We also look at the effect of humans on rivers: the building of a reservoir.
See also the spreadsheet lab: https://csdms.colorado.edu/mediawiki/images/RiverFluxtoOceanSpreadsheetLab.zip
|LabPicture=Lab3sedsupply.png
|LabPicture=Lab3sedsupply.png
}}
}}
{{LabClassroomOrganization
{{LabClassroomOrganization
|LabCOIntro=In this lab, we are using a theoretical river basin of ~1990 km<sup>2</sup>, with 1200m of relief and a river length of ~100 km. All parameters that are shown by default once the HydroTrend Model is loaded are based on a present-day, temperate climate.
|LabCOIntro=In this lab, we are using a theoretical river basin of ~1990 km<sup>2</sup>, with 1200m of relief and a river length of ~100 km. All parameters that are shown by default once the HydroTrend model is loaded are based on a present-day, temperate climate.
Whereas these runs are not meant to be specific, we are using parameters that are realistic for the Waiapaoa River in New Zealand. The Waiapaoa River is located on North Island and receives high rain and has erodible soils, so the river sediment loads are exceptionally high. It has been called the 'dirtiest small river in the world'. A more detailed description of applying HydroTrend to the Waipaoa basin, New Zealand has been published in WRR: http://dx.doi.org/10.1029/2006WR005570. To learn more about HydroTrend and its approach to sediment supply modeling, you can download the presentation: SedimentSupplyModeling02_2013.ppt.
Whereas these runs are not meant to be specific, we are using parameters that are realistic for the Waiapaoa River in New Zealand. The Waiapaoa River, located on North Island, receives high rain and has erodible soils, so the river sediment loads are exceptionally high. It has been called the 'dirtiest small river in the world'. A more detailed description of applying HydroTrend to the Waipaoa basin has been published in ''Water Resources Research'': http://dx.doi.org/10.1029/2006WR005570. To learn more about HydroTrend and its approach to sediment supply modeling, download the presentation listed below.


This lab will run HydroTrend simulation with Python Modeling Tool (Pymt). If you have never used the Pymt, learn how to use it: https://pymt.readthedocs.io/en/latest/install.html. The Pymt allows you to set up simulations and run notebooks.
This lab can be run on the CSDMS JupyterHub. (If you don't already have an account, follow the instructions to sign up at: https://csdms.colorado.edu/wiki/JupyterHub.) Run the lab Notebook by clicking the "start" link under the '''Run online''' heading at the top of this page. If you're an educator using this lab in a class, you can get CSDMS JupyterHub accounts for students. For more information, please contact us through the CSDMS Help Desk: https://github.com/csdms/help-desk.
 
You can create an account at CSDMS JupyterHub and test the Jupyter Notebook for this lab. Please follow the instruction at: https://github.com/csdms/pymt/blob/master/notebooks/README.md. If you are a faculty at an academic institution, it is possible to work with us to get temporary teaching accounts. Work directly with us by emailing: csdms@colorado.edu.
|LabCOPresentationUpload=SedimentSupplyModeling02_2013.ppt
|LabCOPresentationUpload=SedimentSupplyModeling02_2013.ppt
|LabCOPresentationText=To learn more about HydroTrend and its approach to sediment supply modeling
|LabCOPresentationText=''Learn more about HydroTrend and its approach to sediment supply modeling from this presentation.''
}}
}}
{{LabLearningObjectivesSkills
{{LabLearningObjectivesSkills
|LabSkill=use Pymt to run HydroTrend Model
|LabSkill=Use ''pymt'' to run the HydroTrend model
}}
}}
{{LabLearningObjectivesSkills
{{LabLearningObjectivesSkills
|LabSkill=familiarize with a basic configuration of the HydroTrend Model
|LabSkill=Become familiar with a basic configuration of the HydroTrend model
}}
}}
{{LabLearningObjectivesSkills
{{LabLearningObjectivesSkills
|LabSkill=make small changes to key input parameters
|LabSkill=Make small changes to key input parameters in HydroTrend
}}
}}
{{LabLearningObjectivesSkills
{{LabLearningObjectivesSkills
|LabSkill=hands-on experience with visualizing output in Python
|LabSkill=Gain hands-on experience with visualizing output in Python
}}
}}
{{Headerplaceholder}}
{{Headerplaceholder}}
{{LabTopicalLearningObjectives
{{LabTopicalLearningObjectives
|LabTopicalLearningObjective=explore the HydroTrend base-case river simulation
|LabTopicalLearningObjective=Explore the HydroTrend base-case river simulation
}}
}}
{{LabTopicalLearningObjectives
{{LabTopicalLearningObjectives
|LabTopicalLearningObjective=how does a river system respond to climate change
|LabTopicalLearningObjective=Explore how a river system responds to climate change
}}
}}
{{LabTopicalLearningObjectives
{{LabTopicalLearningObjectives
|LabTopicalLearningObjective=how do human affect river sediment loads
|LabTopicalLearningObjective=Learn how humans can affect river sediment loads
}}
}}
{{LabNotes
{{LabNotes
|LabNotesInstructions=You can launch binder to directly run the Jupyter Notebook for this lab through a web browser.
|LabNotesInstructions=Instead of downloading the lab Notebook and running it locally, or running it through the CSDMS JupyterHub, you can also run it on Binder. Follow these steps:
<br>
>> Open a new browser window and go to: https://pymt.readthedocs.io/en/latest/examples.html
 
>> You will see that there are several example models. In this lab we will select the HydroTrend model.


>> Open a new browser window and open the Pymt read the docs page at: https://pymt.readthedocs.io/en/latest/examples.html
>> Click on the "Launch Binder" button to run this lab.


>> You will see that there are several example models. In this lab we will select the HydroTrend model.
Note that Binder is a free and popular service for running Jupyter Notebooks, so it can be slow to load at times.


>> Click on the 'Launch Binder' box and it will allow you to see this lab as a Jupyter Notebook.
The HydroTrend model is run with the Python Modeling Tool, ''pymt''. Learn more about ''pymt'' at: https://pymt.readthedocs.io.


>> You can execute the Jupyter notebook code cells using shift -enter.
For a similar lab done with a spreadsheet, download and try: https://csdms.colorado.edu/csdms_wiki/images/RiverFluxtoOceanSpreadsheetLab.zip.
|LabNotesFigure=launch_binder_hydrotrend2.png
|LabNotesFigure=launch_binder_hydrotrend2.png
|LabNotesFigureCaption=Launch binder
|LabNotesFigureCaption=Launch binder
|LabNotesRequirements=--
|LabNotesRequirements=If run locally, this lab requires the installtion of pymt; see https://pymt.readthedocs.io/en/latest/quickstart.html for instructions. This lab runs on Linux and macOS.
|LabAcknowledgements=This material is based upon work supported by the National Science Foundation under Grant No. 1831623, ''Community Facility Support: The Community Surface Dynamics Modeling System (CSDMS)''.
}}
}}
{{LabReferences
{{LabReferences
|LabReferences=Kettner, A.J., and Syvitski, J.P.M., 2008. HydroTrend version 3.0: a Climate-Driven Hydrological Transport Model that Simulates Discharge and Sediment Load leaving a River System. Computers & Geosciences, 34(10), 1170-1183. doi: 10.1016/j.cageo.2008.02.008
|LabReferences=Kettner, A.J., and Syvitski, J.P.M., 2008. HydroTrend version 3.0: a Climate-Driven Hydrological Transport Model that Simulates Discharge and Sediment Load leaving a River System. Computers & Geosciences, 34(10), 1170-1183. doi: 10.1016/j.cageo.2008.02.008
}}
}}

Revision as of 17:53, 14 October 2021

Sediment Supply to the Global Ocean

Duration
2.0 hrs
Updated
2020/08/25
Download
download
Run online using:
  1. Jupyter
     Jupyter logo.png

Contributor(s)
    Irina Overeem at INSTAAR - University of Colorado Boulder.

Introduction
Lab3sedsupply.png
In this lab, we use the HydroTrend model to investigate river sediment supply to the ocean by exploring the effects of climate change on river fluxes. We also look at the effect of humans on rivers: the building of a reservoir.

Classroom organization
In this lab, we are using a theoretical river basin of ~1990 km2, with 1200m of relief and a river length of ~100 km. All parameters that are shown by default once the HydroTrend model is loaded are based on a present-day, temperate climate.

Whereas these runs are not meant to be specific, we are using parameters that are realistic for the Waiapaoa River in New Zealand. The Waiapaoa River, located on North Island, receives high rain and has erodible soils, so the river sediment loads are exceptionally high. It has been called the 'dirtiest small river in the world'. A more detailed description of applying HydroTrend to the Waipaoa basin has been published in Water Resources Research: http://dx.doi.org/10.1029/2006WR005570. To learn more about HydroTrend and its approach to sediment supply modeling, download the presentation listed below.

This lab can be run on the CSDMS JupyterHub. (If you don't already have an account, follow the instructions to sign up at: https://csdms.colorado.edu/wiki/JupyterHub.) Run the lab Notebook by clicking the "start" link under the Run online heading at the top of this page. If you're an educator using this lab in a class, you can get CSDMS JupyterHub accounts for students. For more information, please contact us through the CSDMS Help Desk: https://github.com/csdms/help-desk.

Download associated file: SedimentSupplyModeling02_2013.ppt
Learn more about HydroTrend and its approach to sediment supply modeling from this presentation.

Learning objectives
Skills
  • Use pymt to run the HydroTrend model
  • Become familiar with a basic configuration of the HydroTrend model
  • Make small changes to key input parameters in HydroTrend
  • Gain hands-on experience with visualizing output in Python
Key concepts
  • Explore the HydroTrend base-case river simulation
  • Explore how a river system responds to climate change
  • Learn how humans can affect river sediment loads

Lab notes
Launch binder hydrotrend2.png
Launch binder
Instead of downloading the lab Notebook and running it locally, or running it through the CSDMS JupyterHub, you can also run it on Binder. Follow these steps:


>> Open a new browser window and go to: https://pymt.readthedocs.io/en/latest/examples.html

>> You will see that there are several example models. In this lab we will select the HydroTrend model.

>> Click on the "Launch Binder" button to run this lab.

Note that Binder is a free and popular service for running Jupyter Notebooks, so it can be slow to load at times.

The HydroTrend model is run with the Python Modeling Tool, pymt. Learn more about pymt at: https://pymt.readthedocs.io.

For a similar lab done with a spreadsheet, download and try: https://csdms.colorado.edu/csdms_wiki/images/RiverFluxtoOceanSpreadsheetLab.zip.

Requirements
If run locally, this lab requires the installtion of pymt; see https://pymt.readthedocs.io/en/latest/quickstart.html for instructions. This lab runs on Linux and macOS.

Acknowledgements
This material is based upon work supported by the National Science Foundation under Grant No. 1831623, Community Facility Support: The Community Surface Dynamics Modeling System (CSDMS).

References
  • Kettner, A.J., and Syvitski, J.P.M., 2008. HydroTrend version 3.0: a Climate-Driven Hydrological Transport Model that Simulates Discharge and Sediment Load leaving a River System. Computers & Geosciences, 34(10), 1170-1183. doi: 10.1016/j.cageo.2008.02.008