Upgrade to ASP 3.7.0 (#13)

Bump pinned ASP 3.6.0 (2025-12-26) → 3.7.0 (2026-06-08) across the
Dockerfile, devcontainer fallback args, build-image workflow, and
install docs.

Adapt the tutorials to 3.7.0 CLI changes:
- Drop --aster-use-csm (removed in 3.7.0; CSM is now the ASTER default).
- Pass the mapprojection reference DEM to parallel_stereo via --dem
  instead of as the trailing positional argument (notebooks 01/02/03).
  mapproject still takes the DEM positionally, so it is unchanged.

Fix the stale docs/start/installation.md path in asp-version-check.yml
(the file lives at docs/reference/installation.md), which had silently
no-op'd the docs portion of the auto-bump.

Author: bpurinton

.devcontainer/Dockerfile

@@ -12,8 +12,8 @@
 
 FROM mcr.microsoft.com/devcontainers/miniconda:1-3
 
-ARG ASP_VERSION=3.6.0
-ARG ASP_BUILD_DATE=2025-12-26
+ARG ASP_VERSION=3.7.0
+ARG ASP_BUILD_DATE=2026-06-08
 ARG ASP_TARBALL=StereoPipeline-${ASP_VERSION}-${ASP_BUILD_DATE}-x86_64-Linux.tar.bz2
 ARG ASP_URL=https://github.com/NeoGeographyToolkit/StereoPipeline/releases/download/${ASP_VERSION}/${ASP_TARBALL}
 

.devcontainer/devcontainer.json

@@ -19,8 +19,8 @@
   //   "dockerfile": "Dockerfile",
   //   "context": "..",
   //   "args": {
-  //     "ASP_VERSION": "3.6.0",
-  //     "ASP_BUILD_DATE": "2025-12-26"
+  //     "ASP_VERSION": "3.7.0",
+  //     "ASP_BUILD_DATE": "2026-06-08"
   //   }
   // },
 

.github/workflows/asp-version-check.yml

@@ -137,9 +137,9 @@ jobs:
           # 4. Install docs — the local-install snippet has a literal
           # ASP_VERSION=... / ASP_BUILD_DATE=... block, plus a "verify"
           # comment showing the version string.
-          sed -i -E "s|^(ASP_VERSION=)${OLD_V}|\1${NEW_V}|"    docs/start/installation.md
-          sed -i -E "s|^(ASP_BUILD_DATE=)${OLD_D}|\1${NEW_D}|" docs/start/installation.md
-          sed -i -E "s|(parallel_stereo \(Ames Stereo Pipeline\) )${OLD_V}|\1${NEW_V}|" docs/start/installation.md
+          sed -i -E "s|^(ASP_VERSION=)${OLD_V}|\1${NEW_V}|"    docs/reference/installation.md
+          sed -i -E "s|^(ASP_BUILD_DATE=)${OLD_D}|\1${NEW_D}|" docs/reference/installation.md
+          sed -i -E "s|(parallel_stereo \(Ames Stereo Pipeline\) )${OLD_V}|\1${NEW_V}|" docs/reference/installation.md
 
           # Show what changed for the workflow log.
           git diff --stat
@@ -166,7 +166,7 @@ jobs:
             - `.devcontainer/Dockerfile` — `ARG ASP_VERSION` / `ARG ASP_BUILD_DATE`
             - `.devcontainer/devcontainer.json` — fallback build-args (commented block)
             - `.github/workflows/build-image.yml` — workflow_dispatch defaults
-            - `docs/start/installation.md` — local-install snippet + verify line
+            - `docs/reference/installation.md` — local-install snippet + verify line
 
             ### Before merging — quick checklist
             - [ ] Read the [ASP release notes](https://github.com/NeoGeographyToolkit/StereoPipeline/releases/tag/${{ steps.asp.outputs.version }}) for breaking changes that might affect the tutorial notebooks (CLI flag renames, new sensor-prep paths, output-file renames).

.github/workflows/build-image.yml

@@ -30,13 +30,13 @@ on:
   workflow_dispatch:
     inputs:
       asp_version:
-        description: 'ASP version (e.g. 3.6.0)'
+        description: 'ASP version (e.g. 3.7.0)'
         required: false
-        default: '3.6.0'
+        default: '3.7.0'
       asp_build_date:
         description: 'ASP release build date (YYYY-MM-DD as it appears in the tarball filename)'
         required: false
-        default: '2025-12-26'
+        default: '2026-06-08'
   schedule:
     # Monthly rebuild so security updates from the base image flow through
     # even when our Dockerfile/environment.yml are unchanged.
@@ -73,8 +73,8 @@ jobs:
       - name: Resolve ASP build args
         id: asp
         run: |
-          echo "version=${{ github.event.inputs.asp_version || '3.6.0' }}" >> "$GITHUB_OUTPUT"
-          echo "date=${{ github.event.inputs.asp_build_date || '2025-12-26' }}" >> "$GITHUB_OUTPUT"
+          echo "version=${{ github.event.inputs.asp_version || '3.7.0' }}" >> "$GITHUB_OUTPUT"
+          echo "date=${{ github.event.inputs.asp_build_date || '2026-06-08' }}" >> "$GITHUB_OUTPUT"
 
       - name: Compute image tags
         id: meta

docs/reference/installation.md

@@ -14,8 +14,8 @@ Download the latest release tarball from the [ASP releases page](https://github.
 
 ```bash
 # Example for Linux x86_64; pick the right tarball for your platform.
-ASP_VERSION=3.6.0
-ASP_BUILD_DATE=2025-12-26
+ASP_VERSION=3.7.0
+ASP_BUILD_DATE=2026-06-08
 curl -fL -o asp.tar.bz2 \
   https://github.com/NeoGeographyToolkit/StereoPipeline/releases/download/${ASP_VERSION}/StereoPipeline-${ASP_VERSION}-${ASP_BUILD_DATE}-x86_64-Linux.tar.bz2
 
@@ -31,7 +31,7 @@ Verify:
 
 ```bash
 parallel_stereo --version
-# parallel_stereo (Ames Stereo Pipeline) 3.6.0
+# parallel_stereo (Ames Stereo Pipeline) 3.7.0
 ```
 
 ## Step 2 — Install `asp-plot`

notebooks/01_aster_rainier.ipynb

@@ -103,7 +103,6 @@
     "- `-t aster` selects the ASTER session (knows about ASTER cameras).\n",
     "- `--stereo-algorithm asp_bm`: plain block matching, fast.\n",
     "- `--subpixel-mode 1`: parabolic subpixel refinement, cheaper than Bayes-EM.\n",
-    "- `--aster-use-csm` uses the Community Sensor Model camera.\n",
     "- `--processes 4 --threads-multiprocess 1` matches the 4-core Codespace floor. On a larger machine, bump `--processes` to your core count.\n"
    ]
   },
@@ -121,7 +120,6 @@
     "    !parallel_stereo -t aster \\\n",
     "        --stereo-algorithm asp_bm \\\n",
     "        --subpixel-mode 1 \\\n",
-    "        --aster-use-csm \\\n",
     "        --processes 4 --threads-multiprocess 1 \\\n",
     "        {DATA}/out-Band3N.tif {DATA}/out-Band3B.tif \\\n",
     "        {DATA}/out-Band3N.xml {DATA}/out-Band3B.xml \\\n",
@@ -238,25 +236,24 @@
     "if Path(f\"{DATA}/stereo_ortho/run-DEM.tif\").exists():\n",
     "    print(f\"{DATA}/stereo_ortho/run-DEM.tif exists — skipping mapprojected pass. Delete {DATA}/stereo_ortho/ to reprocess.\")\n",
     "else:\n",
-    "    !mapproject --t_srs {T_SRS} --tr 15 --aster-use-csm \\\n",
+    "    !mapproject --t_srs {T_SRS} --tr 15 \\\n",
     "        {REF_DEM} \\\n",
     "        {DATA}/out-Band3N.tif {DATA}/out-Band3N.xml \\\n",
     "        {DATA}/out-Band3N_ortho.tif\n",
     "\n",
-    "    !mapproject --t_srs {T_SRS} --tr 15 --aster-use-csm \\\n",
+    "    !mapproject --t_srs {T_SRS} --tr 15 \\\n",
     "        {REF_DEM} \\\n",
     "        {DATA}/out-Band3B.tif {DATA}/out-Band3B.xml \\\n",
     "        {DATA}/out-Band3B_ortho.tif\n",
     "\n",
     "    !parallel_stereo -t aster \\\n",
     "        --stereo-algorithm asp_mgm \\\n",
     "        --subpixel-mode 9 \\\n",
-    "        --aster-use-csm \\\n",
+    "        --dem {REF_DEM} \\\n",
     "        --processes 1 --threads-multiprocess 4 \\\n",
     "        {DATA}/out-Band3N_ortho.tif {DATA}/out-Band3B_ortho.tif \\\n",
     "        {DATA}/out-Band3N.xml {DATA}/out-Band3B.xml \\\n",
-    "        {DATA}/stereo_ortho/run \\\n",
-    "        {REF_DEM}\n",
+    "        {DATA}/stereo_ortho/run\n",
     "\n",
     "    !point2dem --tr 30 -r earth --auto-proj-center --errorimage {DATA}/stereo_ortho/run-PC.tif\n",
     "\n",

notebooks/02_worldview_ucsd.ipynb

@@ -181,7 +181,7 @@
    "source": [
     "## 5. Stereo + DEM\n",
     "\n",
-    "Stereo on the orthorectified pair. The inputs are now nearly aligned in geographic space, so the matcher's search range is small. Pass the reference DEM as the final argument so the matcher knows the grid.\n",
+    "Stereo on the orthorectified pair. The inputs are now nearly aligned in geographic space, so the matcher's search range is small. Pass the reference DEM via `--dem` so the matcher knows the grid.\n",
     "\n",
     "`point2dem` grids the point cloud at 4 m, roughly 4× the image GSD, a common rule of thumb for stereo DEM resolution.\n",
     "\n",
@@ -205,12 +205,12 @@
     "        --threads-singleprocess 4 \\\n",
     "        --stereo-algorithm asp_mgm \\\n",
     "        --subpixel-mode 9 \\\n",
+    "        --dem {REF_DEM} \\\n",
     "        {DATA}/1040010007A93700_P001_ortho.tif \\\n",
     "        {DATA}/1040010007CA4D00_P001_ortho.tif \\\n",
     "        {DATA}/1040010007A93700_P001.xml \\\n",
     "        {DATA}/1040010007CA4D00_P001.xml \\\n",
-    "        {DATA}/stereo/run \\\n",
-    "        {REF_DEM}\n",
+    "        {DATA}/stereo/run\n",
     "\n",
     "    !point2dem --tr 4.0 -r earth --errorimage {DATA}/stereo/run-PC.tif\n",
     "\n",

notebooks/03_worldview_ucsd_ba.ipynb

@@ -239,7 +239,7 @@
    "source": [
     "## 6. Stereo + DEM\n",
     "\n",
-    "Stereo on the orthorectified pair. The inputs are now nearly aligned in geographic space, so the matcher's search range is small. Pass the reference DEM as the final argument so the matcher knows the grid.\n",
+    "Stereo on the orthorectified pair. The inputs are now nearly aligned in geographic space, so the matcher's search range is small. Pass the reference DEM via `--dem` so the matcher knows the grid.\n",
     "\n",
     "`point2dem` grids the point cloud at 4 m, roughly 4× the image GSD, a common rule of thumb for stereo DEM resolution.\n",
     "\n",
@@ -264,12 +264,12 @@
     "        --stereo-algorithm asp_mgm \\\n",
     "        --subpixel-mode 9 \\\n",
     "        --bundle-adjust-prefix {DATA}/ba/run \\\n",
+    "        --dem {REF_DEM} \\\n",
     "        {DATA}/1040010007A93700_P001_ortho_ba.tif \\\n",
     "        {DATA}/1040010007CA4D00_P001_ortho_ba.tif \\\n",
     "        {DATA}/1040010007A93700_P001.xml \\\n",
     "        {DATA}/1040010007CA4D00_P001.xml \\\n",
-    "        {DATA}/stereo_ba/run \\\n",
-    "        {REF_DEM}\n",
+    "        {DATA}/stereo_ba/run\n",
     "\n",
     "    !point2dem --tr 4.0 -r earth --errorimage {DATA}/stereo_ba/run-PC.tif\n",
     "\n",