Skip to content

Add Atlanta and UCSD stereo pair scene-selection notebook and examples#116

Merged
bpurinton merged 22 commits intomainfrom
ucsd-example-2
Apr 21, 2026
Merged

Add Atlanta and UCSD stereo pair scene-selection notebook and examples#116
bpurinton merged 22 commits intomainfrom
ucsd-example-2

Conversation

@bpurinton
Copy link
Copy Markdown
Contributor

Some of these convergence angles are really large 38° for Atlanta and 33° for UCSD.  That’s not ideal for urban, that’s more ideal for flat open areas.  Urban should look much better in the ~15-20° range.  Not sure if Claude wrote this?  The “ideal” pair geometry is something we can discuss later.  As you’ve suggested, a few different examples would be good.  Really MVS is the best option.

bpurinton added a commit that referenced this pull request Apr 15, 2026
…ion notebook

The three processing notebooks (14deg_6d, 18deg_13d, 21deg_12d) run the
full ASP pipeline — bundle_adjust → mapproject → parallel_stereo →
point2dem → geodiff — on the same 3 x 3 km ROI for each pair chosen by
the scene-selection notebook. Each generates a unique
WorldView_UCSD_<tag>-asp-plot-report.pdf.

Scene-selection notebook updated to stand alone: removed the pair
exclusion (595 pairs, not 594) and dropped historical framing.

