Refactor shape masking

docs/src/whatsnew/latest.rst

@@ -34,6 +34,12 @@ This document explains the changes made to Iris for this release
    horizontal grid.
    (:issue:`5770`, :pull:`6581`)
 
+#. `@hsteptoe`_ and `@trexfeathers`_ (reviewer) added :func:`iris.util.mask_cube_from_shape`
+   to handle additional Point and Line shape types.  This change also facilitates the use of
+   shapefiles that use a different projection system to the cube that they are being applied to, 
+   and makes performance improvements to the mask weighting calculations. 
+   (:issue:`6126`, :pull:`6129`).
+
 #. `@bjlittle`_ extended ``zlib`` compression of :class:`~iris.cube.Cube` data
    payload when saving to NetCDF to also include any attached `CF-UGRID`_
    :class:`~iris.mesh.components.MeshXY`. Additionally,
@@ -106,15 +112,20 @@ This document explains the changes made to Iris for this release
 🔗 Dependencies
 ===============
 
-#. N/A
-
+#. `@hsteptoe`_ added `rasterio`_ and `affine`_ as optional dependencies that facilitate
+   :func:`iris.util.mask_cube_from_shape`. These packages support new functionality that 
+   handles additional shapefile types and projections. (:issue:`6126`, :pull:`6129`)
 
 📚 Documentation
 ================
 
 #. `@rcomer`_ updated all Cartopy references to point to the new location at
    https://cartopy.readthedocs.io (:pull:`6636`)
 
+#. `@hsteptoe`_ added additional worked examples to the :func:`iris.util.mask_cube_from_shape` 
+   documentation, to demonstrate how to use the function with different types of shapefiles. 
+   (:pull:`6129`)
+
 
 💼 Internal
 ===========
@@ -138,11 +149,14 @@ This document explains the changes made to Iris for this release
     Whatsnew author names (@github name) in alphabetical order. Note that,
     core dev names are automatically included by the common_links.inc:
 
+.. _@hsteptoe: https://github.com/hsteptoe
 .. _@melissaKG: https://github.com/melissaKG
 
 
 
 .. comment
     Whatsnew resources in alphabetical order:
 
+.. _affine: https://affine.readthedocs.io/en/latest/
 .. _netcdf-c#3183: https://github.com/Unidata/netcdf-c/issues/3183
+.. _rasterio: https://rasterio.readthedocs.io/en/stable/index.html