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

{asp_plot-1.8.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.8.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/
@@ -138,3 +141,4 @@ 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.8.0 → asp_plot-1.9.0}/CHANGELOG.md

@@ -5,6 +5,32 @@ 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

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.

{asp_plot-1.8.0 → asp_plot-1.9.0}/asp_plot/altimetry.py

@@ -1042,7 +1042,7 @@ class Altimetry:
         atl06sr = self.atl06sr_processing_levels_filtered[key]
         atl06sr_sorted = atl06sr.sort_values(by=column_name).to_crs(map_crs)
 
-        fig, ax = plt.subplots(1, 1, figsize=figsize)
+        fig, ax = plt.subplots(1, 1, figsize=figsize, dpi=220)
 
         if plot_dem:
             ctx_kwargs = {}
@@ -1319,7 +1319,7 @@ class Altimetry:
                 print("\nAligned DEM not found.\n")
                 return
 
-        fig, ax = plt.subplots(1, 1, figsize=(6, 4))
+        fig, ax = plt.subplots(1, 1, figsize=(6, 4), dpi=220)
 
         for column_name in column_names:
             med = atl06sr[column_name].quantile(0.50)
@@ -1471,7 +1471,7 @@ class Altimetry:
                             f"{cs['name']}: n={cs['n']}, Med={cs['med']:+.2f}, NMAD={cs['nmad']:.2f}"
                         )
 
-        fig, ax = plt.subplots(1, 1, figsize=(8, 5))
+        fig, ax = plt.subplots(1, 1, figsize=(8, 5), dpi=220)
 
         xmin = dh.quantile(0.01)
         xmax = dh.quantile(0.99)

{asp_plot-1.8.0 → asp_plot-1.9.0}/asp_plot/cli/asp_plot.py

