From 23be8dd86263cd1a8b86705d6d5316a77fc17944 Mon Sep 17 00:00:00 2001 From: hjkristenson Date: Fri, 17 Apr 2026 14:24:33 -0800 Subject: [PATCH 01/10] add reference to the multiburst notebook in burst_insar_product_guide.md --- CHANGELOG.md | 5 +++++ docs/guides/burst_insar_product_guide.md | 5 +++++ 2 files changed, 10 insertions(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index e079cf5ec..c41028b37 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -7,6 +7,11 @@ and this project adheres to [PEP 440](https://www.python.org/dev/peps/pep-0440/) and uses [Semantic Versioning](https://semver.org/spec/v2.0.0.html). +## [0.13.3] + +### Changed +* Included link to the multi-burst SBAS stack tutorial notebook in the Sentinel-1 Burst InSAR Product Guide + ## [0.13.2] ### Added diff --git a/docs/guides/burst_insar_product_guide.md b/docs/guides/burst_insar_product_guide.md index e6ac34bf1..078499216 100644 --- a/docs/guides/burst_insar_product_guide.md +++ b/docs/guides/burst_insar_product_guide.md @@ -60,6 +60,11 @@ This job type supports pairings of 1 to 15 contiguous along-track bursts (refer section for details). The number of bursts processed impacts the number of credits consumed. Refer to the [Credit Cost Table](../using/credits.md#credit-cost-table "Credit Cost Table" ){target=_blank} for more details. +Refer to the +[Search and Order a Multi-Burst SBAS Stack of Interferograms](https://github.com/ASFHyP3/hyp3-docs/blob/main/docs/tutorials/multiburst_sbas.ipynb "Search and Order a Multi-Burst SBAS Stack of Interferograms with the HyP3 SDK Tutorial" ){target=_blank} +Jupyter Notebook Tutorial to learn how to use the HyP3 Python SDK to search for sets of Sentinel-1 bursts and build +an SBAS stack of multi-burst pairings to submit for On Demand processing. + ## Sentinel-1 Bursts [Single Look Complex](https://sentiwiki.copernicus.eu/web/s1-processing#S1-Processing-Single-Look-Complex "https://sentiwiki.copernicus.eu/web/s1-processing#S1-Processing-Single-Look-Complex" ){target=_blank} From 90464103a9d62bf65cb0ceb26f5b94b3277bfb5d Mon Sep 17 00:00:00 2001 From: hjkristenson Date: Fri, 17 Apr 2026 14:58:52 -0800 Subject: [PATCH 02/10] add links and adjust formatting of multi-burst SBAS notebook --- docs/tutorials/multiburst_sbas.ipynb | 35 +++++++++++++++++----------- 1 file changed, 22 insertions(+), 13 deletions(-) diff --git a/docs/tutorials/multiburst_sbas.ipynb b/docs/tutorials/multiburst_sbas.ipynb index 38c126da5..c8d40ca35 100644 --- a/docs/tutorials/multiburst_sbas.ipynb +++ b/docs/tutorials/multiburst_sbas.ipynb @@ -2,8 +2,6 @@ "cells": [ { "cell_type": "markdown", - "id": "308bc6c7", - "metadata": {}, "source": [ "# Search and Order a Multi-Burst SBAS Stack of Interferograms\n", "\n", @@ -11,8 +9,10 @@ "\n", "## Define a list of S1-burst geographic reference scenes for the SBAS searches\n", "\n", + "We suggest using a Geographic Search in ASF's Data Search [Vertex](https://hyp3-docs.asf.alaska.edu/guides/burst_insar_product_guide/#vertex) interface to identify a collection of reference bursts.\n", + "\n", "- The collection must not contain more than 15 bursts\n", - "- The bursts must be contiguous\n", + "- The bursts must be contiguous and from the same orbit pass\n", "- There can be no holes in the collection of bursts\n", "- They cannot intersect the antimeridian\n", "- Bursts must be in the VV polarization\n", @@ -23,18 +23,21 @@ "\n", " ### This L-shaped collection of bursts is invalid:\n", "\n", - " ![invalid L-shaped burst collection](assets/invalid_multiburst_collection.png)\n", + " \"invalid\n", "\n", " ### This rectangular collection of bursts is valid:\n", " \n", - " ![valid rectangular burst collection](assets/valid_multiburst_collection.png)\n" - ] + " \"valid\n", + " \n", + "Refer to the [Burst InSAR Product Guide](https://hyp3-docs.asf.alaska.edu/guides/burst_insar_product_guide/#considerations-for-selecting-input-bursts) for more guidance on selecting valid sets of Sentinel-1 bursts for multi-burst InSAR.\n" + ], + "metadata": { + "collapsed": false + }, + "id": "3db459589babc7d" }, { "cell_type": "code", - "execution_count": null, - "id": "a3d4a640", - "metadata": {}, "outputs": [], "source": [ "from datetime import datetime\n", @@ -56,15 +59,21 @@ " \"S1_071049_IW3_20210104T002648_VV_4542-BURST\",\n", " \"S1_071049_IW1_20210104T002646_VV_4542-BURST\"\n", "]" - ] + ], + "metadata": { + "collapsed": false + }, + "id": "570978629cbd6a7d" }, { "cell_type": "markdown", - "id": "cfb7659f-33e5-47e2-8a78-8128e6887e79", - "metadata": {}, "source": [ "## Define a HyP3 project name and other parameters of the multiburst SBAS stack" - ] + ], + "metadata": { + "collapsed": false + }, + "id": "6785145a02ae47f9" }, { "cell_type": "code", From d6e2777cbd8c5e4d59b3276ebc49a3fecd51b54e Mon Sep 17 00:00:00 2001 From: hjkristenson Date: Fri, 17 Apr 2026 15:03:12 -0800 Subject: [PATCH 03/10] update changelog --- CHANGELOG.md | 1 + 1 file changed, 1 insertion(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index c41028b37..096c98749 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -11,6 +11,7 @@ and uses [Semantic Versioning](https://semver.org/spec/v2.0.0.html). ### Changed * Included link to the multi-burst SBAS stack tutorial notebook in the Sentinel-1 Burst InSAR Product Guide +* Included links to product guide content in the multi-burst SBAS stack tutorial notebook ## [0.13.2] From 04ed4dd42f6c01ae55cbac13266e118549b5ef08 Mon Sep 17 00:00:00 2001 From: hjkristenson Date: Fri, 17 Apr 2026 15:36:37 -0800 Subject: [PATCH 04/10] remove spaces from markdown --- docs/tutorials/multiburst_sbas.ipynb | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/tutorials/multiburst_sbas.ipynb b/docs/tutorials/multiburst_sbas.ipynb index c8d40ca35..e2d96c90d 100644 --- a/docs/tutorials/multiburst_sbas.ipynb +++ b/docs/tutorials/multiburst_sbas.ipynb @@ -21,13 +21,13 @@ " - Aim to build rectangular collections of bursts\n", " - L-shaped and T-shaped burst collections will likely fail to process\n", "\n", - " ### This L-shaped collection of bursts is invalid:\n", + "### This L-shaped collection of bursts is invalid:\n", "\n", - " \"invalid\n", + "\"invalid\n", "\n", - " ### This rectangular collection of bursts is valid:\n", + "### This rectangular collection of bursts is valid:\n", " \n", - " \"valid\n", + "\"valid\n", " \n", "Refer to the [Burst InSAR Product Guide](https://hyp3-docs.asf.alaska.edu/guides/burst_insar_product_guide/#considerations-for-selecting-input-bursts) for more guidance on selecting valid sets of Sentinel-1 bursts for multi-burst InSAR.\n" ], From 2286fc73067ad0d6e8f6b77da1003fcee2295952 Mon Sep 17 00:00:00 2001 From: Heidi Kristenson <61886203+hjkristenson@users.noreply.github.com> Date: Fri, 17 Apr 2026 15:48:18 -0800 Subject: [PATCH 05/10] revert change to cell metadata --- docs/tutorials/multiburst_sbas.ipynb | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/tutorials/multiburst_sbas.ipynb b/docs/tutorials/multiburst_sbas.ipynb index e2d96c90d..be7ee6c03 100644 --- a/docs/tutorials/multiburst_sbas.ipynb +++ b/docs/tutorials/multiburst_sbas.ipynb @@ -2,6 +2,8 @@ "cells": [ { "cell_type": "markdown", + "id": "308bc6c7", + "metadata": {}, "source": [ "# Search and Order a Multi-Burst SBAS Stack of Interferograms\n", "\n", From 8abaf26bebafd7c2f69aee8f5e3ea7a52751a3e4 Mon Sep 17 00:00:00 2001 From: Heidi Kristenson <61886203+hjkristenson@users.noreply.github.com> Date: Fri, 17 Apr 2026 15:48:29 -0800 Subject: [PATCH 06/10] revert change to cell metadata --- docs/tutorials/multiburst_sbas.ipynb | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/tutorials/multiburst_sbas.ipynb b/docs/tutorials/multiburst_sbas.ipynb index be7ee6c03..c8aee84b5 100644 --- a/docs/tutorials/multiburst_sbas.ipynb +++ b/docs/tutorials/multiburst_sbas.ipynb @@ -69,6 +69,8 @@ }, { "cell_type": "markdown", + "id": "cfb7659f-33e5-47e2-8a78-8128e6887e79", + "metadata": {}, "source": [ "## Define a HyP3 project name and other parameters of the multiburst SBAS stack" ], From e105ad79e3d914d9c28d260291cfeb4ddecf8eab Mon Sep 17 00:00:00 2001 From: Heidi Kristenson <61886203+hjkristenson@users.noreply.github.com> Date: Fri, 17 Apr 2026 15:48:51 -0800 Subject: [PATCH 07/10] revert change to cell metadata --- docs/tutorials/multiburst_sbas.ipynb | 3 +++ 1 file changed, 3 insertions(+) diff --git a/docs/tutorials/multiburst_sbas.ipynb b/docs/tutorials/multiburst_sbas.ipynb index c8aee84b5..1108e801b 100644 --- a/docs/tutorials/multiburst_sbas.ipynb +++ b/docs/tutorials/multiburst_sbas.ipynb @@ -40,6 +40,9 @@ }, { "cell_type": "code", + "execution_count": null, + "id": "a3d4a640", + "metadata": {}, "outputs": [], "source": [ "from datetime import datetime\n", From 6ea356ea61c47c9b90d26e5ed31ad08729bb1af4 Mon Sep 17 00:00:00 2001 From: Heidi Kristenson <61886203+hjkristenson@users.noreply.github.com> Date: Fri, 17 Apr 2026 15:55:25 -0800 Subject: [PATCH 08/10] remove extra cell metadata --- docs/tutorials/multiburst_sbas.ipynb | 6 +----- 1 file changed, 1 insertion(+), 5 deletions(-) diff --git a/docs/tutorials/multiburst_sbas.ipynb b/docs/tutorials/multiburst_sbas.ipynb index 1108e801b..f17dd430b 100644 --- a/docs/tutorials/multiburst_sbas.ipynb +++ b/docs/tutorials/multiburst_sbas.ipynb @@ -64,11 +64,7 @@ " \"S1_071049_IW3_20210104T002648_VV_4542-BURST\",\n", " \"S1_071049_IW1_20210104T002646_VV_4542-BURST\"\n", "]" - ], - "metadata": { - "collapsed": false - }, - "id": "570978629cbd6a7d" + ] }, { "cell_type": "markdown", From 6fce2b83f67bbfb2f64da49ed8da6bd20afb20d4 Mon Sep 17 00:00:00 2001 From: Heidi Kristenson <61886203+hjkristenson@users.noreply.github.com> Date: Fri, 17 Apr 2026 15:56:01 -0800 Subject: [PATCH 09/10] remove extra cell metadata --- docs/tutorials/multiburst_sbas.ipynb | 6 +----- 1 file changed, 1 insertion(+), 5 deletions(-) diff --git a/docs/tutorials/multiburst_sbas.ipynb b/docs/tutorials/multiburst_sbas.ipynb index f17dd430b..12122fc6e 100644 --- a/docs/tutorials/multiburst_sbas.ipynb +++ b/docs/tutorials/multiburst_sbas.ipynb @@ -72,11 +72,7 @@ "metadata": {}, "source": [ "## Define a HyP3 project name and other parameters of the multiburst SBAS stack" - ], - "metadata": { - "collapsed": false - }, - "id": "6785145a02ae47f9" + ] }, { "cell_type": "code", From 19fb008153e5c6ed7d7eb3c74af6d86c92bb5c48 Mon Sep 17 00:00:00 2001 From: Heidi Kristenson <61886203+hjkristenson@users.noreply.github.com> Date: Fri, 17 Apr 2026 15:58:24 -0800 Subject: [PATCH 10/10] remove extra cell metadata --- docs/tutorials/multiburst_sbas.ipynb | 6 +----- 1 file changed, 1 insertion(+), 5 deletions(-) diff --git a/docs/tutorials/multiburst_sbas.ipynb b/docs/tutorials/multiburst_sbas.ipynb index 12122fc6e..039e9059a 100644 --- a/docs/tutorials/multiburst_sbas.ipynb +++ b/docs/tutorials/multiburst_sbas.ipynb @@ -32,11 +32,7 @@ "\"valid\n", " \n", "Refer to the [Burst InSAR Product Guide](https://hyp3-docs.asf.alaska.edu/guides/burst_insar_product_guide/#considerations-for-selecting-input-bursts) for more guidance on selecting valid sets of Sentinel-1 bursts for multi-burst InSAR.\n" - ], - "metadata": { - "collapsed": false - }, - "id": "3db459589babc7d" + ] }, { "cell_type": "code",