Merge pull request #496 from tobac-project/RC_v1.6.0

Merge `RC_v1.6.0` into `main`

Author: w-k-jones

.readthedocs.yml

@@ -7,3 +7,6 @@ build:
 python:
   install:
     - requirements: doc/requirements.txt
+sphinx:
+  # Path to your Sphinx configuration file.
+  configuration: doc/conf.py

.zenodo.json

@@ -20,7 +20,6 @@
             "affiliation": "University of Oxford",
             "orcid": "0000-0001-9786-3723"
         },
-
         {
             "name": "Kukulies, Julia",
             "affiliation": "NSF National Center for Atmospheric Research",
@@ -66,7 +65,6 @@
             "affiliation": "Leibniz Institute for Tropospheric Research, Leipzig (Germany)",
             "orcid": "0000-0002-4524-8152"
         },
-
         {
             "name": "Pfeifer, Nils",
             "affiliation": "Leibniz Institute for Tropospheric Research, Leipzig (Germany)",
@@ -81,6 +79,10 @@
             "name": "Zhang, Xin",
             "affiliation": "Nanjing University of Information Science & Technology (China)",
             "orcid": "0000-0002-1756-6620"
+        },
+        {
+            "name": "Ziegner, Fabian", 
+            "affiliation":"Leibniz Institute for Tropospheric Research, Leipzig (Germany)"
         }
     ],
     "license": "BSD-3-Clause",

CHANGELOG.md

@@ -1,5 +1,24 @@
 ### Tobac Changelog
 
+_**Version 1.6.0:**_
+
+**Enhancements for Users**
+
+- MAJOR CHANGE: Feature detection and segmentation have been changed to use xarray DataArrays for representation of spatial fields instead of Iris Cubes. This change will allow for increased flexibility for input data and ease development. Support for Iris Cube input is maintained through a conversion wrapper. [#354](https://github.com/tobac-project/tobac/pull/354) & [#417](https://github.com/tobac-project/tobac/pull/417)
+- Some differences in the output of feature detection are present in the output from feature detection: when using xarray, the column names for coordinates will use the variable names, while with iris the columns will use the standard names. This differences reflects the different ways in which coordinates are named in xarray and iris, and can be overridden by the user using the `use_standard_names` parameter. [#489](https://github.com/tobac-project/tobac/pull/489)
+
+**Bug fixes**
+
+- An issue with datetime output from feature detection being converted to `cftime` format erroneously was fixed, and datetime formats should now match the formatting in the input field. Time matching within a tolerance range now works with any combination of datetime formats [#489](https://github.com/tobac-project/tobac/pull/489)
+
+**Documentation**
+
+- Example notebooks have been converted to use `xarray`, and have had minor enhancements to descriptions and visualisations. A notebook showing the legacy approach using Iris Cube input is retained [#487](https://github.com/tobac-project/tobac/pull/487)
+
+**Internal Enhancements**
+
+- `tobac.utils.internal.basic` was restructured into `coordinates` and `label_props` utils, and new `datetime` and `generators` utils were added [#489](https://github.com/tobac-project/tobac/pull/489)
+
 _**Version 1.5.5:**_
 
 **Bug fixes**

doc/big_datasets.rst

@@ -25,7 +25,7 @@ Below is a snippet from a larger notebook demonstrating how to run feature detec
     )
     out_feature_dfs = db.map(
         lambda x: tobac.feature_detection_multithreshold(
-            x.to_iris(), 4000, **parameters_features
+            x, 4000, **parameters_features
         ),
         b,
     ).compute()