Freshwater-Initiative / SkagitLandslideHazards

Seattle City Light is interested in improving understanding of landslide hazard and sediment transport to ensure reliable and cost-effective hydropower generation.
4 stars 4 forks source link

SkagitLandslideHazards

Seattle City Light is interested in improving understanding of landslide hazard and sediment transport to ensure reliable and cost-effective hydropower generation.

Read more about the project:

Landslide probability modeling can be used to better understand landslides in the watersheds containing the electrical transmission lines and facilities. A recently published landslide model (Strauch et al. 2018) updated to use spatially distributed saturation (depth to water table) derived from a basin calibrated hydrologic model (Distributed Hydrology Soil and Vegetation Model - DHSVM) at 150-m grid resolution. Contemporary and future probability of landslide initiation is used to create landslide hazard maps at a 30-m resolution. Our case study of the Skagit Hydroelectric Project evaluates the sensitivity of the landslide model to subsurface saturation and reduced cohesion of a simulated a fire. We compare historic landslide probability to two future time periods using two scenarios (RCP 4.5 and RCP 8.5) and a representative distribution of global climate models (GCMs). Learn more about project sponsors at these links to University of Washington scope of work, Landlab, HydroShare, and PREEVENTs projects.

Quicklinks to HydroShare Resources:

To access and download Seattle City Light Contract Deliverables, visit the Landslide Hazard Modeling in the Skagit Basin HydroShare resource which contains the working folder of data and code and all GIS files.

A summary of the Data Sharing Agreement is available on this project Wiki page with a link to the formal agreement: Skagit DHSVM Glacio-hydrology Model Data Use Agreement

To interact with the data and code online, the resource contains files used to run the Landlab landslide model Slippery Future Data: Predicting future regional landslide probability using soil saturation. This this is the resource we use Launch Notebooks and code: Slippery Future Code: Predicting future regional landslide probability using soil saturation

For model users and developers, the DHSVM model instance with formatted input and output files are available at Skagit River Basin DHSVM model instance 2020.

See the Additional Resources section below for more information on model geographic extent, 2) preciptation and climate change data, 3) soils datasets and methods, 4) surficial geology, 5) landcover and land use, 6) outputs related to groundwater and soil processes, and 7) tools for streamflow model comparisons to observations at USGS stations.

Please cite our work

See the Slippery Future Citations & References.ipynb

This resource is an updated copy of the work published in Strauch et al., (2018) It demonstrates a hydroclimatological approach to modeling of regional shallow landslide initiation based on the infinite slope stability model coupled with a steady-state subsurface flow representation. The original work used recharge forcing from the VIC model to calculate relative wetness in the factor of safety equation; in this project we created a new version with depth to water table from DHSVM distributed hydrology model to utilize saturation forcings to in the calculation of landslide risk. The model component is available as the LandslideProbability component in Landlab, an open-source, Python-based landscape earth systems modeling environment described in Hobley et al. (2017) and Barnhart et al. (2020).

Barnhart, K. R., Hutton, E. W. H., Tucker, G. E., Gasparini, N. M., Istanbulluoglu, E., Hobley, D. E. J., Lyons, N. J., Mouchene, M., Nudurupati, S. S., Adams, J. M., and Bandaragoda, C.: Short communication: Landlab v2.0: A software package for Earth surface dynamics, Earth Surf. Dynam. Discuss., https://doi.org/10.5194/esurf-2020-12, in review, 2020.

Hobley, D. E. J., Adams, J. M., Nudurupati, S. S., Hutton, E. W. H., Gasparini, N. M., Istanbulluoglu, E. and Tucker, G. E., 2017, Creative computing with Landlab: an open-source toolkit for building, coupling, and exploring two-dimensional numerical models of Earth-surface dynamics, Earth Surface Dynamics, 5, p 21-46, 10.5194/esurf-5-21-2017.

