From 2119eb3803d8bc00937c74fb602d2d63d6653385 Mon Sep 17 00:00:00 2001
From: John Truckenbrodt <john.truckenbrodt@uni-jena.de>
Date: Thu, 3 Mar 2022 09:38:58 +0100
Subject: [PATCH] [docs] version 0.16.0 changelog

---
 docs/about/changelog.rst | 64 +++++++++++++++++++++++++++++++++++++++-
 1 file changed, 63 insertions(+), 1 deletion(-)

diff --git a/docs/about/changelog.rst b/docs/about/changelog.rst
index b262e9ab..dc685839 100644
--- a/docs/about/changelog.rst
+++ b/docs/about/changelog.rst
@@ -681,4 +681,66 @@ general
 ===================
 general
 -------
-- bug fixes
\ No newline at end of file
+- bug fixes
+
+0.16.0 | 2022-03-03
+===================
+
+Drivers
+-------
+- :class:`pyroSAR.drivers.BEAM_DIMAP`: new driver supporting SNAP's BEAM-DIMAP format
+- :class:`pyroSAR.drivers.SAFE`:
+
+  + corrected SLC metadata (was read from first sub-swath, now from center sub-swath or as sum of all sub-swaths):
+    center: spacing, heading, incidence; sum: samples, lines
+  + new property :attr:`pyroSAR.drivers.SAFE.resolution`
+
+Auxiliary Data Handling
+-----------------------
+- create water body mask mosaics from ancillary DEM products;
+  see section :ref:`extrapolation of water masks`. Affects the following:
+
+  + function :func:`pyroSAR.auxdata.dem_autoload`: new arguments `nodata` and `hide_nodata`
+
+- function :func:`pyroSAR.auxdata.dem_create`:
+
+  + new arguments `pbar` and `threads`
+
+SNAP API
+--------
+- new method :meth:`pyroSAR.snap.auxil.Par_BandMath.add_equation`
+- new function :func:`pyroSAR.snap.util.noise_power`
+- new function :func:`pyroSAR.snap.auxil.erode_edges`
+- function :func:`pyroSAR.snap.auxil.writer`:
+
+  + new arguments `clean_edges` and `clean_edges_npixels`
+    (to make use of function :func:`~pyroSAR.snap.auxil.erode_edges`)
+  + enabled conversion of BEAM-DIMAP files
+
+- function :func:`pyroSAR.snap.util.geocode`:
+
+  + new arguments `clean_edges` and `clean_edges_npixels` (see function :func:`~pyroSAR.snap.auxil.writer`)
+  + renamed argument `tr` to `spacing`
+  + new arguments `rlks` and `azlks` to manually set the number of looks
+
+GAMMA API
+---------
+- function :func:`pyroSAR.gamma.geocode`:
+
+  + new arguments `rlks` and `azlks`
+
+- function :func:`pyroSAR.gamma.multilook`:
+
+  + new arguments `rlks` and `azlks`
+
+general
+-------
+- correction of multi-look factor computation. Before: approximate target pixel spacing but never exceed it.
+  Now: first best approximate the azimuth spacing as close as possible (even if this means exceeding the target spacing)
+  and then choose the range looks to approximate a square pixel as close as possible. API changes:
+
+  + function :func:`pyroSAR.ancillary.multilook_factors`:
+
+    * renamed argument `sp_rg` to `source_rg`
+    * renamed argument `sp_az` to `source_az`
+    * replaced arguments `tr_rg` and `tr_az` with unified `target`