uw-cryo / asp_tutorials Goto Github PK

View Code? Open in Web Editor NEW

8.0 2.0 2.0 26.11 MB

Interactive tutorials for the NASA Ames Stereo Pipeline

License: MIT License

Jupyter Notebook 99.89% Python 0.11%

asp_tutorials's Introduction

asp_tutorials

Interactive tutorials for Ames Stereo Pipeline (ASP) processing.

Launch on GitHub Codespaces

☝️ this button will launch an Cloud-hosted computer on Microsoft Azure with ASP and related software pre-installed.

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.

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

Additional details on Github CodeSpace and usage

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.

asp_tutorials's People

Contributors

Stargazers

Watchers

Forkers

whigg tirthankar97

asp_tutorials's Issues

Migrate from driveanon to Zenodo for storing the sample images

Update tarball to ASP 3.0+, modify calls from notebook accordingly

Work on repo restructure, file naming etc as new examples are added.

Research and create a way to download ASTER stereo imagery using the earthaccess api

See ICESat-2 hackweek tutorial for details.

Removing binder links due to limited RAM machines availability

After recent updates to the binder project, they only allocate 2 GB RAM machines, as per the update here. This is pretty restrictive to run ASP. In consultation with @scottyhq, I removed mention of binder from the Readme, we will keep revisiting as things evolve!

Note that with a recent small fix, I put in the devcontainer.json document, now the correct working environment is the "recommended environment" when running notebooks on GitHub codespace, which will hopefully be straightforward for users to select :)

Also provide static jupyterbook access

https://jupyterbook.org/en/stable/start/your-first-book.html

Notes on updating example-aster_stereo_reconstruction.ipynb

Just running this as a test and noticed it was still calling stereo for the ASTER example - we should update to parallel_stereo

Also, might be good to give people approximate runtimes in the doc above the cells running stereo/parallel_stereo, so they know how long to wait. I was seeing ~2.5-3 m for all stereo runs (regardless of camera model type) on codespaces.

Should be clear that these are images from the ASTER VNIR instrument.

Maybe we can include the new --aster-use-csm option (https://stereopipeline.readthedocs.io/en/latest/examples/aster.html#using-the-csm-model). Possibly even jitter_solve?

It could also make sense to keep the intro/example tutorial relatively simple, and have a second notebook for the more advanced processing, potentially with a difference map for the output DEMs from different camera models.

There are some other typos, but can review later. No rush on this, just wanted to jot down some notes.

Trusted notebook issue - no plots when rendering on github

No plots are appearing, just text "Make this Notebook Trusted to load map: File -> Trust Notebook"

https://github.com/uw-cryo/asp_tutorials/blob/master/tutorials/example-dem_altimetry_coregistration.ipynb

I remember seeing this same warning years ago. I don't remember the issue or solution, but it was pretty straightforward to resolve.

Add an image to the readme

Would be nice for users to see in the readme what they'll create by running the aster notebook

Upcoming tutorials for round 1

Correlation scheme comparisons (select and interesting sub-site, potentially channels near glacier termini of Mt. Rainier)
2D ground displacement
Bundle adjustment (select good data)
Orthoimage alignment
Mosiacking rasters (examples with images and DEMs)
WV processing example over a small area