asp_tutorials

Launch a preconfigured computing environment with interactive example notebooks for Ames Stereo Pipeline processing on BinderHub or GitHub Codespaces

Development Status

This repository is under active development; we will be adding tutorials for different ASP processing capabilities, and for different Earth and Planetary datasets. Stay tuned!! Community feedback is welcomed through github issues :D

Launch on GitHub Codespaces (preferred way)

☝️ this button will launch an Cloud-hosted computer on Microsoft Azure with a VSCode interface. GitHub currently gives every user 120 vCPU hours per month for free, beyond that you must pay. So be sure to explicitly stop or shut down your codespace when you are done by going to this page (https://github.com/codespaces/).

• More details on codespace lifecycle is explained here.

Launch on Mybinder.org

☝️ this button will launch an ephemeral Cloud-hosted computer with a JupyterLab interface that is convenient for demos. The computing cost is graciously supported by the scientific community (https://binderhub.readthedocs.io/en/stable/federation/federation.html) but you do not have control over computing resources (which are typically limited to 2vCPU and 4GB RAM), and files are not saved between sessions.

Usage

Once the codespace is launched, navigate to the tutorials folder from the file Explorer on the left of your codespace screen, and open the example-aster\_stereo\_reconstruction.ipynb notebook and run the cells to execute the interactive tutorial.

Sample L1A ASTER stereo images

• The tutorial uses sample L1A stereo images acquired by the ASTER instrument over Mt. Rainier, WA on July 31, 2017 (AST_L1A_00307312017190728_20200218153629_19952.zip)
• More details can be found on the data product page: https://lpdaac.usgs.gov/products/ast_l1av003/
• The sample data were downloaded from the NASA EarthData website. We are rehosting on Zenodo to enable on-demand access to the sample images when running the tutorial.

Example output

Figure: Example output DEM produced from ASTER imagery acquired over Mt. Rainier. Top Row: Orthorectified A) left and B) right stereo images. Middle Row: Disparity in C) x (E-W) and D) y (N-S) direction. Bottom Row: E) Intersection error and F) Digital Elevation Model.