Lab-0001: Difference between revisions

From CSDMS
No edit summary
No edit summary
 
(15 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{Labbasics
{{Labbasics
|Labtitle=Introduction to Permafrost Processes - Frost Number Model
|Labtitle=Permafrost Modeling - where does permafrost occur?
|LabCOModule=1 of 2
|LabCOModule=1 of 4
|LabCOSeriesName=Permafrost
|LabCOSeriesName=Permafrost
|LabDateContributedOrUpdated=2020/03/20
|LabDateContributedOrUpdated=2022-04-20
|LabDescriptionShort=What is permafrost and how do you make a first-order prediction about permafrost occurrence. This is lesson 1 in a mini-course on permafrost, this lab uses the Air Frost Number and annual temperature data to predict permafrost occurrence.
|LabDescriptionShort=What is permafrost and how do you make a first-order prediction about permafrost occurrence. This is lesson 1 in a mini-course on permafrost, this lab uses the Air Frost Number and annual temperature data to predict permafrost occurrence.
|LabCODuration=1.5 hrs
|LabCODuration=1.5 hrs
|LabModelDocumentation=Frost Model
|LabModelDocumentation=Frost Model
|LabAssociatedLesson=Jupyter Notebook
|LabURLDownloadNotebook=https://raw.githubusercontent.com/csdms/pymt/master/notebooks/frost_number.ipynb
|LabURLStartNotebook=https://jupyter.openearthscape.org/hub/user-redirect/git-pull?repo=https%3A%2F%2Fgithub.com%2Fcsdms%2Fpymt&urlpath=tree%2Fpymt%2Fnotebooks%2Ffrost_number.ipynb&branch=master
|LabURL2StartNotebook=https://lab.openearthscape.org/hub/user-redirect/git-pull?repo=https%3A%2F%2Fgithub.com%2Fcsdms%2Fpymt&urlpath=tree%2Fpymt%2Fnotebooks%2Ffrost_number.ipynb&branch=master
}}
}}
{{LabContributorData
{{LabContributorData
Line 28: Line 32:
}}
}}
{{LabIntro
{{LabIntro
|LabDescription=Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet, consetetur sadipscing elitr,  sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet, consetetur sadipscing elitr,  sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet.
|LabDescription=<p>What is permafrost and how do you make a first-order prediction about permafrost occurrence. This is lesson 1 in a mini-course on permafrost, this lab uses the Air Frost Number and annual temperature data to predict permafrost occurrence.</p>


Duis autem vel eum iriure dolor in hendrerit in vulputate velit esse molestie consequat, vel illum dolore eu feugiat nulla facilisis at vero eros et accumsan et iusto odio dignissim qui blandit praesent luptatum zzril delenit augue duis dolore te feugait nulla facilisi. Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh euismod tincidunt ut laoreet dolore magna aliquam erat volutpat.
<p>The Frost Number model is part of the Permamodel Toolbox, see Overeem ''et al.'' 2018.</p>
|LabPicture=Patternedground.png
|LabPicture=Patternedground.png
}}
}}
Line 38: Line 42:
Basic theory on the Air Frost Number is presented in File:FrostNumberModel Lecture1.pptx.
Basic theory on the Air Frost Number is presented in File:FrostNumberModel Lecture1.pptx.


This lab will likely take ~ 1,5 hours to complete in the classroom. This time assumes you are unfamiliar with the Pymt and need to learn setting parameters, and looking at output (otherwise it will be much faster).
This lab will likely take ~ 1.5 hours to complete in the classroom. This time assumes you are unfamiliar with pymt and need to learn setting parameters, and looking at output (otherwise it will be much faster).


If you have never used the Python Modeling Tool (Pymt), learn how to use it at: https://pymt.readthedocs.io/en/latest. The Pymt allows you to set up simulations, and run them and then analyze data using Python.
If you have never used the Python Modeling Tool (Pymt), learn how to use it at: https://pymt.readthedocs.io/en/latest. The Pymt allows you to set up simulations, and run them and then analyze data using Python.
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=FrostNumberModel Lecture1.pptx
|LabCOPresentationUpload=FrostNumberModel Lecture1.pptx
|Property:LabCOPresentationText=Basic theory on the Air Frost Number is presented in
|LabCOPresentationText=Presentation describes basic theory on the Air Frost Number
}}
}}
{{LabLearningObjectivesSkills
{{LabLearningObjectivesSkills
Line 72: Line 74:
}}
}}
{{LabNotes
{{LabNotes
|LabNotesInstructions=Here are the instructions
|LabNotesInstructions=<p>This lab can be run on the <em>lab</em> (for educators) and <em>jupyter</em> (for general use) instances of the OpenEarthscape JupyterHub: just click one of the links under the <strong>Run online using</strong> heading at the top of this page, then run the notebook in  the "CSDMS" kernel.</p>
|LabNotesFigure=Landlab-logo-below-lowercase.png
 
|LabNotesFigureCaption=Caption of the figure
<p>If you don't already have a JupyterHub account, follow the instructions to sign up at https://csdms.colorado.edu/wiki/JupyterHub. If you're an educator, you can get JupyterHub accounts for students--please contact us through the CSDMS Help Desk: https://csdms.github.io/help-desk.</p>
|LabNotesRequirements=--
|LabAcknowledgements=These labs are developed with support from NSF Grant 1503559, ‘Towards a Tiered Permafrost Modeling Cyberinfrastructure’ and are part of the Permafrost Modeling Toolbox, https://github.com/permamodel.
|LabAcknowledgements=These labs are developed with support from NSF Grant 1503559, ‘Towards a Tiered Permafrost Modeling Cyberinfrastructure’ and are part of the Permafrost Modeling Toolbox, https://github.com/permamodel.
}}
{{LabReferences
|LabReferences=Nelson, F.E., Outcalt, S.I., 1987. A computational method for prediction and prediction and regionalization of permafrost. Arct. Alp. Res. 19, 279–288.
}}
{{LabReferences
|LabReferences=Janke, J., Williams, M., Evans, A., 2012. A comparison of permafrost prediction models along a section of Trail Ridge Road, RMNP, CO. Geomorphology 138, 111-120.
}}
{{LabReferences
|LabReferences=Overeem, Irina, Jafarov, Elchin, Wang, Kang, Schaefer, Kevin, Stewart, Scott, Clow, Gary, Piper, Mark, and Elshorbany, Yasin, 2018: A Modeling Toolbox for Permafrost Landscapes. Eos, Transactions of the American Geophysical Union (Online). https://doi.org/10.1029/2018EO105155.
}}
}}

