Release v0.13.13

.github/workflows/check-links.yml

@@ -9,11 +9,11 @@ jobs:
   linkChecker:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v7
 
       - name: Link Checker
         id: lychee
-        uses: lycheeverse/lychee-action@v2.8.0
+        uses: lycheeverse/lychee-action@v2.9.0
         env:
           GITHUB_TOKEN: ${{secrets.TOOLS_BOT_PAK}}
         with:

.github/workflows/deploy_to_github_io.yml

@@ -11,14 +11,14 @@ jobs:
     name: Build site and deploy
     runs-on: "ubuntu-latest"
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v7
         with:
           path: hyp3-docs
 
       - uses: conda-incubator/setup-miniconda@v4
         with:
           auto-update-conda: true
-          python-version: '3.10'
+          python-version: '3.11'
           activate-environment: hyp3-docs
           environment-file: hyp3-docs/environment.yml
 
@@ -33,7 +33,7 @@ jobs:
           sed -i 's|site_url: https://hyp3-docs.asf.alaska.edu/|site_url: https://hyp3-docs.asf.alaska.edu/hyp3-docs/|' mkdocs.yml
           mkdocs gh-deploy --force
 
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v7
         if: github.ref == 'refs/heads/main'
         with:
           repository: ASFHyP3/ASFHyP3.github.io

.github/workflows/spellcheck.yml

@@ -7,7 +7,7 @@ jobs:
     name: Spellcheck
     steps:
       - name: Checkout
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
       - name: Spellcheck
         uses: tbroadley/spellchecker-cli-action@v1
         with:

.github/workflows/test-build.yml

@@ -11,12 +11,12 @@ jobs:
     name: Test build of site
     runs-on: "ubuntu-latest"
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v7
 
       - uses: conda-incubator/setup-miniconda@v4
         with:
           auto-update-conda: true
-          python-version: '3.10'
+          python-version: '3.11'
           activate-environment: hyp3-docs
           environment-file: environment.yml
 

.github/workflows/update_asf_tools_version.yml

@@ -12,7 +12,7 @@ jobs:
     name: Bump the ASF Tools version
     runs-on: "ubuntu-latest"
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v7
         with:
           token: ${{ secrets.TOOLS_BOT_PAK }}
 

.github/workflows/update_sdk_version.yml

@@ -12,7 +12,7 @@ jobs:
     name: Bump the SDK version
     runs-on: "ubuntu-latest"
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v7
         with:
           token: ${{ secrets.TOOLS_BOT_PAK }}
 

CHANGELOG.md

