asp_tutorials

Launch a preconfigured computing environment with interactive example notebooks for Ames Stereo Pipeline processing on 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.

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.