asp-plot 3.5.0__tar.gz → 3.6.0__tar.gz

{asp_plot-3.5.0 → asp_plot-3.6.0}/ARCHITECTURE.md

@@ -247,6 +247,7 @@ All CLI tools are in `asp_plot/cli/` and use Click for argument parsing:
 - `--no-altimetry`: Skip the altimetry comparisons plotted by default. Auto-detects planetary body from DEM CRS: Earth → ICESat-2 (requires internet), Moon → LOLA, Mars → MOLA. For planetary DEMs, requires `--altimetry-csv`.
 - `--altimetry-csv`: Path to a LOLA/MOLA CSV from the ODE GDS API. **Mars: must be the `*_pts_csv.csv` (not `*_topo_csv.csv`) — the loader requires the `PLANET_RAD` column to avoid the oblate-areoid offset.** Moon accepts either the `*_topo_simple_csv.csv` (results=u) or the `*_pts_csv.csv` (results=p). Obtained via the `request_planetary_altimetry` CLI tool.
 - `--no-pc-align`: Skips the `pc_align` step; by default (when altimetry is on) the report runs `pc_align` against the reference altimetry (ICESat-2 for Earth, MOLA for Mars, LOLA for Moon) after the existing altimetry plots and appends an alignment report. **Earth success path**: adds four pages (alignment report page, pre/post landcover histogram, aligned profile, aligned best/worst segments). **Planetary success path**: adds three pages (alignment report page, pre/post mapview, pre/post histogram). `insufficient_points` and `no_improvement` outcomes emit a single alignment report page on either branch. Skipped automatically when `--no-altimetry` is set.
+- `--pc-align-min-points`: Fewest altimetry points on the DEM for the `pc_align` step to run (`ReportConfig.pc_align_min_points`); `None`, the default, keeps the alignment methods' own minimums (500 ICESat-2 points, 20 LOLA/MOLA points). Below the minimum the alignment page says the step was skipped.
 - `--no-geometry`: Skip the stereo geometry plots drawn by default (used for planetary missions)
 - `--subset-km`: Hillshade subset size in km (default: 1.0)
 - `--atl06sr-time-range`: Time range for ICESat-2 ATL06-SR requests. `"all"` (default) for full mission, `"auto"` for scene metadata ±1 year, `"START,END"` for a custom range, or a single date (buffered by ±1 year).

{asp_plot-3.5.0 → asp_plot-3.6.0}/CHANGELOG.md

@@ -7,6 +7,15 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [3.6.0] - 2026-10-30
+
+In this release:
+
+- `asp_report --pc-align-min-points` sets how many altimetry points the `pc_align` step needs before it runs, so small DEMs that ICESat-2 crosses only a few times can still be aligned.
+
+### Added
+- **`asp_report --pc-align-min-points N` sets how many altimetry points the `pc_align` step needs before it runs** (`ReportConfig.pc_align_min_points`). The step skipped itself below a fixed 500 ICESat-2 points (20 for LOLA/MOLA), so a report on a DEM of about 1 km², which ICESat-2 crosses only a few times, compared against the points but never aligned to them. The default is unchanged.
+
 ## [3.5.0] - 2026-10-23
 
 In this release:

{asp_plot-3.5.0 → asp_plot-3.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: asp_plot
-Version: 3.5.0
+Version: 3.6.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

{asp_plot-3.5.0 → asp_plot-3.6.0}/asp_plot/cli/asp_report.py

@@ -92,6 +92,12 @@ def _reconstruct_command():
     default=False,
     help="Skip the pc_align step (run by default against the reference altimetry -- ICESat-2 for Earth, MOLA for Mars, LOLA for Moon -- appending the alignment-report pages; skipped automatically with --no-altimetry).",
 )
+@click.option(
+    "--pc-align-min-points",
+    type=int,
+    default=None,
+    help="Fewest altimetry points on the DEM for the pc_align step to run; below it the alignment page says the step was skipped. Default: 500 for ICESat-2, 20 for LOLA/MOLA.",
+)
 @click.option(
     "--no-geometry",
     is_flag=True,
@@ -155,6 +161,7 @@ def main(
     no_altimetry,
     altimetry_csv,
     no_pc_align,
+    pc_align_min_points,
     no_geometry,
     subset_km,
     atl06sr_time_range,
@@ -183,6 +190,7 @@ def main(
         plot_altimetry=not no_altimetry,
         altimetry_csv=altimetry_csv,
         pc_align=not no_pc_align,
+        pc_align_min_points=pc_align_min_points,
         plot_geometry=not no_geometry,
         subset_km=subset_km,
         atl06sr_time_range=atl06sr_time_range,

{asp_plot-3.5.0 → asp_plot-3.6.0}/asp_plot/report_pipeline.py

@@ -75,6 +75,9 @@ class ReportConfig:
     plot_altimetry: bool = True
     altimetry_csv: Optional[str] = None
     pc_align: bool = True
+    # Fewest altimetry points on the DEM for pc_align to run. None keeps the
+    # alignment methods' own defaults: 500 for ICESat-2, 20 for LOLA/MOLA.
+    pc_align_min_points: Optional[int] = None
     plot_geometry: bool = True
     subset_km: float = 1.0
     atl06sr_time_range: str = "all"
@@ -628,10 +631,10 @@ def _build_altimetry_earth(ctx: ReportContext, ctx_kwargs_altimetry: dict):
 
     # ---- pc_align + ICESat-2 alignment report (Earth only) ----
     if cfg.pc_align:
-        align_result = icesat.align_and_evaluate(
-            processing_level="all",
-            improvement_threshold_pct=5.0,
-        )
+        align_kwargs = {"processing_level": "all", "improvement_threshold_pct": 5.0}
+        if cfg.pc_align_min_points is not None:
+            align_kwargs["minimum_points"] = cfg.pc_align_min_points
+        align_result = icesat.align_and_evaluate(**align_kwargs)
         stats_row = _stats_row_from_result(align_result)
 
         align_title = "DEM Alignment with ICESat-2"
@@ -777,7 +780,10 @@ def _build_altimetry_planetary(ctx: ReportContext, body: str):
 
     # ---- pc_align + planetary alignment report (Moon/Mars) ----
     if cfg.pc_align:
-        align_result = alt.align_and_evaluate_planetary()
+        align_kwargs = {}
+        if cfg.pc_align_min_points is not None:
+            align_kwargs["minimum_points"] = cfg.pc_align_min_points
+        align_result = alt.align_and_evaluate_planetary(**align_kwargs)
         stats_row = _stats_row_from_result(align_result)
 
         align_title = f"DEM Alignment with {instrument}"

{asp_plot-3.5.0 → asp_plot-3.6.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "asp_plot"
-version = "3.5.0"
+version = "3.6.0"
 license = {text = "BSD-3-Clause"}
 authors = [
   { name="Ben Purinton", email="purinton@uw.edu" },