A guide to the NASA Ames Stereo Pipeline (ASP), runnable in a pre-configured GitHub Codespace with ASP and asp-plot installed.
Have a
.eduemail? Apply to the GitHub Student Developer Pack (or GitHub for Teachers for faculty) for a larger monthly Codespaces allowance.
The Ames Stereo Pipeline produces digital elevation models (DEMs) from stereo imagery. stereopipeline-quickstart is a guided introduction: launch a Codespace, run the notebooks, inspect the output with asp-plot.
The companion package asp-plot handles visualization: diagnostic plots, PDF reports, ICESat-2 comparisons.
Click "Open in GitHub Codespaces" above. The Codespace pulls a pre-built container image with ASP and asp-plot already installed, then opens VS Code in your browser. Open a notebook under notebooks/ and run cells top-to-bottom.
The tutorials use openly available data; no API keys, no Earthdata login required:
| Tutorial | Sensor | Region | Data source |
|---|---|---|---|
01_aster_rainier.ipynb |
ASTER L1A | Mt. Rainier, WA | Zenodo (10.5281/zenodo.7972223) |
02_worldview_ucsd.ipynb |
WorldView-3 | UCSD, San Diego | SpaceNet CORE3D (AWS S3) |
03_worldview_ucsd_ba.ipynb |
WorldView-3 | UCSD, San Diego | SpaceNet CORE3D (AWS S3) |
For explanations and conceptual background, visit stereopipeline-quickstart.readthedocs.io.
- Install ASP. Download a binary release and add
bin/to yourPATH. - Install
asp-plotviapip install asp-plotorconda install -c conda-forge asp-plot. - Clone this repo and
pip install -r requirements.txtfor notebook dependencies.
See docs/start/installation.md for details.
NeoGeographyToolkit/StereoPipeline— ASP itself- ASP documentation — canonical reference
uw-cryo/asp_plot— visualization companion (used heavily here)uw-cryo/asp_tutorials— earlier tutorial repo this one evolves from
BSD 3-Clause. See LICENSE.