Merge branch 'main' of https://github.com/johntruckenbrodt/pyroSAR into feature/ers_envisat

johntruckenbrodt · johntruckenbrodt · commit b73a40b2bd07 · 2025-08-22T10:53:12.000+02:00
diff --git a/docs/source/about/changelog.rst b/docs/source/about/changelog.rst
@@ -1132,4 +1132,24 @@ Drivers
 
   - :meth:`pyroSAR.drivers.ID.bbox`
   - :meth:`pyroSAR.drivers.ID.geometry`
-- method :meth:`pyroSAR.drivers.Archive.select`: new argument `return_value`
+- method :meth:`pyroSAR.drivers.Archive.select`: new argument `return_value`
+
+0.30.1 | 2025-08-22
+===================
+
+Drivers
+-------
+- :class:`~pyroSAR.drivers.ESA`: read all `GEOLOCATION GRID ADS` segments to obtain GCPs, not just the first one (bugfix)
+
+GAMMA API
+---------
+- support for GAMMA version 20250625
+- support for polar stereographic projections (via :meth:`~pyroSAR.gamma.auxil.ISPPar.envidict`)
+- class :class:`~pyroSAR.gamma.auxil.ISPPar`: raise error if file type is unknown
+  (instead of setting the `filetype` attribute to `unknown`)
+- :func:`~pyroSAR.gamma.util.pixel_area_wrap`:
+
+  + create ENVI HDR files for inputs to :func:`~pyroSAR.gamma.util.lat_ratio` (bugfix)
+  + fixed bug in ignoring conditions for writing ENVI HDR files of `pix*` and `gs_ratio` products
+
+- improved readability of tests
diff --git a/docs/source/api/gamma/api.rst b/docs/source/api/gamma/api.rst
@@ -1,52 +1,3 @@
-GAMMA
-=====
-
-Processing
-----------
-
-.. automodule:: pyroSAR.gamma
-    :members: geocode, convert2gamma, ISPPar, process, ovs, S1_deburst, correctOSV, multilook, par2hdr, UTM, calibrate
-    :undoc-members:
-    :show-inheritance:
-
-    .. autosummary::
-        :nosignatures:
-
-        calibrate
-        convert2gamma
-        correctOSV
-        geocode
-        ISPPar
-        multilook
-        ovs
-        par2hdr
-        process
-        S1_deburst
-        UTM
-
-DEM tools
----------
-
-.. automodule:: pyroSAR.gamma.dem
-    :members: dem_autocreate, dem_import, dempar, fill, hgt, hgt_collect, makeSRTM, mosaic, swap
-    :undoc-members:
-    :show-inheritance:
-
-    .. autosummary::
-        :nosignatures:
-
-        dem_autocreate
-        dem_import
-        dempar
-        fill
-        hgt
-        hgt_collect
-        makeSRTM
-        mosaic
-        swap
-
-.. _gamma-command-api:
-
 GAMMA Command API
 -----------------
 
@@ -107,4 +58,4 @@ Within each function, the command name and all parameters are passed to function
 .. automodule:: pyroSAR.gamma.parser_demo
     :members:
     :undoc-members:
-    :show-inheritance:
+    :show-inheritance:
diff --git a/docs/source/api/gamma/auxil.rst b/docs/source/api/gamma/auxil.rst
@@ -0,0 +1,19 @@
+Auxiliary functionality
+-----------------------
+
+.. automodule:: pyroSAR.gamma.auxil
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+    .. autosummary::
+        :nosignatures:
+
+        do_execute
+        ISPPar
+        Namespace
+        par2hdr
+        process
+        slc_corners
+        Spacing
+        UTM
diff --git a/docs/source/api/gamma/dem.rst b/docs/source/api/gamma/dem.rst
@@ -0,0 +1,20 @@
+DEM tools
+---------
+
+.. automodule:: pyroSAR.gamma.dem
+    :members: dem_autocreate, dem_import, dempar, fill, hgt, hgt_collect, makeSRTM, mosaic, swap
+    :undoc-members:
+    :show-inheritance:
+
+    .. autosummary::
+        :nosignatures:
+
+        dem_autocreate
+        dem_import
+        dempar
+        fill
+        hgt
+        hgt_collect
+        makeSRTM
+        mosaic
+        swap
diff --git a/docs/source/api/gamma/figures/gamma_geocode.graphml b/docs/source/api/gamma/figures/gamma_geocode.graphml
diff --git a/docs/source/api/gamma/figures/gamma_geocode.svg b/docs/source/api/gamma/figures/gamma_geocode.svg
diff --git a/docs/source/api/gamma/index.rst b/docs/source/api/gamma/index.rst
@@ -0,0 +1,10 @@
+GAMMA
+=====
+
+.. toctree::
+    :maxdepth: 1
+
+    util
+    auxil
+    dem
+    api
diff --git a/docs/source/api/gamma/util.rst b/docs/source/api/gamma/util.rst
@@ -0,0 +1,23 @@
+Processing
+----------
+
+.. automodule:: pyroSAR.gamma.util
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+    .. autosummary::
+        :nosignatures:
+
+        calibrate
+        convert2gamma
+        correctOSV
+        gc_map_wrap
+        geocode
+        lat_linear_to_db
+        lat_product
+        lat_ratio
+        multilook
+        ovs
+        pixel_area_wrap
+        S1_deburst
diff --git a/docs/source/index.rst b/docs/source/index.rst
@@ -25,7 +25,7 @@ API Documentation
 
     api/drivers
     api/snap
-    api/gamma
+    api/gamma/index
     api/sentinel-1
     api/auxdata
     api/datacube
diff --git a/pyroSAR/gamma/__init__.py b/pyroSAR/gamma/__init__.py
@@ -1,3 +1,3 @@
 from .auxil import process, ISPPar, UTM, Spacing, Namespace, slc_corners, par2hdr
-from .util import geocode, multilook, ovs, convert2gamma, calibrate, correctOSV, S1_deburst
+from .util import calibrate, convert2gamma, correctOSV, geocode, multilook, ovs, S1_deburst
 from . import dem
diff --git a/pyroSAR/gamma/auxil.py b/pyroSAR/gamma/auxil.py
diff --git a/pyroSAR/gamma/util.py b/pyroSAR/gamma/util.py

-Original file line number
+Diff line change
@@ @@ -0,0 +1,10 @@ @@
 +GAMMA
 +=====
++
 +.. toctree::
 +    :maxdepth: 1
++
 +    util
 +    auxil
 +    dem
 +    api