Release 6.3.4

CHANGELOG.md

@@ -6,6 +6,12 @@ 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).
 
+## [6.3.4]
+
+## Added
+- New DEM coverage file which allows for jobs over Armenia and Azerbaijan to use COP90.
+  Fixes [#462](https://github.com/ASFHyP3/hyp3-gamma/issues/462).
+
 ## [6.3.3]
 
 ### Fixed

hyp3_gamma/dem.py

@@ -9,7 +9,7 @@
 
 from hyp3_gamma.util import GDALConfigManager
 
-DEM_GEOJSON = '/vsicurl/https://asf-dem-west.s3.amazonaws.com/v2/cop30-2021-us-west-2-mirror.geojson'
+DEM_GEOJSON = '/vsicurl/https://asf-dem-west.s3.amazonaws.com/v2/cop30-2021-with-cop90-us-west-2-mirror.geojson'
 
 gdal.UseExceptions()
 ogr.UseExceptions()

hyp3_gamma/metadata/README.md

@@ -31,7 +31,7 @@ python -m hyp3_gamma.metadata insar --help
 ```
 for usage details. 
 
-**Note:** This will generate an *entire* product with pseduo data files
+**Note:** This will generate an *entire* product with pseudo data files
 (e.g., GeoTIFFs and Browse images), so you don't need to have a HyP3 product on
 hand.
 

hyp3_gamma/metadata/insar.py

@@ -131,7 +131,7 @@ def create_metadata_file(cls, payload: dict, template: str, reference_file: Path
             out_name = payload['product_dir'].name
 
         output_file = reference_file.parent / f'{out_name}.{out_ext}'
-        with open(output_file, 'w') as f:
+        with open(output_file, 'w', encoding='utf-8') as f:
             f.write(content)
 
         return output_file

hyp3_gamma/metadata/rtc.py

@@ -118,7 +118,7 @@ def create_metadata_file(cls, payload: dict, template: str, reference_file: Path
         if strip_pol:
             out_name = util.strip_polarization(out_name)
         output_file = reference_file.parent / f'{out_name}.{out_ext}'
-        with open(output_file, 'w') as f:
+        with open(output_file, 'w', encoding='utf-8') as f:
             f.write(content)
 
         return output_file

hyp3_gamma/metadata/templates/dem/dem-cop.xml.j2

@@ -1,9 +1,9 @@
 {% extends 'dem/dem.xml.j2' %}
-{% from 'macros.j2' import dem_pixel_spacing %}
+{% from 'macros.j2' import dem_pixel_spacing, cop_exemption %}
 {% block dataIdInfo %}
     <dataIdInfo>
         <idPurp>This file is the DEM used in the radiometric terrain correction process (using GAMMA software) for a granule of {{ granule_type }} SAR data from the Sentinel-1 mission. Cell values indicate the elevation in meters, and have been resampled to a pixel spacing of {{ pixel_spacing|int }} m. To access actual {{ scale }} values, refer to the VV/VH/HV/HH TIFF files included in the same folder as this image.</idPurp>
-        <idAbs>&lt;DIV STYLE="text-align:Left;"&gt;&lt;DIV&gt;&lt;DIV&gt;&lt;P&gt;&lt;SPAN&gt;This is the Digital Elevation Model (DEM) used in the Radiometric Terrain Correction (RTC) process for a granule of {{ granule_description }} ({{ granule_type }}) Synthetic Aperture Radar (SAR) data from the Copernicus Sentinel-1 mission of the European Space Agency (ESA). The granule was processed by ASF DAAC HyP3 {{ processing_date.year }} using the {{ plugin_name }} plugin version {{ plugin_version }} running {{ processor_name }} release {{ processor_version }}, and the extent of the DEM is clipped to the size needed for full granule coverage, or to the extent of the available DEM data if full coverage is not available. &lt;/SPAN&gt;&lt;/P&gt;&lt;P&gt;&lt;SPAN&gt;This DEM was generated from the Copernicus DEM GLO-30 dataset, which has a native pixel spacing of {{ dem_pixel_spacing(dem_name) }}. It was reprojected to {{ projection }}, and the pixel spacing was resampled from the native DEM pixel spacing to {{ pixel_spacing|int }} m. &lt;/SPAN&gt;&lt;/P&gt;&lt;P&gt;&lt;SPAN&gt;The source DEM tiles were downloaded from the Copernicus Digital Elevation Model (DEM) GLO-30 Public collection managed by Sinergise, which is available for download at &lt;/SPAN&gt;&lt;A href="https://registry.opendata.aws:443/copernicus-dem/" target="_blank" &gt;&lt;SPAN&gt;https://registry.opendata.aws/copernicus-dem/&lt;/SPAN&gt;&lt;/A&gt;&lt;SPAN&gt;. A geoid correction is applied to the source DEM values in preparation for RTC processing, so the height values in this file will differ from the source DEM values. This file is a 16-bit signed integer version of the 32-bit float DEM used for processing.&lt;/SPAN&gt;&lt;/P&gt;&lt;P&gt;&lt;SPAN&gt;The Copernicus DEM GLO-30 is a global Digital Surface Model (DSM) at 30-m pixel spacing derived from the WorldDEM. The WorldDEM is based on radar satellite data acquired by the TanDEM-X mission, which was funded by the German Aerospace Center (DLR) and Airbus Defence and Space, and edited to flatten water bodies, provide consistent flow of rivers, and apply corrections to shore/coastlines and special features. &lt;/SPAN&gt;&lt;/P&gt;&lt;P&gt;&lt;SPAN&gt;For an overview of this DEM resource, visit &lt;/SPAN&gt;&lt;A href="https://spacedata.copernicus.eu/collections/copernicus-digital-elevation-model" target="_blank" &gt;&lt;SPAN&gt;https://spacedata.copernicus.eu/collections/copernicus-digital-elevation-model&lt;/SPAN&gt;&lt;/A&gt;&lt;SPAN&gt;. The actual {{ scale }} data is contained in the VV/HH (primary polarization) and/or VH/HV (cross-polarization) TIFF files included in the same downloaded folder as this file. The name of the SAR granule used to generate the files in this folder is: {{ granule_name }}. For a detailed description of the Sentinel-1 file naming convention, refer to &lt;/SPAN&gt;&lt;A href="https://asf.alaska.edu/data-sets/sar-data-sets/sentinel-1/sentinel-1-data-and-imagery/#Naming_Convention" target="_blank" &gt;&lt;SPAN&gt;https://asf.alaska.edu/data-sets/sar-data-sets/sentinel-1/sentinel-1-data-and-imagery/#Naming_Convention&lt;/SPAN&gt;&lt;/A&gt;&lt;SPAN&gt;.&lt;/SPAN&gt;&lt;/P&gt;&lt;P&gt;&lt;SPAN&gt;Refer to ASF's &lt;/SPAN&gt;&lt;A href="https://hyp3-docs.asf.alaska.edu/guides/rtc_product_guide/" target="_blank" &gt;&lt;SPAN&gt;RTC Product Guide&lt;/SPAN&gt;&lt;/A&gt;&lt;SPAN&gt; for more information about On Demand RTC products.&lt;/SPAN&gt;&lt;/P&gt;&lt;P&gt;&lt;SPAN&gt;The Sentinel-1 mission is designed to be a two-satellite constellation. Sentinel-1A was launched April 3, 2014, and remains active. Sentinel-1B was launched April 25, 2016, and was active until December 23, 2021. The satellites each have a 12-day repeat cycle and use the same orbit pattern, but are offset 180 degrees to allow repeat passes every 6 days while both are active.&lt;/SPAN&gt;&lt;/P&gt;&lt;P&gt;&lt;SPAN&gt;Since the mission ended for S1B, there are some significant gaps in coverage. A reduced acquisition plan will be in place until Sentinel-1C is launched (expected in 2023) to replace Sentinel-1B. Visit &lt;/SPAN&gt;&lt;A href="https://hyp3-docs.asf.alaska.edu/sentinel1/" target="_blank" &gt;&lt;SPAN&gt;https://hyp3-docs.asf.alaska.edu/sentinel1&lt;/SPAN&gt;&lt;/A&gt;&lt;SPAN&gt; for more information.&lt;/SPAN&gt;&lt;/P&gt;&lt;P&gt;&lt;SPAN&gt;More information about the Sentinel-1 mission is available at &lt;/SPAN&gt;&lt;A href="https://sentinels.copernicus.eu/web/sentinel/missions/sentinel-1" target="_blank" &gt;&lt;SPAN&gt;https://sentinels.copernicus.eu/web/sentinel/missions/sentinel-1&lt;/SPAN&gt;&lt;/A&gt;&lt;SPAN&gt;.&lt;/SPAN&gt;&lt;/P&gt;&lt;P&gt;&lt;SPAN&gt;Additional information about Sentinel-1 data, imagery, tools and applications is available at &lt;/SPAN&gt;&lt;A href="https://asf.alaska.edu/data-sets/sar-data-sets/sentinel-1/" target="_blank" &gt;&lt;SPAN&gt;https://asf.alaska.edu/data-sets/sar-data-sets/sentinel-1&lt;/SPAN&gt;&lt;/A&gt;&lt;SPAN&gt;.&lt;/SPAN&gt;&lt;/P&gt;&lt;/DIV&gt;&lt;/DIV&gt;&lt;/DIV&gt;
+        <idAbs>&lt;DIV STYLE="text-align:Left;"&gt;&lt;DIV&gt;&lt;DIV&gt;&lt;P&gt;&lt;SPAN&gt;This is the Digital Elevation Model (DEM) used in the Radiometric Terrain Correction (RTC) process for a granule of {{ granule_description }} ({{ granule_type }}) Synthetic Aperture Radar (SAR) data from the Copernicus Sentinel-1 mission of the European Space Agency (ESA). The granule was processed by ASF DAAC HyP3 {{ processing_date.year }} using the {{ plugin_name }} plugin version {{ plugin_version }} running {{ processor_name }} release {{ processor_version }}, and the extent of the DEM is clipped to the size needed for full granule coverage, or to the extent of the available DEM data if full coverage is not available. &lt;/SPAN&gt;&lt;/P&gt;&lt;P&gt;&lt;SPAN&gt;This DEM was generated from the Copernicus DEM GLO-30 dataset, which has a native pixel spacing of {{ dem_pixel_spacing(dem_name) }}. {{ cop_exemption(dem_name)}} This DEM file was reprojected to {{ projection }}, and the pixel spacing was resampled from the native DEM pixel spacing to {{ pixel_spacing|int }} m. &lt;/SPAN&gt;&lt;/P&gt;&lt;P&gt;&lt;SPAN&gt;The source DEM tiles were downloaded from the Copernicus Digital Elevation Model (DEM) GLO-30 Public collection managed by Sinergise, which is available for download at &lt;/SPAN&gt;&lt;A href="https://registry.opendata.aws:443/copernicus-dem/" target="_blank" &gt;&lt;SPAN&gt;https://registry.opendata.aws/copernicus-dem/&lt;/SPAN&gt;&lt;/A&gt;&lt;SPAN&gt;. A geoid correction is applied to the source DEM values in preparation for RTC processing, so the height values in this file will differ from the source DEM values. This file is a 16-bit signed integer version of the 32-bit float DEM used for processing.&lt;/SPAN&gt;&lt;/P&gt;&lt;P&gt;&lt;SPAN&gt;The Copernicus DEM GLO-30 is a global Digital Surface Model (DSM) at 30-m pixel spacing derived from the WorldDEM. The WorldDEM is based on radar satellite data acquired by the TanDEM-X mission, which was funded by the German Aerospace Center (DLR) and Airbus Defence and Space, and edited to flatten water bodies, provide consistent flow of rivers, and apply corrections to shore/coastlines and special features. &lt;/SPAN&gt;&lt;/P&gt;&lt;P&gt;&lt;SPAN&gt;For an overview of this DEM resource, visit &lt;/SPAN&gt;&lt;A href="https://spacedata.copernicus.eu/collections/copernicus-digital-elevation-model" target="_blank" &gt;&lt;SPAN&gt;https://spacedata.copernicus.eu/collections/copernicus-digital-elevation-model&lt;/SPAN&gt;&lt;/A&gt;&lt;SPAN&gt;. The actual {{ scale }} data is contained in the VV/HH (primary polarization) and/or VH/HV (cross-polarization) TIFF files included in the same downloaded folder as this file. The name of the SAR granule used to generate the files in this folder is: {{ granule_name }}. For a detailed description of the Sentinel-1 file naming convention, refer to &lt;/SPAN&gt;&lt;A href="https://asf.alaska.edu/data-sets/sar-data-sets/sentinel-1/sentinel-1-data-and-imagery/#Naming_Convention" target="_blank" &gt;&lt;SPAN&gt;https://asf.alaska.edu/data-sets/sar-data-sets/sentinel-1/sentinel-1-data-and-imagery/#Naming_Convention&lt;/SPAN&gt;&lt;/A&gt;&lt;SPAN&gt;.&lt;/SPAN&gt;&lt;/P&gt;&lt;P&gt;&lt;SPAN&gt;Refer to ASF's &lt;/SPAN&gt;&lt;A href="https://hyp3-docs.asf.alaska.edu/guides/rtc_product_guide/" target="_blank" &gt;&lt;SPAN&gt;RTC Product Guide&lt;/SPAN&gt;&lt;/A&gt;&lt;SPAN&gt; for more information about On Demand RTC products.&lt;/SPAN&gt;&lt;/P&gt;&lt;P&gt;&lt;SPAN&gt;The Sentinel-1 mission is designed to be a two-satellite constellation. Sentinel-1A was launched April 3, 2014, and remains active. Sentinel-1B was launched April 25, 2016, and was active until December 23, 2021. The satellites each have a 12-day repeat cycle and use the same orbit pattern, but are offset 180 degrees to allow repeat passes every 6 days while both are active.&lt;/SPAN&gt;&lt;/P&gt;&lt;P&gt;&lt;SPAN&gt;Since the mission ended for S1B, there are some significant gaps in coverage. A reduced acquisition plan will be in place until Sentinel-1C is launched (expected in 2023) to replace Sentinel-1B. Visit &lt;/SPAN&gt;&lt;A href="https://hyp3-docs.asf.alaska.edu/sentinel1/" target="_blank" &gt;&lt;SPAN&gt;https://hyp3-docs.asf.alaska.edu/sentinel1&lt;/SPAN&gt;&lt;/A&gt;&lt;SPAN&gt; for more information.&lt;/SPAN&gt;&lt;/P&gt;&lt;P&gt;&lt;SPAN&gt;More information about the Sentinel-1 mission is available at &lt;/SPAN&gt;&lt;A href="https://sentinels.copernicus.eu/web/sentinel/missions/sentinel-1" target="_blank" &gt;&lt;SPAN&gt;https://sentinels.copernicus.eu/web/sentinel/missions/sentinel-1&lt;/SPAN&gt;&lt;/A&gt;&lt;SPAN&gt;.&lt;/SPAN&gt;&lt;/P&gt;&lt;P&gt;&lt;SPAN&gt;Additional information about Sentinel-1 data, imagery, tools and applications is available at &lt;/SPAN&gt;&lt;A href="https://asf.alaska.edu/data-sets/sar-data-sets/sentinel-1/" target="_blank" &gt;&lt;SPAN&gt;https://asf.alaska.edu/data-sets/sar-data-sets/sentinel-1&lt;/SPAN&gt;&lt;/A&gt;&lt;SPAN&gt;.&lt;/SPAN&gt;&lt;/P&gt;&lt;/DIV&gt;&lt;/DIV&gt;&lt;/DIV&gt;
         </idAbs>
         <idCredit>Produced using Copernicus WorldDEM-30 Copr. DLR e.V. 2010-2014 and Copr. Airbus Defence and Space GmbH 2014-2018 provided under COPERNICUS by the European Union and ESA; all rights reserved.</idCredit>
         <idCitation xmlns="">