Strauch, R., Istanbulluoglu, E., Nudurupati, S.S., Bandaragoda, C., Gasparini, N.M., Tucker, G.E., 2018. A hydroclimatological approach to predicting regional landslide probability using Landlab. Earth Surface Dynamics 6, 49–75. https://doi.org/10.5194/esurf-6-49-2018

Technical Steps to Get Started Developing Content and Code from the repository

Notebook User Instructions for interactive compute

If you are new to this cyber-ecosystem, start at Section 1.0. As you learn, start your work at other sections.

1.0 Get access to the data

Go to HydroShare.org and login at www.hydroshare.org. You will need a HydroShare user account to download data from the HydroShare data repository. We also use this user ID to access computational resources and servers.

VOCAB: Server: it could be high performance or under your friends desk. It's an online networked computer that enables you to access it from your web browser.

2.0 Get access to a computer

Notebook User Instructions specific for interactive compute on CyberGIS for Water

2.1 Do one time From the HydroShare website, top dashboard, Go to Collaborate. Find the CyberGIS for Water Compute Group, Ask to Join. An owner of a compute group may also invite you to join using your email or HydroShare User ID. An owner must confirm membership in order to access their server from a HydroShare resource.

2.2. Next time Go directly to https://js-168-155.jetstream-cloud.org/

New users: Get familiar with JupyterHub platform with [Juptyer Notebook new user instructions]( ) and JuptyerHub Documentation

2.3. Open a Jupyter Notebook. The example is enabled with code to interact with this repository.

Open a New Notebook Untitled.ipynb. Save, rename, navigate the folder structure.

3.0 Setup to Push/Pull code using Github

3.1 Do one time Use Jupyter Lab interface to add a Github folder to your user space and clone this repository. Add a new Folder using the + icon. Name it Github. Open a terminal. cd /home/jovyan/work pwd ls cd /home/jovyan/work/Github

> git clone https://github.com/Freshwater-Initiative/SkagitLandslideHazards.git

3.2 Do one time Use a new "Terminal" session and clone the github repository by running the command:

The terminal opens in /home/jovyan/

> cd data

Make a new directory specific to your Github repositories on this server.

> mkdir Github   

Clone the github repository by running the command:

> git clone https://github.com/Freshwater-Initiative/SkagitLandslideHazards.git

Open a Notebook using the directory structure on the left, go to Notebooks folder, click on a Notebook.ipynb

4.0 Pull code using Github

If this repository changes, and you do not have any changes to save, simply pull the changes to your workspace. Go back to the terminal view and run these lines.

> cd SkagitLandslideHazards
> git pull

Open a Notebook using the directory structure on the left, go to Notebooks folder, click on the changed Notebook.ipynb

5.0 Push code using Github

5.1 Do one time Set up permissions with Github from this computer

Run

  git config --global user.email "you@example.com"
  git config --global user.name "Your Name"

to set your account's default identity. Omit --global to set the identity only in this repository.

git config --global user.email "myemail@univ.edu
git config --global user.name "ChristinaB"

5.2 Do every time Do some work in a Notebook. Then use this sequence to tell Github that all changed files should be staged to move from the server to Github. Status prints out the changes, so you always review what you are going to push before you push it. Commiting the change with a message is the same task as uploading a file or changing a file from github.com repository interface.

git add *
git status
git commit -m"this is a brief useful note on the change or work"
git push

Notebook User Instructions for interactive compute on CSDMS JupyterHub

Related resouces on HydroShare:

Strauch, R., E. Istanbulluoglu, S. S. Nudurupati, C. Bandaragoda (2018). Regional landslide hazard using Landlab - NOCA Observatory, HydroShare, http://www.hydroshare.org/resource/3a925bd4a5784a38944b1e8b51224de1

Strauch, R., E. Istanbulluoglu, S. S. Nudurupati, C. Bandaragoda (2017). Regional landslide hazard using Landlab - NOCA Data, HydroShare, https://doi.org/10.4211/hs.a5b52c0e1493401a815f4e77b09d352b