Latest revision as of 15:23, 20 April 2022

Permafrost Modeling - where does permafrost occur?

Duration
1.5 hrs
Updated
2022-04-20
Download
download
Run online using:
  1. Jupyter
  2. Lab
     Jupyter logo.png

This lab is part of the series Permafrost. Others in this series are:

Contributor(s)
    Irina Overeem at CSDMS, University of Colorado.
    Mark Piper at CSDMS, University of Colorado.
    Kang Wang at East China Normal University.
    Elchin Jafarov at Los Alamos National Labs, NM.

Introduction
Patternedground.png

What is permafrost and how do you make a first-order prediction about permafrost occurrence. This is lesson 1 in a mini-course on permafrost, this lab uses the Air Frost Number and annual temperature data to predict permafrost occurrence.

The Frost Number model is part of the Permamodel Toolbox, see Overeem et al. 2018.


Classroom organization
This lab is the first in a series of introduction to permafrost process modeling, designed for inexperienced users. In this first lesson, we explore the Air Frost Number model and learn to use such models in the CSDMS Python Model tool (Pymt). We implemented a basic configuration of the Air Frost Number (as formulated by Nelson and Outcalt in 1987). This lab is designed to gain some experience with running a numerical model, changing model inputs, and analyzing model output. Specifically, this first lab looks at what controls permafrost occurrence and compares the occurrence of permafrost in Russia.

Basic theory on the Air Frost Number is presented in File:FrostNumberModel Lecture1.pptx.

This lab will likely take ~ 1.5 hours to complete in the classroom. This time assumes you are unfamiliar with pymt and need to learn setting parameters, and looking at output (otherwise it will be much faster).

If you have never used the Python Modeling Tool (Pymt), learn how to use it at: https://pymt.readthedocs.io/en/latest. The Pymt allows you to set up simulations, and run them and then analyze data using Python.

Download associated file: FrostNumberModel Lecture1.pptx
Presentation describes basic theory on the Air Frost Number

Learning objectives
Skills
  • Familiarize with a basic configuration of the Air Frost Number Model
  • Make small changes to key input parameters
  • See how to write a loop for calculations over a time series
  • Hands-on experience with visualizing output in Python
Key concepts
  • What is the primary control on the occurrence of permafrost
  • Freezing and thawing day indices and how to approximate these
  • Where in Russia permafrost occurs
  • Critical evaluation of what the Air Frost number approximates

Lab notes

This lab can be run on the lab (for educators) and jupyter (for general use) instances of the OpenEarthscape JupyterHub: just click one of the links under the Run online using heading at the top of this page, then run the notebook in the "CSDMS" kernel.

If you don't already have a JupyterHub account, follow the instructions to sign up at https://csdms.colorado.edu/wiki/JupyterHub. If you're an educator, you can get JupyterHub accounts for students--please contact us through the CSDMS Help Desk: https://csdms.github.io/help-desk.


Acknowledgements
These labs are developed with support from NSF Grant 1503559, ‘Towards a Tiered Permafrost Modeling Cyberinfrastructure’ and are part of the Permafrost Modeling Toolbox, https://github.com/permamodel.

References
  • Nelson, F.E., Outcalt, S.I., 1987. A computational method for prediction and prediction and regionalization of permafrost. Arct. Alp. Res. 19, 279–288.
  • Janke, J., Williams, M., Evans, A., 2012. A comparison of permafrost prediction models along a section of Trail Ridge Road, RMNP, CO. Geomorphology 138, 111-120.
  • Overeem, Irina, Jafarov, Elchin, Wang, Kang, Schaefer, Kevin, Stewart, Scott, Clow, Gary, Piper, Mark, and Elshorbany, Yasin, 2018: A Modeling Toolbox for Permafrost Landscapes. Eos, Transactions of the American Geophysical Union (Online). https://doi.org/10.1029/2018EO105155.