Lab-0007: Difference between revisions

Revision as of 17:53, 14 October 2021

River-Delta Interactions

Model
CEM

Duration
1.5 hrs

Updated
2020/08/26

Download
download

Run online using:

Jupyter

Contributor(s)

Irina Overeem at INSTAAR - University of Colorado.

Introduction

Explore coastal processes by 1) a spreadsheet lab or 2) an advanced modeling lab using the CEM model. We look at the effects of waves and river avulson on a coastline. The spreadsheet lab can be downloaded at https://csdms.colorado.edu/csdms_wiki/images/CoastlineEvolutionLab.zip

Classroom organization
The Coastline Evolution Model (CEM) addresses predominately sandy, wave-dominated coastlines on time-scales ranging from years to millenia and on spatial scales ranging from kilometers to hundreds of kilometers. Shoreline evolution results from gradients in wave-driven alongshore sediment transport. The model has been used to represent varying geology underlying a sandy coastline and shoreface in a simplified manner and enables the simulation of coastline evolution when sediment supply from an eroding shoreface may be constrained. CEM also supports the simulation of human manipulations to coastline evolution through beach nourishment or hard structures. To learn more about the models in this lab, specifically the Coastal Evolution Model, CEM, you can download the presentation.

This lab includes experiments to couple the terrestrial and coastal domains. We will be looking at a river supplying sediment to a coastal zone, along which wave-driven longshore transport occurs. We will learn about the effect of incoming wave fields, the effect of sediment supply to the coast, and whether this supply happens through a single delta channel or multiple delta channels. Many deltas are classified as wave-dominated deltas, the Arno Delta in Italy is one example.

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: CoupledAvulsionCEMWMTversion.pptx
A presentation on using the CEM model.

Learning objectives
Skills

Use pymt to run the CEM model
Become familiar with a basic configuration of the CEM model
Make small changes to key input parameters in CEM
Gain hands-on experience with visualizing output in Python

Key concepts

Generate a wave-dominated delta
Explore the influence of wave conditions (e.g., wave height, wave angle) on delta formation
Explore the influence of river input on delta formation

Lab notes

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 Coastline Evolution 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.

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

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

Ashton, A, A.B. Murray, and O. Arnoult. 2001. Formation of coastline features by large-scale instabilities induced by high-angle waves. Nature 414: 296-300., doi: 10.1038/35104541
Ashton, A.D. and Murray, A.B., 2006. High-angle wave instability and emergent shoreline shapes: 2. Wave climate analysis and comparisons to nature. Journal of Geophysical Research 111. F04012., doi: 10.1029/2005JF000423

@@ Line 2: / Line 2: @@
 |Labtitle=River-Delta Interactions
 |LabCOModule=1 of 1
-|LabDateContributedOrUpdated=2020/03/20
+|LabDateContributedOrUpdated=2020/08/26
-|LabDescriptionShort=Explore coastal processes by 1) a spreadsheet lab or 2) an advanced modeling lab using the CEM model. We look at the effects of waves and river avulson on the coastline.
+|LabDescriptionShort=Explore coastal processes by 1) a spreadsheet lab or 2) an advanced modeling lab using the CEM model. We look at the effects of waves and river avulson on a coastline.
 |LabCODuration=1.5 hrs
 |LabModelDocumentation=CEM
 |LabAssociatedLesson=Jupyter Notebook
-|LabURLDownloadNotebook=https://raw.githubusercontent.com/csdms/pymt/master/notebooks/cem_and_waves.ipynb
+|LabURLDownloadNotebook=https://downgit.github.io/#/home?url=https://github.com/csdms/pymt/blob/master/notebooks/cem.ipynb
-|LabURLStartNotebook=https://hub.gke.mybinder.org/user/csdms-pymt-7see43gj/notebooks/notebooks/cem.ipynb
+|LabURLStartNotebook=https://csdms.rc.colorado.edu/hub/user-redirect/git-pull?repo=https%3A%2F%2Fgithub.com%2Fcsdms%2Fpymt&urlpath=tree%2Fpymt%2Fnotebooks%2Fcem.ipynb&branch=master
 }}
 {{LabContributorData
@@ Line 16: / Line 16: @@
 }}
 {{LabIntro
-|LabDescription=Explore coastal processes by 1) a spreadsheet lab or 2) an advanced modeling lab using the CEM model. We look at the effects of waves and river avulson on the coastline. See also the spreadsheet lab: https://csdms.colorado.edu/mediawiki/images/CoastlineEvolutionLab.zip
+|LabDescription=Explore coastal processes by 1) a spreadsheet lab or 2) an advanced modeling lab using the CEM model. We look at the effects of waves and river avulson on a coastline. The spreadsheet lab can be downloaded at https://csdms.colorado.edu/csdms_wiki/images/CoastlineEvolutionLab.zip
 |LabPicture=NewCEMcolormap.png
 }}
@@ Line 24: / Line 24: @@
 This lab includes experiments to couple the terrestrial and coastal domains. We will be looking at a river supplying sediment to a coastal zone, along which wave-driven longshore transport occurs. We will learn about the effect of incoming wave fields, the effect of sediment supply to the coast, and whether this supply happens through a single delta channel or multiple delta channels. Many deltas are classified as wave-dominated deltas, the Arno Delta in Italy is one example.
-This lab will run CEM 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.
-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=CoupledAvulsionCEMWMTversion.pptx
+|LabCOPresentationText=''A presentation on using the CEM model.''
 }}
 {{LabLearningObjectivesSkills
-|LabSkill=use Pymt to run CEM Model
+|LabSkill=Use ''pymt'' to run the CEM model
 }}
 {{LabLearningObjectivesSkills
-|LabSkill=familiarize with a basic configuration of the CEM Model
+|LabSkill=Become familiar with a basic configuration of the CEM model
 }}
 {{LabLearningObjectivesSkills
-|LabSkill=make changes to key input parameters
+|LabSkill=Make small changes to key input parameters in CEM
 }}
 {{LabLearningObjectivesSkills
-|LabSkill=hands-on experience with visualizing output in Python
+|LabSkill=Gain hands-on experience with visualizing output in Python
 }}
 {{Headerplaceholder}}
 {{LabTopicalLearningObjectives
-|LabTopicalLearningObjective=generate a wave-dominated delta
+|LabTopicalLearningObjective=Generate a wave-dominated delta
 }}
 {{LabTopicalLearningObjectives
-|LabTopicalLearningObjective=explore the influence of wave conditions (e.g., wave height, wave angle) on delta formation
+|LabTopicalLearningObjective=Explore the influence of wave conditions (e.g., wave height, wave angle) on delta formation
 }}
 {{LabTopicalLearningObjectives
-|LabTopicalLearningObjective=explore the influence of river input on delta formation
+|LabTopicalLearningObjective=Explore the influence of river input on delta formation
 }}
 {{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:
->> Open a new browser window and open the Pymt read the docs page: https://pymt.readthedocs.io/en/latest/examples.html
+>> 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 Coastline Evolution Model.
->> Click on the 'Launch Binder' box and it will allow you to see this lab as a Jupyter Notebook.
+>> 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.
->> You can execute the Jupyter notebook code cells using shift -enter.
+CEM is run with the Python Modeling Tool, pymt. Learn more about pymt at: https://pymt.readthedocs.io.
 |LabNotesFigure=launch_binder_cem.png
 |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