asp-plot 1.7.0__tar.gz → 1.9.0__tar.gz

{asp_plot-1.7.0 → asp_plot-1.9.0}/.github/workflows/run-tests.yml

@@ -32,7 +32,6 @@ jobs:
         conda env create -f environment.yml
         source $CONDA/etc/profile.d/conda.sh
         conda activate asp_plot
-        pip install .
     - name: Test with pytest
       run: |
         source $CONDA/etc/profile.d/conda.sh

{asp_plot-1.7.0 → asp_plot-1.9.0}/.gitignore

@@ -70,6 +70,9 @@ instance/
 
 # Sphinx documentation
 docs/_build/
+docs/examples/notebooks/
+docs/_extra/
+docs/_static/reports/
 
 # PyBuilder
 target/
@@ -137,3 +140,5 @@ notebooks/**/*.parquet
 notebooks/**/*.csv
 CLAUDE*
 .claude/**
+scripts/
+/*.parquet

asp_plot-1.9.0/.readthedocs.yaml

@@ -0,0 +1,25 @@
+version: 2
+
+build:
+  os: "ubuntu-24.04"
+  tools:
+    python: "3.12"
+  jobs:
+    pre_build:
+      - mkdir -p docs/examples/notebooks
+      - cp notebooks/WorldView/*.ipynb docs/examples/notebooks/
+      - cp notebooks/ASTER/*.ipynb docs/examples/notebooks/
+      - cp notebooks/LRO_NAC/*.ipynb docs/examples/notebooks/
+      - cp notebooks/Mars_MGS/*.ipynb docs/examples/notebooks/
+      - cp notebooks/Mars_MRO/*.ipynb docs/examples/notebooks/
+      - mkdir -p docs/_extra/examples/figures
+      - cp notebooks/figures/* docs/_extra/examples/figures/
+      - mkdir -p docs/_static/reports
+      - cp reports/*.pdf docs/_static/reports/
+
+sphinx:
+  configuration: docs/conf.py
+
+python:
+  install:
+    - requirements: docs/requirements.txt

{asp_plot-1.7.0 → asp_plot-1.9.0}/CHANGELOG.md

@@ -5,6 +5,63 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.9.0] - 2026-03-10
+
+### Added
+- Match points now overlay on non-mapprojected images using alignment transform matrices (`run-align-{L,R}.txt`), replacing the previous blank-right-panel behavior
+- Report command string recorded in PDF report via new `report_command` parameter in `compile_report()`
+- Pixel-unit scalebar for non-mapprojected disparity plots (mapprojected scenes continue to use GSD-based scalebar)
+- Guard with `FileNotFoundError` when alignment matrix files are missing for non-mapprojected match point overlay
+- Warning when `unit="meters"` is passed for non-mapprojected disparity (unsupported, falls back to pixels)
+- Test coverage for non-mapprojected stereo code paths (9 new tests with resampled ASTER test data)
+
+### Changed
+- Report figures are now fitted to page dimensions, preventing overflow and cutoff for large/wide figures
+- Report caption reserve is now dynamically calculated from actual caption length instead of a hardcoded 20mm
+- Input Scenes caption updated to explain alignment rotation applied to non-mapprojected imagery
+- Match points right subplot title simplified from "Right (scenes shown only if mapprojected)" to "Right"
+- `save_figure()` default DPI changed from hardcoded 150 to `None` (uses figure's own creation DPI), fixing pixelated ICESat-2 report figures
+- ICESat-2 altimetry figures created at 220 DPI for high-quality PDF embedding
+- CLI parameter values are now quoted with `shlex.quote()` for proper reconstruction of commands with spaces
+- Cleaned up example notebook report links and removed stale PDF files
+- Removed unnecessary `read_align_matrix()` method; alignment matrices are loaded inline via `np.loadtxt()`
+
+### Fixed
+- Disparity plot scale for non-mapprojected scenes: GSD-based rescale was producing near-zero values from the identity transform; now skips rescaling and uses pixel-unit scalebar instead
+- Match point plot whitespace for non-mapprojected scenes caused by a 1x1 dummy image plotted underneath scatter points
+- Pixelated ICESat-2 ATL06-SR figures in PDF reports caused by `save_figure()` overriding figure DPI with 150
+
+## [1.8.0] - 2026-03-03
+
+### Added
+- New `_select_best_track()` method to find the RGT/cycle/spot combination with the most valid ATL06-SR points for profile plotting
+- New `histogram_by_landcover()` method producing a histogram of ICESat-2 vs DEM differences with per-landcover-class statistics (count, median, NMAD) using ESA WorldCover
+- New `plot_atl06sr_dem_profile()` method with a three-row figure: combined elevation + dh profile with dual y-axes, two 1 km zoom segments (best/worst agreement scored by |median(dh)| + NMAD), and DEM hillshade map with track overlay
+- Server-side time filtering for SlideRule API requests via new `_resolve_time_range()` method with three-tier cascade: explicit `scene_date` parameter, auto-detect from stereopair XML metadata, or 2-year fallback
+- `scene_date` and `time_buffer_days` parameters added to `request_atl06sr_multi_processing()`
+- Module-level `ICESAT2_MISSION_START` constant and `WORLDCOVER_NAMES` dictionary for reuse across methods
+- Module-level `_nmad()` helper function (Normalized Median Absolute Deviation)
+- Time range labels displayed on ICESat-2 plot titles
+- Tests for `_select_best_track`, `histogram_by_landcover`, `plot_atl06sr_dem_profile`, and `_resolve_time_range`
+
+### Changed
+- Migrated SlideRule API from legacy `icesat2.atl06p()` to x-series `sliderule_api.run("atl03x")` with automatic index and column normalization
+- Simplified ICESat-2 report section: single `"all"` processing level with landcover histogram and profile plot, replacing the previous multi-level (all + ground) workflow with temporal filtering and plain histograms
+- Report section ordering: bundle adjustment plots now appear after match points and before DEM hillshade
+- Profile plot legend now includes axis labels (left/right) for all entries and embeds Med/NMAD statistics in the dh legend item
+
+### Removed
+- `--icesat_filter_date` CLI option (time filtering is now automatic via `_resolve_time_range()`)
+- Commented-out `plot_atl06sr_dem_profiles()` stub and ATL03 request stub (replaced by implemented methods)
+- Duplicated WorldCover classification table from `filter_esa_worldcover()` docstring (now references `WORLDCOVER_NAMES`)
+
+### Fixed
+- `TypeError: Cannot subtract tz-naive and tz-aware datetime-like objects` in `predefined_temporal_filter_atl06sr` when scene date is UTC-aware but DataFrame index is tz-naive
+- `KeyError: 'translation_magnitude'` in `alignment_report()` when requested processing level has no data (now returns early with a warning)
+- `TypeError: unhashable type: 'numpy.ndarray'` in `histogram_by_landcover` caused by parquet round-trip deserializing arrays as Python lists
+- `TypeError: 'int' object is not callable` when builtin `len()` was shadowed by the `len=40` parameter inside `request_atl06sr_multi_processing`
+- `OverflowError: cannot convert float infinity to integer` in profile segment selection when median point spacing is zero
+
 ## [1.7.0] - 2026-02-24
 
 ### Added

asp_plot-1.9.0/PKG-INFO

@@ -0,0 +1,88 @@
+Metadata-Version: 2.4
+Name: asp_plot
+Version: 1.9.0
+Summary: Package for plotting outputs Ames Stereo Pipeline processing
+Project-URL: Homepage, https://github.com/uw-cryo/asp_plot
+Project-URL: Documentation, https://asp-plot.readthedocs.io
+Project-URL: Issues, https://github.com/uw-cryo/asp_plot/issues
+Author-email: Ben Purinton <purinton@uw.edu>, David Shean <dshean@uw.edu>, Shashank Bhushan <sbhusha1@umd.edu>
+License: BSD-3-Clause
+License-File: LICENSE
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.11
+Requires-Dist: click
+Requires-Dist: contextily
+Requires-Dist: fpdf2
+Requires-Dist: gdal
+Requires-Dist: geopandas
+Requires-Dist: matplotlib
+Requires-Dist: matplotlib-scalebar
+Requires-Dist: numpy
+Requires-Dist: pandas
+Requires-Dist: pyproj
+Requires-Dist: rasterio
+Requires-Dist: rioxarray
+Requires-Dist: scipy
+Requires-Dist: shapely
+Requires-Dist: sliderule
+Requires-Dist: xarray
+Provides-Extra: dev
+Requires-Dist: pre-commit; extra == 'dev'
+Requires-Dist: pytest; extra == 'dev'
+Provides-Extra: docs
+Requires-Dist: myst-nb; extra == 'docs'
+Requires-Dist: sphinx-autoapi; extra == 'docs'
+Requires-Dist: sphinx-autobuild; extra == 'docs'
+Requires-Dist: sphinx-book-theme; extra == 'docs'
+Requires-Dist: sphinx-copybutton; extra == 'docs'
+Requires-Dist: sphinx-design; extra == 'docs'
+Requires-Dist: sphinx>=7; extra == 'docs'
+Description-Content-Type: text/markdown
+
+# asp_plot
+
+[![PyPI](https://img.shields.io/pypi/v/asp-plot.svg)](https://pypi.org/project/asp-plot/)
+[![conda-forge](https://img.shields.io/conda/vn/conda-forge/asp-plot.svg)](https://anaconda.org/conda-forge/asp-plot)
+[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.14263121.svg)](https://doi.org/10.5281/zenodo.14263121)
+[![Documentation](https://readthedocs.org/projects/asp-plot/badge/?version=latest)](https://asp-plot.readthedocs.io/en/latest/)
+
+A Python package for visualizing output from the [NASA Ames Stereo Pipeline (ASP)](https://github.com/NeoGeographyToolkit/StereoPipeline). Generates diagnostic plots and comprehensive PDF reports for ASP stereo processing results, similar to reports from commercial SfM software like Agisoft Metashape.
+
+### **[View some example reports](https://asp-plot.readthedocs.io/en/latest/examples/reports.html)**
+
+### **[Full documentation at asp-plot.readthedocs.io](https://asp-plot.readthedocs.io)**
+
+## Installation
+
+```
+conda install -c conda-forge asp-plot
+```
+
+Or with pip:
+
+```
+pip install asp-plot
+```
+
+See the [installation guide](https://asp-plot.readthedocs.io/en/latest/installation.html) for more options.
+
+## Quick start
+
+Generate a PDF report from an ASP processing directory:
+
+```
+asp_plot --directory ./ --stereo_directory stereo
+```
+
+See the [CLI documentation](https://asp-plot.readthedocs.io/en/latest/cli/index.html) for all options and additional tools (`stereo_geom`, `csm_camera_plot`).
+
+## Examples
+
+- [Example reports](https://asp-plot.readthedocs.io/en/latest/examples/reports.html) — PDF reports for WorldView, ASTER, LRO NAC, and Mars sensors
+- [Example notebooks](https://asp-plot.readthedocs.io/en/latest/examples/index.html) — Modular usage by sensor type
+
+## Contributing
+
+See the [contributing guide](https://asp-plot.readthedocs.io/en/latest/contributing.html) for development setup, testing, and release process.

asp_plot-1.9.0/README.md

@@ -0,0 +1,45 @@
+# asp_plot
+
+[![PyPI](https://img.shields.io/pypi/v/asp-plot.svg)](https://pypi.org/project/asp-plot/)
+[![conda-forge](https://img.shields.io/conda/vn/conda-forge/asp-plot.svg)](https://anaconda.org/conda-forge/asp-plot)
+[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.14263121.svg)](https://doi.org/10.5281/zenodo.14263121)
+[![Documentation](https://readthedocs.org/projects/asp-plot/badge/?version=latest)](https://asp-plot.readthedocs.io/en/latest/)
+
+A Python package for visualizing output from the [NASA Ames Stereo Pipeline (ASP)](https://github.com/NeoGeographyToolkit/StereoPipeline). Generates diagnostic plots and comprehensive PDF reports for ASP stereo processing results, similar to reports from commercial SfM software like Agisoft Metashape.
+
+### **[View some example reports](https://asp-plot.readthedocs.io/en/latest/examples/reports.html)**
+
+### **[Full documentation at asp-plot.readthedocs.io](https://asp-plot.readthedocs.io)**
+
+## Installation
+
+```
+conda install -c conda-forge asp-plot
+```
+
+Or with pip:
+
+```
+pip install asp-plot
+```
+
+See the [installation guide](https://asp-plot.readthedocs.io/en/latest/installation.html) for more options.
+
+## Quick start
+
+Generate a PDF report from an ASP processing directory:
+
+```
+asp_plot --directory ./ --stereo_directory stereo
+```
+
+See the [CLI documentation](https://asp-plot.readthedocs.io/en/latest/cli/index.html) for all options and additional tools (`stereo_geom`, `csm_camera_plot`).
+
+## Examples
+
+- [Example reports](https://asp-plot.readthedocs.io/en/latest/examples/reports.html) — PDF reports for WorldView, ASTER, LRO NAC, and Mars sensors
+- [Example notebooks](https://asp-plot.readthedocs.io/en/latest/examples/index.html) — Modular usage by sensor type
+
+## Contributing
+
+See the [contributing guide](https://asp-plot.readthedocs.io/en/latest/contributing.html) for development setup, testing, and release process.