asp-plot 1.18.0__tar.gz → 1.18.1__tar.gz

{asp_plot-1.18.0 → asp_plot-1.18.1}/AGENTS.md

@@ -110,8 +110,8 @@ The package is organized by functionality, with each module focused on a specifi
 - Coordinate utilities: `get_utm_epsg()` for determining UTM EPSG from lon/lat, `get_planetary_bounds()` for DEM bounds in planetocentric 0-360 lon/lat
 - Planetary body detection: `detect_planetary_body(dem_fn)` returns `"earth"`, `"moon"`, or `"mars"` by inspecting CRS WKT DATUM/ELLIPSOID fields
 - Subprocess utilities: `run_subprocess_command()`
-- Vantor/copyright utilities:
-  - `detect_vantor_satellite(directory)`: Checks XML files for WorldView SATIDs (WV01/WV02/WV03)
+- Vantor/copyright utilities (an **attribution** concern — named for the rights-holder — kept deliberately distinct from sensor/reader **identity**, the WorldView-named abstraction in `sensors.py`; #137):
+  - `detect_vantor_satellite(directory)`: True when an XML camera file's `SATID` matches `VANTOR_SATID_PREFIXES` — any DigitalGlobe→Maxar→Vantor-owned satellite, i.e. the WorldView family (`WV*`, incl. Legion `WVLG`), GeoEye (`GE*`), QuickBird (`QB*`), IKONOS (`IK*`) — not just WorldView. Gates the `© Vantor` overlay via `Plotter.is_vantor`
   - `add_copyright_overlay(ax)`: Adds "© Vantor {year}" text overlay to bottom-right of matplotlib axes
 - Scene metadata: `get_acquisition_dates(directory, extra_dirs=None)` reads `FIRSTLINETIME` from WorldView/Maxar XMLs and parses the capture timestamp from `AST_L1A_...` file/directory names. Returns a sorted, deduplicated list of `"YYYY-MM-DD HH:MM:SS UTC"` strings; empty if nothing is found. Used by the CLI to populate `ReportMetadata.acquisition_dates`.
 

{asp_plot-1.18.0 → asp_plot-1.18.1}/CHANGELOG.md

@@ -5,6 +5,11 @@ 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.18.1] - 2026-06-26
+
+### Fixed
+- **`© Vantor` attribution now covers all Vantor-owned satellites, not just WorldView** ([#137](https://github.com/uw-cryo/asp_plot/issues/137)). The copyright-overlay check (`detect_vantor_satellite`) matched only `SATID` values starting with `WV`, so GeoEye-1 (`GE01`), QuickBird (`QB02`), and IKONOS scenes — all owned by the same rights-holder (DigitalGlobe → Maxar → Vantor) — were silently left un-attributed. Detection now matches a `VANTOR_SATID_PREFIXES` whitelist (`WV` incl. WorldView Legion `WVLG`, `GE`, `QB`, `IK`). This clarifies that `is_vantor` / `detect_vantor_satellite` are an **attribution** concern (named for the company), intentionally distinct from sensor/reader **identity** (the WorldView-named abstraction in `sensors.py`); the two names are documented as deliberately different so they aren't reconciled into one.
+
 ## [1.18.0] - 2026-06-25
 
 ### Added

{asp_plot-1.18.0 → asp_plot-1.18.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: asp_plot
-Version: 1.18.0
+Version: 1.18.1
 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-1.18.0 → asp_plot-1.18.1}/asp_plot/scenes.py

@@ -26,7 +26,8 @@ class SceneFiles:
     full_stereo_directory : str
         Full path to the stereo directory.
     is_vantor : bool
-        Whether the source imagery is from a Vantor (WorldView) satellite.
+        Whether the source imagery is from a Vantor-owned satellite (WorldView
+        family, GeoEye, QuickBird, etc.); gates the "© Vantor" copyright overlay.
     left_scene_sub_fn, right_scene_sub_fn : str or None
         Paths to the left/right sub-sampled scene files.
     """

{asp_plot-1.18.0 → asp_plot-1.18.1}/asp_plot/sensors.py

@@ -106,6 +106,12 @@ class WorldViewMetadata(SensorMetadata):
     extract per-scene metadata, handling both single XML files and multiple XML
     tiles per scene (mosaicked with ``dg_mosaic``).
 
+    This class is named for the *sensor family* (the stable WorldView name) and
+    governs which reader parses the XML. It is intentionally distinct from the
+    *attribution* check :func:`asp_plot.utils.detect_vantor_satellite`, which is
+    named for the rights-holder (Vantor) and decides whether the "© Vantor"
+    overlay applies. The two concerns use different names on purpose; see #137.
+
     Attributes
     ----------
     directory : str

{asp_plot-1.18.0 → asp_plot-1.18.1}/asp_plot/stereo.py

@@ -39,7 +39,8 @@ class StereoFiles:
     full_directory : str
         Full path to the stereo directory.
     is_vantor : bool
-        Whether the source imagery is from a Vantor (WorldView) satellite.
+        Whether the source imagery is from a Vantor-owned satellite (WorldView
+        family, GeoEye, QuickBird, etc.); gates the "© Vantor" copyright overlay.
     reference_dem : str or None
         Path to the reference DEM (supplied or recovered from the stereo log).
     left_image_fn, left_image_sub_fn, right_image_sub_fn : str or None

{asp_plot-1.18.0 → asp_plot-1.18.1}/asp_plot/utils.py

@@ -1101,9 +1101,10 @@ class Plotter:
         title : str, optional
             Plot title, default is None
         is_vantor : bool, optional
-            Whether the source imagery is from a Vantor (WorldView) satellite.
-            When True, ``plot_array`` adds a copyright overlay for panels that
-            request it via ``copyright=True``. Default is False.
+            Whether the source imagery is from a Vantor-owned satellite (the
+            WorldView family, GeoEye, QuickBird, etc.). When True, ``plot_array``
+            adds a "© Vantor" copyright overlay for panels that request it via
+            ``copyright=True``. Default is False.
         """
         self.clim_perc = clim_perc
         self.lognorm = lognorm
@@ -1196,8 +1197,8 @@ class Plotter:
             Whether to add a satellite-imagery copyright overlay, default is
             False. The overlay is only drawn when this is True *and* the Plotter
             was created with ``is_vantor=True`` (i.e. the source imagery is from
-            a Vantor/WorldView satellite). Set on the panels that display the
-            optical scenes.
+            a Vantor-owned satellite). Set on the panels that display the optical
+            scenes.
 
         Returns
         -------
@@ -1297,8 +1298,26 @@ class Plotter:
             ctx.add_basemap(ax=ax, **ctx_kwargs)
 
 
+# SATID prefixes for the DigitalGlobe -> Maxar -> Vantor satellite heritage, all
+# of which carry "© Vantor" attribution. Covers the WorldView family ("WV", incl.
+# WorldView Legion "WVLG"), GeoEye ("GE"), QuickBird ("QB"), and IKONOS ("IK").
+VANTOR_SATID_PREFIXES = ("WV", "GE", "QB", "IK")
+
+
 def detect_vantor_satellite(directory):
-    """Check if XML files in directory indicate a Vantor (WorldView) satellite.
+    """Check if XML files in directory indicate a Vantor-owned satellite.
+
+    This is an *attribution* check, distinct from sensor/reader identity: it
+    decides whether the "© Vantor" copyright overlay applies (see
+    :func:`add_copyright_overlay` and :class:`Plotter`). It is named for the
+    rights-holder (Vantor, formerly Maxar/DigitalGlobe) and matches *any* Vantor
+    satellite, not just WorldView. Sensor *identity* — which reader parses the
+    XML — is a separate concern handled by the WorldView-named abstraction in
+    :mod:`asp_plot.sensors`; the two names intentionally differ and should not be
+    "reconciled" into one.
+
+    A scene is considered Vantor-owned when an XML camera file carries a SATID
+    matching one of :data:`VANTOR_SATID_PREFIXES`.
 
     Parameters
     ----------
@@ -1308,7 +1327,8 @@ def detect_vantor_satellite(directory):
     Returns
     -------
     bool
-        True if any XML file contains a WorldView SATID (WV01, WV02, WV03, etc.).
+        True if any XML file contains a Vantor-heritage SATID (e.g. WV01-WV04,
+        WVLG, GE01, QB02).
     """
     try:
         xml_files = glob_file(directory, "*.[Xx][Mm][Ll]", all_files=True)
@@ -1320,7 +1340,7 @@ def detect_vantor_satellite(directory):
     for xml_file in xml_files:
         try:
             satid = get_xml_tag(xml_file, "SATID")
-            if satid.startswith("WV"):
+            if satid.startswith(VANTOR_SATID_PREFIXES):
                 return True
         except (ValueError, Exception):
             continue

{asp_plot-1.18.0 → asp_plot-1.18.1}/pyproject.toml

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