Refs PR #116.
@bpurinton bpurinton changed the title Add UCSD stereo pair scene-selection notebook and examples Add Atlanta and UCSD stereo pair scene-selection notebook and examples Apr 15, 2026
bpurinton added a commit that referenced this pull request Apr 15, 2026
Scans all 27 WV2 CATIDs in the SpaceNet AOI_6_Atlanta metadata bucket
(each catid has ~3 PAN tiles; we union tile polygons for per-catid
footprints and use the first tile's XML for geometry). Enumerates 351
candidate pairs and ranks them under a 10-20 degree convergence target
tailored to the urban-dominated Atlanta airport ROI. All scenes are
from a single 2009-12-22 pass, so temporal/solar deltas are zero and
selection reduces to convergence + overlap + BIE/asymmetry.

Top candidates: 12-18 degree convergence, BIE > 81, asymm < 3.2 —
substantially better urban-scene geometry than the existing ~38 degree
pair.

Refs PR #116.
bpurinton added a commit that referenced this pull request Apr 15, 2026
The original notebook was tuned for a large shared workstation
(--threads 24, --processes 24-48). On a typical laptop (8 physical
cores, 16 GB RAM) asp_mgm + subpixel-mode 9 runs out of memory at
those settings.

- bundle_adjust: --threads 24 -> 8
- mapproject:    --processes 48 --threads 24 -> --processes 4 --threads 2
- parallel_stereo: --processes 24 -> --processes 2 --threads 4

Refs PR #116.
bpurinton added a commit that referenced this pull request Apr 15, 2026
Processed pair 1040010004B41D00 x 10400100047BBB00 (14.14 deg conv,
6-day dt) on the 3 x 3 km UCSD ROI. Full ASP pipeline + asp_plot 1.12.1
report generation.

Refs PR #116.
bpurinton added a commit that referenced this pull request Apr 15, 2026
Processed pair 104001000365CA00 x 104001000496A100 (17.52 deg conv,
13-day dt) on the 3 x 3 km UCSD ROI. Full ASP pipeline + asp_plot 1.12.1
report generation.

Refs PR #116.
bpurinton added a commit that referenced this pull request Apr 15, 2026
Processed pair 1040010007A93700 x 1040010007CA4D00 (21.21 deg conv,
12-day dt) on the 3 x 3 km UCSD ROI. Full ASP pipeline + asp_plot 1.12.1
report generation.

Completes the trio of re-selected UCSD WV3 stereo examples
(14deg_6d, 18deg_13d, 21deg_12d) that span the 15-25 degree
convergence target for UCSD's mixed urban + natural terrain.

Refs PR #116.
bpurinton added a commit that referenced this pull request Apr 17, 2026
Matches the UCSD scene selection target range. Top candidates shift
from 12-18 deg (under old 10-20 target) to 16-18 deg (all still in
the sweet spot, now with consistent scoring across both sites).

Refs PR #116.
bpurinton added a commit that referenced this pull request Apr 17, 2026
Three Atlanta WV2 stereo pair notebooks (16deg_0d, 18deg_0d, 22deg_0d)
spanning 16-22 deg convergence on the Atlanta airport ROI.

16deg_0d is fully executed: wv_correct + bundle_adjust + mapproject +
parallel_stereo + point2dem 1.9m + geodiff + asp_plot 1.12.1 report.
18deg_0d and 22deg_0d are scaffolded (outputs cleared) pending review
of the first pair's results.

Refs PR #116.
bpurinton added a commit that referenced this pull request Apr 17, 2026
Processed pair 1030010003993E00 P001 x 1030010003CAF100 P002
(18.07 deg conv) on the Atlanta airport ROI.

Refs PR #116.
bpurinton added a commit that referenced this pull request Apr 17, 2026
Processed pair 1030010002B7D800 P002 x 1030010003CAF100 P002
(21.77 deg conv) on the Atlanta airport ROI.

Completes the trio of Atlanta WV2 stereo examples (16deg_0d,
18deg_0d, 22deg_0d) spanning 16-22 degree convergence on a
same-pass MVS dataset.

Refs PR #116.
Re-scans all 35 SpaceNet CORE3D UCSD WV3 scenes, computes geometry for
all 595 candidate pairs via StereopairMetadataParser, filters for ROI
containment, and ranks under a scoring scheme that targets a 15-25°
convergence band for the mixed urban + natural UCSD terrain. Selects
three candidate pairs (14°, 18°, 21°) for the follow-up processing
notebooks. Addresses reviewer feedback that the original ~36° pair
is too wide for an urban/mixed scene.

Temporary metadata downloads are kept in /tmp and cleaned up at the
end of the notebook.
…ion notebook

The three processing notebooks (14deg_6d, 18deg_13d, 21deg_12d) run the
full ASP pipeline — bundle_adjust → mapproject → parallel_stereo →
point2dem → geodiff — on the same 3 x 3 km ROI for each pair chosen by
the scene-selection notebook. Each generates a unique
WorldView_UCSD_<tag>-asp-plot-report.pdf.

Scene-selection notebook updated to stand alone: removed the pair
exclusion (595 pairs, not 594) and dropped historical framing.

Refs PR #116.
Scans all 27 WV2 CATIDs in the SpaceNet AOI_6_Atlanta metadata bucket
(each catid has ~3 PAN tiles; we union tile polygons for per-catid
footprints and use the first tile's XML for geometry). Enumerates 351
candidate pairs and ranks them under a 10-20 degree convergence target
tailored to the urban-dominated Atlanta airport ROI. All scenes are
from a single 2009-12-22 pass, so temporal/solar deltas are zero and
selection reduces to convergence + overlap + BIE/asymmetry.

Top candidates: 12-18 degree convergence, BIE > 81, asymm < 3.2 —
substantially better urban-scene geometry than the existing ~38 degree
pair.

Refs PR #116.
The original notebook was tuned for a large shared workstation
(--threads 24, --processes 24-48). On a typical laptop (8 physical
cores, 16 GB RAM) asp_mgm + subpixel-mode 9 runs out of memory at
those settings.

- bundle_adjust: --threads 24 -> 8
- mapproject:    --processes 48 --threads 24 -> --processes 4 --threads 2
- parallel_stereo: --processes 24 -> --processes 2 --threads 4

Refs PR #116.
Processed pair 1040010004B41D00 x 10400100047BBB00 (14.14 deg conv,
6-day dt) on the 3 x 3 km UCSD ROI. Full ASP pipeline + asp_plot 1.12.1
report generation.

Refs PR #116.
Processed pair 104001000365CA00 x 104001000496A100 (17.52 deg conv,
13-day dt) on the 3 x 3 km UCSD ROI. Full ASP pipeline + asp_plot 1.12.1
report generation.

Refs PR #116.
Processed pair 1040010007A93700 x 1040010007CA4D00 (21.21 deg conv,
12-day dt) on the 3 x 3 km UCSD ROI. Full ASP pipeline + asp_plot 1.12.1
report generation.

Completes the trio of re-selected UCSD WV3 stereo examples
(14deg_6d, 18deg_13d, 21deg_12d) that span the 15-25 degree
convergence target for UCSD's mixed urban + natural terrain.

Refs PR #116.
Matches the UCSD scene selection target range. Top candidates shift
from 12-18 deg (under old 10-20 target) to 16-18 deg (all still in
the sweet spot, now with consistent scoring across both sites).

Refs PR #116.
All 27 WV2 CATIDs are from the same 2009-12-22 orbit pass, so temporal
separation and solar deltas are zero for every pair. Drop dt_days,
delta_sun_el, delta_sun_az from scoring. Change scatter plot y-axis
from temporal separation (all zeros) to minimum intersection overlap %.
Three Atlanta WV2 stereo pair notebooks (16deg_0d, 18deg_0d, 22deg_0d)
spanning 16-22 deg convergence on the Atlanta airport ROI.

16deg_0d is fully executed: wv_correct + bundle_adjust + mapproject +
parallel_stereo + point2dem 1.9m + geodiff + asp_plot 1.12.1 report.
18deg_0d and 22deg_0d are scaffolded (outputs cleared) pending review
of the first pair's results.

Refs PR #116.
Processed pair 1030010003993E00 P001 x 1030010003CAF100 P002
(18.07 deg conv) on the Atlanta airport ROI.

Refs PR #116.
Processed pair 1030010002B7D800 P002 x 1030010003CAF100 P002
(21.77 deg conv) on the Atlanta airport ROI.

Completes the trio of Atlanta WV2 stereo examples (16deg_0d,
18deg_0d, 22deg_0d) spanning 16-22 degree convergence on a
same-pass MVS dataset.

Refs PR #116.
Replaces the old alignment_report() workflow with align_and_evaluate(),
adds the three aligned-DEM comparison plots (histogram_by_landcover,
plot_atl06sr_dem_profile, plot_best_worst_segments) that match the new
pc_align section of the PDF report.
Keep only the 21deg_12d UCSD pair and 22deg_0d Atlanta pair as the
canonical notebook+report for each site (suffix-free filenames).
Document all four attempted pairs per site (baseline + 3 candidates)
in a new 'Processing outcomes' section at the end of each scene-
selection notebook with hardcoded DEM-vs-ICESat-2 comparison stats
and selection rationale.

Removes 6 variant notebooks and 6 variant PDF reports.
Removes the pre-existing baseline pair from the DEM-vs-ICESat-2 comparison
tables and rationale in the UCSD/Atlanta scene-selection notebooks, and
updates the canonical processing notebooks to reference 'three attempted
pairs' instead of four. Also includes user edit clarifying |T| in the
translation-magnitude column description.
…-notebook links

Inter-notebook and PDF-report links in the four WorldView notebooks now
use fully-qualified https://asp-plot.readthedocs.io/en/latest/... URLs
so they resolve both on RTD and in raw notebook previews. Also cleans up
stale references to deleted variant notebooks in the UCSD scene-selection
cells (intro bullet list and 'Processing notebooks' list).
@bpurinton bpurinton merged commit 71d21f6 into main Apr 21, 2026
1 check passed
@bpurinton bpurinton deleted the ucsd-example-2 branch April 21, 2026 19:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant