Release v0.10.2

CHANGELOG.md

@@ -6,6 +6,14 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 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.10.2]
+
+### Added
+* Added examples for burst and multi-burst InSAR to [API Documentation](docs/using/api.md)
+
+### Changed
+* Updated [Products](docs/products.md) page to include burst-based InSAR
+
 ## [0.10.1]
 
 ### Changed

docs/products.md

@@ -1,52 +1,74 @@
 # Available HyP3 Products
 
-On-demand SAR products generated using HyP3 are currently available for the [Sentinel-1 mission](sentinel1.md "Sentinel-1 Mission" ){target=_blank} only.
+On-demand SAR products generated using HyP3 are currently available for the [Sentinel-1 mission](sentinel1.md "Sentinel-1 Mission" ){target=_blank} only. Unless otherwise noted, 
+on-demand products are available for 14 days after they have been processed.
+
+A Digital Elevation Model (DEM) is required to generate each of the On-Demand products offered by ASF, and we generally use the [GLO-30 Copernicus DEM](https://dataspace.copernicus.eu/explore-data/data-collections/copernicus-contributing-missions/collections-description/COP-DEM "Copernicus DEM" ){target=_blank} in our processing workflows. 
+For more information, refer to our [Digital Elevation Models](dems.md "HyP3 DEM Documentation" ){target=_blank} documentation.
 
 ## RTC
 
 SAR datasets inherently contain geometric and radiometric distortions due to terrain
-being imaged by a side-looking instrument. Radiometric Terrain Correction (RTC) removes
+being imaged by a side-looking instrument. Radiometric Terrain Correction (RTC) removes 
 these distortions and creates analysis-ready data suitable for use in GIS applications.
 RTC processing is a required first step for many amplitude-based SAR applications.
 
-Sentinel-1 RTC products are generated leveraging GAMMA Software. Products are distributed as
-UTM-projected GeoTIFFs with a pixel spacing of
-[10, 20, or 30 meters](guides/rtc_product_guide.md#pixel-spacing "RTC Pixel Spacing Documentation" ){target=_blank}.
-To learn more, refer to our [ASF Sentinel-1 RTC Product Guide](guides/rtc_product_guide.md 
-"ASF Sentinel-1 RTC Product Guide" ){target=_blank}.
-
-For step-by-step instructions for searching for, ordering, downloading and using On Demand RTC products, visit our [RTC On Demand!](https://storymaps.arcgis.com/stories/2ead3222d2294d1fae1d11d3f98d7c35 "RTC On Demand! StoryMap" ){target=_blank} tutorial.
+Sentinel-1 RTC products are generated leveraging [GAMMA Software](https://gamma-rs.ch/gamma-software){target=_blank}. Products are distributed as UTM-projected GeoTIFFs 
+with a pixel spacing of [10, 20, or 30 meters](guides/rtc_product_guide.md#pixel-spacing "RTC Pixel Spacing Documentation" ){target=_blank}. To learn more, refer to the [Sentinel-1 RTC Product Guide](guides/rtc_product_guide.md 
+"Sentinel-1 RTC Product Guide" ){target=_blank}.
 
-A Digital Elevation Model (DEM) is required for processing RTC. ASF uses the
-best publicly-available DEM with full coverage of the processing area. To learn more,
-refer to our [Digital Elevation Models](dems.md "HyP3 DEM Documentation" ){target=_blank} documentation.
+For step-by-step instructions on searching for, ordering, downloading and using On Demand RTC products, visit our [RTC On Demand!](https://storymaps.arcgis.com/stories/2ead3222d2294d1fae1d11d3f98d7c35 "RTC On Demand! StoryMap" ){target=_blank} tutorial.
 
 ## InSAR
 
-Interferometric SAR (InSAR) uses the phase differences from repeat passes over the
-same area to identify regions where the distance between the sensor and the Earth's
-surface has changed. This allows for the detection and quantification of deformation
-or movement. To learn more, refer to our [ASF Sentinel-1 InSAR Product Guide](guides/insar_product_guide.md "ASF Sentinel-1 InSAR Product Guide" ){target=_blank}.
+Interferometric SAR (InSAR) uses the phase differences from repeat passes over the 
+same area to identify regions where the distance between the sensor and the Earth's 
+surface has changed. This allows for the detection and quantification of surface 
+deformation or ground movement. 
+
+There are three different processing approaches available for generating On-Demand InSAR products from Sentinel-1: 
+
+  - Full-scene processing using GAMMA software 
+  - Burst-based processing using ISCE2 software
+  - ARIA Frame-based processing using ISCE2 software
+
+### Full-scene InSAR (GAMMA)
+
+These products take Sentinel-1 IW SLC scene pairs as input, and processing is performed 
+using [GAMMA Software](https://gamma-rs.ch/gamma-software){target=_blank}. Products are 
+packaged as a collection of GeoTIFFs in a zip file. They are projected to the appropriate 
+UTM Zone for the product location, and can be generated at a pixel spacing of either 80 or 40 meters. To learn more, refer to the [Sentinel-1 InSAR Product Guide](guides/insar_product_guide.md "Sentinel-1 InSAR Product Guide").
+
+For step-by-step instructions on searching for, ordering and downloading On Demand InSAR products, visit our [InSAR On Demand!](https://storymaps.arcgis.com/stories/68a8a3253900411185ae9eb6bb5283d3 "InSAR On Demand! StoryMap" ){target=_blank} tutorial.
+
+### Burst-based InSAR (ISCE2)
+
+These products take sets of individual [SLC bursts](https://storymaps.arcgis.com/stories/88c8fe67933340779eddef212d76b8b8 "Sentinel-1 Bursts StoryMap" ){target=_blank} 
+extracted from Sentinel-1 IW SLC products as input, and processing is performed using 
+[ISCE2 software](https://github.com/isce-framework/isce2#readme "https://github.com/isce-framework/isce2" ){target=_blank}. Products are packaged as a collection of 
+GeoTIFFs in a zip file. They are projected to the appropriate UTM Zone for the product 
+location, and can be generated at a pixel spacing of 80, 40, or 20 meters. 
+
+The advantage of using burst-based processing is that users have more control of the extent of the output interferogram, and the burst footprints always fully overlap from one acquisition to the next. Users can select sets of up to 15 contiguous along-track bursts to generate a single output interferogram. Refer to the [Sentinel-1 Burst InSAR Product Guide](guides/burst_insar_product_guide.md "Sentinel-1 Burst InSAR Product Guide") for more information.
+
+For step-by-step instructions on searching for, ordering and downloading On Demand Burst InSAR products, visit our [Burst-Based InSAR for Sentinel-1 On Demand](https://storymaps.arcgis.com/stories/191bf1b6962c402086807390b3ce63b0 "Burst-Based InSAR for Sentinel-1 On Demand StoryMap" ){target=_blank} tutorial.
+
+### ARIA Sentinel-1 GUNW Products (ISCE2)
 
-Use caution when generating interferograms for areas with extensive/dense vegetation cover.
-Because Sentinel-1 is a C-band sensor, the waves will not penetrate very deeply into vegetation.
-Imagery of densely vegetated areas likely represents the top of the canopy rather than the
-actual terrain. In addition, vegetated areas tend to have low coherence, because plants can grow
-or move from one acquisition to the next.
+There is an extensive archive of [ARIA S1 GUNW](https://aria.jpl.nasa.gov/products/standard-displacement-products.html "https://aria.jpl.nasa.gov" ){target=_blank} (Geocoded Unwrapped Interferogram) products [available from ASF](https://search.asf.alaska.edu/#/?maxResults=1000&dataset=SENTINEL-1%20INTERFEROGRAM%20(BETA) "Vertex search for ARIA S1 GUNW" ){target=_blank}, 
+but they are only generated in specific geographic locations. If the existing archive does 
+not provide the products you need, you can generate ARIA GUNW products on demand. 
 
-For step-by-step instructions for searching for, ordering and downloading On Demand InSAR products, visit our [InSAR On Demand!](https://storymaps.arcgis.com/stories/68a8a3253900411185ae9eb6bb5283d3 "InSAR On Demand! StoryMap" ){target=_blank} tutorial.
+ARIA S1 GUNW products are delivered as netCDF files with 90-m pixel spacing. The On-Demand 
+products are generated using the same [ISCE2](https://github.com/isce-framework/isce2#readme "https://github.com/isce-framework/isce2" ){target=_blank}-based code used to generate the archived products, and standard ARIA S1 GUNW products 
+generated on demand are automatically added to the archive. This allows all users to access the on-demand products indefinitely, which is an exception to the 14-day availability period that applies to all other on-demand products.
 
-A Digital Elevation Model (DEM) is required for processing InSAR. ASF uses the
-best publicly-available DEM with full coverage of the processing area. To learn more,
-refer to our [Digital Elevation Models](dems.md "HyP3 DEM Documentation" ){target=_blank} documentation.
+The ARIA S1 GUNW products use a set [framing system](guides/gunw_product_guide#aria-frame-ids "ARIA Sentinel-1 GUNW Product Guide: ARIA Frame IDs") to select consistent bursts from input Sentinel-1 IW SLCs to generate interferograms. Refer to the [ARIA Sentinel-1 GUNW Product Guide](guides/gunw_product_guide.md "ARIA Sentinel-1 GUNW Product Guide") for more information.
 
 ## autoRIFT
 
 [AutoRIFT](https://github.com/leiyangleon/autoRIFT "https://github.com/leiyangleon/autoRIFT" ){target=_blank} produces a velocity map from
 observed motion using a feature tracking algorithm developed as part of the 
-[NASA MEaSUREs ITS_LIVE](https://its-live.jpl.nasa.gov/ "https://its-live.jpl.nasa.gov" ){target=_blank} project. To learn more,
-visit the [ITS_LIVE project website](https://its-live.jpl.nasa.gov/ "https://its-live.jpl.nasa.gov" ){target=_blank}.
+[NASA MEaSUREs ITS_LIVE](https://its-live.jpl.nasa.gov/ "https://its-live.jpl.nasa.gov" ){target=_blank} project. 
 
-A Digital Elevation Model (DEM) is required for autoRIFT processing. ASF uses the
-best publicly-available DEM with full coverage of the processing area. To learn more,
-refer to our [Digital Elevation Models](dems.md "HyP3 DEM Documentation" ){target=_blank} documentation.
+To learn more, visit the [ITS_LIVE project website](https://its-live.jpl.nasa.gov/ "https://its-live.jpl.nasa.gov" ){target=_blank}.

docs/using/api.md

@@ -131,6 +131,41 @@ You can also submit InSAR jobs for scene pairs using [ESA granule IDs](https://s
 }
 ```
 
+## Submitting Sentinel-1 Burst InSAR jobs
+You can submit InSAR jobs using the `INSAR_ISCE_BURST` job type, which takes a single pair of [ESA granule burst IDs](https://sentiwiki.copernicus.eu/web/s1-products#S1Products-BurstIDMapsS1-Products-Burst-ID-Maps){target=_blank}, or use the `INSAR_ISCE_MULTI_BURST` job type, which accepts lists of up to 15 contiguous along-track burst IDs that will be merged together to produce reference and secondary files.
+```json
+{
+  "jobs": [
+    {
+      "job_type": "INSAR_ISCE_BURST",
+      "name": "single-burst-example",
+      "job_parameters": {
+        "granules": [
+          "S1_136231_IW2_20200604T022312_VV_7C85-BURST",
+          "S1_136231_IW2_20200616T022313_VV_5D11-BURST"
+        ]
+      }
+    },
+    {
+      "job_type": "INSAR_ISCE_MULTI_BURST",
+      "name": "multi-burst-example",
+      "job_parameters": {
+        "reference": [
+          "S1_136231_IW2_20200604T022312_VV_7C85-BURST",
+          "S1_136232_IW2_20200604T022315_VV_7C85-BURST"
+        ],
+        "secondary": [
+          "S1_136231_IW2_20200616T022313_VV_5D11-BURST",
+          "S1_136232_IW2_20200616T022316_VV_5D11-BURST"
+        ],
+        "apply_water_mask": true,
+        "looks": "5x1"
+      }
+    }
+  ]
+}
+```
+
 ## Submitting ARIA-S1-GUNW jobs
 The ARIA-S1-GUNW job type takes a reference [ESA granule ID](https://sentiwiki.copernicus.eu/web/s1-products#S1-Products-SAR-Naming-Convention){target=_blank} set, a secondary ESA granule ID set, and an ARIA-S1-GUNW Frame ID as input. See the [ARIA-S1-GUNW Product Guide Frame ID section](/guides/gunw_product_guide/#aria-frame-ids){target=_blank} for more details on these inputs.
 ```json