asp_plot#

PyPI conda-forge DOI RTD

A Python package for visualizing output from the NASA Ames Stereo Pipeline (ASP).

asp_plot generates diagnostic plots and comprehensive PDF reports for ASP stereo processing results, similar to reports from commercial SfM software like Agisoft Metashape.

Features#

Installation

Install via conda or pip.

Installation
CLI Usage

Generate reports from the command line.

CLI Tools
Example Reports

View PDF reports for different sensors.

Example Reports
Example Notebooks

Modular usage examples by sensor type.

Example Notebooks
API Reference

Full Python API documentation.

API Reference
Contributing

Development setup, testing, and releases.

Contributing

What it does#

  • Stereo DEM processing visualization (hillshades, disparity maps, match points)

  • Bundle adjustment analysis (residual maps, histograms)

  • CSM camera model comparisons (position/orientation differences)

  • ICESat-2 ATL06-SR altimetry comparisons (Earth-based only), with optional automatic pc_align refinement and a before/after alignment report

  • Stereo geometry visualization from satellite camera metadata

  • Comprehensive PDF report generation

Supported Sensors#

asp_plot reads the same satellite camera metadata the Stereo Pipeline itself does, so a pair ASP can process is a pair asp_plot can plot the geometry of:

  • Earth: WorldView / GeoEye / QuickBird / IKONOS, the Airbus DIMAP family (Pléiades 1A/1B and Neo, SPOT 5 and 6/7, PeruSat-1), ASTER, and RPC-only products such as Cartosat-1 and Deimos

  • Lunar: Lunar Reconnaissance Orbiter Narrow Angle Camera (LRO NAC)

  • Mars: Mars Reconnaissance Orbiter CTX and HiRISE, Mars Global Surveyor MOC

Planetary sensors are handled through their CSM model states (csm_camera_plot) rather than the camera-metadata readers.