@@ -6,6 +6,13 @@ 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.13.13]
+
+### Changed
+* Updated HyP3 SDK to [v7.7.8](https://github.com/ASFHyP3/hyp3-sdk/blob/main/CHANGELOG.md#778).
+* Upgraded the conda environment and build workflows to use Python 3.11.
+
+
 ## [0.13.12]
 
 ### Changed

docs/guides/burst_insar_product_guide.md

@@ -408,6 +408,7 @@ output product:
 - The *normalized coherence* file contains pixel values that range from 0.0 to 1.0, with 0.0 being completely non-coherent and 1.0 being perfectly coherent.
 - The *unwrapped geocoded interferogram* file shows the results of the phase unwrapping process. Negative values indicate movement towards the sensor, and positive values indicate movement away from the sensor. This is the main interferogram output.
 - The *wrapped geocoded interferogram* file indicates the interferogram phase after applying the adaptive filter immediately before unwrapping. Values range from negative pi to positive pi.
+- An interferogram *amplitude* image is included for products generated using the `INSAR_ISCE_MULTI_BURST` job type.
 - The *connected components* file delineates regions unwrapped as contiguous units by the SNAPHU unwrapping algorithm.
 - The *look vectors* theta (θ) and phi (φ) describe the elevation and orientation angles of the look vector in radians. The look vectors refer to the look direction back towards the sensor.
     - The *lv_theta* (θ) file indicates the SAR look vector elevation angle (in radians) at each pixel, ranging from -π/2 (down) to π/2 (up). The look vector elevation angle is defined as the angle between the horizontal surface and the look vector with positive angles indicating sensor positions above the surface.
@@ -438,7 +439,9 @@ These range-doppler files are not included in products generated using `INSAR_IS
 as the individual bursts are already merged together.
 
 An *unwrapped phase browse image* is included for the unwrapped (unw_phase) phase file, which is in PNG format 
-and is 2048 pixels wide. For jobs processed using `INSAR_ISCE_MULTI_BURST`, the final product includes the interferogram amplitude as a single-band GeoTIFF along with browse KMZ files for both the wrapped phase and amplitude.
+and is 2048 pixels wide.
+
+For jobs processed using `INSAR_ISCE_MULTI_BURST`, **KMZ browse images** are included for the **wrapped phase** and **amplitude** images.
 
 The tags and extensions used and example file names for each raster are listed in Table 2 below.
 
@@ -448,7 +451,7 @@ The tags and extensions used and example file names for each raster are listed i
 
 | Extension              | Description                         | Example (single-burst)<br/>⸻<br/>Example (multi-burst)                           |
 |------------------------|-------------------------------------|----------------------------------------------------------------------------------|
-| _amp.tif               | Amplitude file                      | {{ base_name_mb }}_amp.tif                                                          |
+| _amp.tif               | Amplitude file                      | {{ base_name_mb }}_amp.tif                                                       |
 | _conncomp.tif          | Connected Components                | {{ base_name }}_conncomp.tif<br/>⸻<br/>{{ base_name_mb }}_conncomp.tif           |
 | _corr.tif              | Normalized coherence file           | {{ base_name }}_corr.tif<br/>⸻<br/>{{ base_name_mb }}_corr.tif                   |
 | _unw_phase.tif         | Unwrapped geocoded interferogram    | {{ base_name }}_unw_phase.tif<br/>⸻<br/>{{ base_name_mb }}_unw_phase.tif         |
@@ -462,8 +465,8 @@ The tags and extensions used and example file names for each raster are listed i
 | _los_rdr.tif           | Range-Doppler look vectors          | {{ base_name }}_los_rdr.tif                                                      |
 | _wrapped_phase_rdr.tif | Wrapped Range-Doppler interferogram | {{ base_name }}_wrapped_phase_rdr.tif                                            |
 | _unw_phase.png         | Unwrapped phase browse image        | {{ base_name }}_unw_phase.png<br/>⸻<br/>{{ base_name_mb }}_unw_phase.png         |
-| _amp.kmz               | Amplitude KMZ browse image          | {{ base_name_mb }}_amp.kmz         |
-| _wrapped_phase.kmz     | Wrapped phase KMZ browse image      | {{ base_name_mb }}_wrapped_phase.kmz         |
+| _amp.kmz               | Amplitude KMZ browse image          | {{ base_name_mb }}_amp.kmz                                                       |
+| _wrapped_phase.kmz     | Wrapped phase KMZ browse image      | {{ base_name_mb }}_wrapped_phase.kmz                                             |
 
 *Table 2: Image files in product package*
 

docs/using/sdk.md

@@ -1 +1 @@
-{{ get_content('https://raw.githubusercontent.com/ASFHyP3/hyp3-sdk/v7.7.7/README.md') }}
+{{ get_content('https://raw.githubusercontent.com/ASFHyP3/hyp3-sdk/v7.7.8/README.md') }}

docs/using/sdk_api.md

@@ -1,4 +1,4 @@
-# `hyp3_sdk` *v7.7.7* API Reference
+# `hyp3_sdk` *v7.7.8* API Reference
 
 ::: hyp3_sdk
     options:

environment.yml

@@ -3,9 +3,9 @@ channels:
   - conda-forge
   - nodefaults
 dependencies:
-  - 'python=3.10'
+  - 'python=3.11'
   - pip
-  - hyp3_sdk=7.7.7  # also pinned in docs/using/sdk.md
+  - hyp3_sdk=7.7.8  # also pinned in docs/using/sdk.md
   - asf_tools=0.8.4  # also pinned in docs/tools/asf_tools.md
   - pip:
     - -r requirements.txt