@@ -117,6 +117,17 @@ def main(
     ICESat-2 comparisons, and more. All plots are combined into a single PDF report
     with processing parameters and summary information.
     """
+    # Reconstruct the asp_plot command for recording in the report
+    import shlex
+
+    click_ctx = click.get_current_context()
+    cmd_parts = ["asp_plot"]
+    for param in click_ctx.command.params:
+        val = click_ctx.params.get(param.name)
+        if val is not None and val != param.default:
+            cmd_parts.append(f"--{param.name} {shlex.quote(str(val))}")
+    report_command = " ".join(cmd_parts)
+
     print(f"\nProcessing ASP files in {directory}\n")
 
     plots_directory = os.path.join(directory, "tmp_asp_report_plots/")
@@ -205,7 +216,7 @@ def main(
         ReportSection(
             title="Input Scenes",
             image_path=os.path.join(plots_directory, fig_fn),
-            caption="Left and right input scenes used for stereo processing.",
+            caption="Left and right input scenes used for stereo processing. Non-mapprojected scenes are shown after ASP's alignment step (e.g., affineepipolar), which rotates images to create horizontal epipolar lines for correlation. Mapprojected scenes require no pre-alignment and are displayed in their map-projected orientation.",
         )
     )
 
@@ -364,7 +375,7 @@ def main(
         ReportSection(
             title="Detailed Hillshade",
             image_path=os.path.join(plots_directory, fig_fn),
-            caption=f"DEM hillshade with {subset_km} km detail subset in second row. If available, corresponding mapprojected ortho image subsets are displayed in the bottom row.",
+            caption="DEM hillshade. If the intersection error is available, zoomed subsets selected from low, medium, and high (left to right) uncertainty areas are displayed in the second row. If the mapprojected image is available, corresponding ortho image subsets are displayed in the bottom row.",
         )
     )
 
@@ -463,6 +474,7 @@ def main(
         report_pdf_path,
         report_title=report_title,
         report_metadata=report_metadata,
+        report_command=report_command,
     )
 
     shutil.rmtree(plots_directory)

{asp_plot-1.8.0 → asp_plot-1.9.0}/asp_plot/report.py

@@ -4,6 +4,7 @@ import textwrap
 from dataclasses import dataclass
 
 from fpdf import FPDF
+from PIL import Image
 
 logger = logging.getLogger(__name__)
 
@@ -95,6 +96,7 @@ def compile_report(
     report_pdf_path,
     report_title="ASP Output Quality Report",
     report_metadata=None,
+    report_command=None,
 ):
     """
     Compile a PDF report with ASP processing results and plots.
@@ -115,6 +117,8 @@ def compile_report(
         Title for the report. Default is "ASP Output Quality Report".
     report_metadata : ReportMetadata, optional
         DEM metadata for the title page summary table. Default is None.
+    report_command : str, optional
+        The asp_plot CLI command used to generate this report. Default is None.
 
     Returns
     -------
@@ -191,7 +195,31 @@ def compile_report(
         pdf.ln(2)
 
         usable_width = pdf.w - pdf.l_margin - pdf.r_margin
-        pdf.image(section.image_path, x=pdf.l_margin, w=usable_width)
+        # Reserve space for caption below the image and bottom margin.
+        # Caption font is 9pt with ~80 chars/line at usable_width; 5mm per line + spacing.
+        if section.caption:
+            caption_text = f"Figure {section.figure_number}: {section.caption}"
+            estimated_lines = max(1, -(-len(caption_text) // 80))  # ceil division
+            caption_reserve = estimated_lines * 5 + 8
+        else:
+            caption_reserve = 0
+        usable_height = pdf.h - pdf.get_y() - pdf.b_margin - caption_reserve
+
+        # Determine image dimensions that fit within usable area
+        with Image.open(section.image_path) as img:
+            img_w, img_h = img.size
+        aspect = img_h / img_w
+        render_w = usable_width
+        render_h = render_w * aspect
+        if render_h > usable_height:
+            render_h = usable_height
+            render_w = render_h / aspect
+
+        pdf.image(
+            section.image_path,
+            x=pdf.l_margin + (usable_width - render_w) / 2,
+            w=render_w,
+        )
 
         if section.caption:
             pdf.ln(3)
@@ -229,6 +257,14 @@ def compile_report(
             pdf.multi_cell(0, 4, wrapped)
             pdf.ln(4)
 
+    if report_command:
+        pdf.set_font("Helvetica", "B", 10)
+        pdf.cell(0, 7, "Report Generation Command:", new_x="LMARGIN", new_y="NEXT")
+        pdf.set_font("Courier", "", 7)
+        wrapped = textwrap.fill(report_command, width=120)
+        pdf.multi_cell(0, 4, wrapped)
+        pdf.ln(4)
+
     pdf.output(report_pdf_path)
 
 

{asp_plot-1.8.0 → asp_plot-1.9.0}/asp_plot/stereo.py

@@ -126,6 +126,8 @@ class StereoPlotter(Plotter):
         self.orthos = False if Raster(self.left_image_fn).transform is None else True
         self.left_image_sub_fn = glob_file(self.full_directory, "*-L_sub.tif")
         self.right_image_sub_fn = glob_file(self.full_directory, "*-R_sub.tif")
+        self.align_left_fn = glob_file(self.full_directory, "*-align-L.txt")
+        self.align_right_fn = glob_file(self.full_directory, "*-align-R.txt")
 
         # There may be multiple match files if stereo was run with --num-matches-from-disparity.
         # In that case, filter out the match file with `-disp-` in filename.
@@ -270,7 +272,11 @@ class StereoPlotter(Plotter):
         Plot match points between the left and right images.
 
         Creates a figure with two subplots showing the left and right
-        orthoimages (if they are map-projected) with match points overlaid.
+        subsampled images with match points overlaid as small red circles.
+        For mapprojected scenes, match points are rescaled using the GSD ratio.
+        For non-mapprojected scenes, match points are transformed from original
+        to aligned coordinate space using the alignment matrices, then rescaled
+        to the subsampled image dimensions.
 
         Parameters
         ----------
@@ -283,12 +289,6 @@ class StereoPlotter(Plotter):
         -------
         None
             Displays the plot and optionally saves it
-
-        Notes
-        -----
-        If the images are not map-projected, only the match points are shown,
-        not the underlying images. The match points are displayed as small red
-        circles on both images.
         """
         match_point_df = self.get_match_point_df()
 
@@ -299,31 +299,54 @@ class StereoPlotter(Plotter):
             and self.right_image_sub_fn
             and match_point_df is not None
         ):
-            # If the images are not mapprojected, we only show the distribution of match points
-            # and not the underlying images, which are rotated and difficult to plot.
-            # We can revisit plotting the non-mapprojected images later, but it is challenging,
-            # and likely not worthwhile, as the distribution of match points is what we are interested in.
             if self.orthos:
                 full_gsd = Raster(self.left_image_fn).get_gsd()
                 sub_gsd = Raster(self.left_image_sub_fn).get_gsd()
                 rescale_factor = sub_gsd / full_gsd
-                left_image = Raster(self.left_image_sub_fn).read_array()
-                right_image = Raster(self.right_image_sub_fn).read_array()
+                left_x = match_point_df["x1"] / rescale_factor
+                left_y = match_point_df["y1"] / rescale_factor
+                right_x = match_point_df["x2"] / rescale_factor
+                right_y = match_point_df["y2"] / rescale_factor
             else:
-                # These are small hacks to make the match point plot work if the images are not
-                # mapprojected and thus not being shown.
-                rescale_factor = 1
-                left_image = np.zeros((1, 1))
-                right_image = np.zeros((1, 1))
+                if not self.align_left_fn or not self.align_right_fn:
+                    raise FileNotFoundError(
+                        "Alignment matrix files (run-align-{L,R}.txt) not found. "
+                        "These are required to overlay match points on non-mapprojected images."
+                    )
+
+                full_width = Raster(self.left_image_fn).ds.width
+                sub_width = Raster(self.left_image_sub_fn).ds.width
+                rescale_factor = full_width / sub_width
+
+                # Transform match points from original to aligned coordinate space
+                align_L = np.loadtxt(self.align_left_fn)
+                align_R = np.loadtxt(self.align_right_fn)
+
+                n = len(match_point_df)
+                ones = np.ones(n)
+
+                left_pts = np.vstack([match_point_df["x1"], match_point_df["y1"], ones])
+                left_aligned = align_L @ left_pts
+                left_x = left_aligned[0] / rescale_factor
+                left_y = left_aligned[1] / rescale_factor
+
+                right_pts = np.vstack(
+                    [match_point_df["x2"], match_point_df["y2"], ones]
+                )
+                right_aligned = align_R @ right_pts
+                right_x = right_aligned[0] / rescale_factor
+                right_y = right_aligned[1] / rescale_factor
 
+            left_image = Raster(self.left_image_sub_fn).read_array()
+            right_image = Raster(self.right_image_sub_fn).read_array()
             self.plot_array(ax=axa[0], array=left_image, cmap="gray", add_cbar=False)
-            axa[0].set_title(f"Left (n={match_point_df.shape[0]})")
             self.plot_array(ax=axa[1], array=right_image, cmap="gray", add_cbar=False)
-            axa[1].set_title("Right (scenes shown only if mapprojected)")
+            axa[0].set_title(f"Left (n={match_point_df.shape[0]})")
+            axa[1].set_title("Right")
 
             axa[0].scatter(
-                match_point_df["x1"] / rescale_factor,
-                match_point_df["y1"] / rescale_factor,
+                left_x,
+                left_y,
                 color="r",
                 marker="o",
                 facecolor="none",
@@ -332,8 +355,8 @@ class StereoPlotter(Plotter):
             axa[0].set_aspect("equal")
 
             axa[1].scatter(
-                match_point_df["x2"] / rescale_factor,
-                match_point_df["y2"] / rescale_factor,
+                right_x,
+                right_y,
                 color="r",
                 marker="o",
                 facecolor="none",
@@ -418,7 +441,6 @@ class StereoPlotter(Plotter):
 
         if self.disparity_sub_fn and self.disparity_fn:
             raster = Raster(self.disparity_sub_fn)
-            sub_gsd = raster.get_gsd()
             dx = raster.read_array(b=1)
             dy = raster.read_array(b=2)
 
@@ -428,14 +450,24 @@ class StereoPlotter(Plotter):
             dx.mask = combined_mask
             dy.mask = combined_mask
 
-            full_gsd = Raster(self.disparity_fn).get_gsd()
-            rescale_factor = sub_gsd / full_gsd
-            dx = dx * rescale_factor
-            dy = dy * rescale_factor
+            # Rescale disparity from subsampled to full-res pixel coordinates.
+            # Only meaningful for georeferenced (mapprojected) data where the
+            # GSD ratio reflects the actual downsampling factor. For non-georeferenced
+            # data the transform is identity/near-zero, so skip rescaling.
+            if not self.orthos and unit == "meters":
+                logger.warning(
+                    "Disparity unit 'meters' not supported for non-mapprojected scenes; using pixels."
+                )
+            if self.orthos:
+                sub_gsd = raster.get_gsd()
+                full_gsd = Raster(self.disparity_fn).get_gsd()
+                rescale_factor = sub_gsd / full_gsd
+                dx = dx * rescale_factor
+                dy = dy * rescale_factor
 
-            if unit == "meters":
-                dx = dx * full_gsd
-                dy = dy * full_gsd
+                if unit == "meters":
+                    dx = dx * full_gsd
+                    dy = dy * full_gsd
 
             if remove_bias:
                 dx_offset = np.ma.median(dx)
@@ -465,7 +497,10 @@ class StereoPlotter(Plotter):
                 dy_q = dy[::stride, ::stride]
                 axa[2].quiver(ix, iy, dx_q, dy_q, color="white")
 
-            scalebar = ScaleBar(sub_gsd)
+            if self.orthos:
+                scalebar = ScaleBar(raster.get_gsd())
+            else:
+                scalebar = ScaleBar(1, units="px", dimension="pixel-length")
             axa[0].add_artist(scalebar)
             axa[0].set_title("x offset")
             axa[1].set_title("y offset")

{asp_plot-1.8.0 → asp_plot-1.9.0}/asp_plot/utils.py

@@ -92,7 +92,7 @@ def show_existing_figure(filename):
         print(f"Figure not found: {filename}")
 
 
-def save_figure(fig, save_dir=None, fig_fn=None, dpi=150):
+def save_figure(fig, save_dir=None, fig_fn=None, dpi=None):
     """
     Save a matplotlib figure to a file.
 
@@ -107,8 +107,9 @@ def save_figure(fig, save_dir=None, fig_fn=None, dpi=150):
         Directory to save the figure in
     fig_fn : str, optional
         Filename for the saved figure
-    dpi : int, optional
-        Resolution in dots per inch, default is 150
+    dpi : int or None, optional
+        Resolution in dots per inch. Default is None, which uses the
+        figure's own DPI setting.
 
     Returns
     -------

asp_plot-1.9.0/environment.yml

@@ -0,0 +1,13 @@
+name: asp_plot
+channels:
+  - conda-forge
+dependencies:
+  - python>=3.11
+  - gdal
+  - rasterio
+  - rioxarray
+  - fiona
+  - geopandas
+  - pip
+  - pip:
+    - -e ".[dev,docs]"

{asp_plot-1.8.0 → asp_plot-1.9.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "asp_plot"
-version = "1.8.0"
+version = "1.9.0"
 license = {text = "BSD-3-Clause"}
 authors = [
   { name="Ben Purinton", email="purinton@uw.edu" },
@@ -43,8 +43,24 @@ asp_plot = "asp_plot.cli.asp_plot:main"
 csm_camera_plot = "asp_plot.cli.csm_camera_plot:main"
 stereo_geom = "asp_plot.cli.stereo_geom:main"
 
+[project.optional-dependencies]
+dev = [
+    "pytest",
+    "pre-commit",
+]
+docs = [
+    "sphinx>=7",
+    "myst-nb",
+    "sphinx-autoapi",
+    "sphinx-design",
+    "sphinx-copybutton",
+    "sphinx-book-theme",
+    "sphinx-autobuild",
+]
+
 [project.urls]
 Homepage = "https://github.com/uw-cryo/asp_plot"
+Documentation = "https://asp-plot.readthedocs.io"
 Issues = "https://github.com/uw-cryo/asp_plot/issues"
 
 [tool.hatch.build.targets.sdist]
@@ -53,4 +69,6 @@ exclude = [
   "notebooks/",
   "original_code/",
   "scratch/",
+  "reports/",
+  "docs/",
 ]