dev

Author: davidhassell

Changelog.rst

@@ -5,7 +5,12 @@ Version NEXTVERSION
 
 * Read Zarr datasets with `cf.read`
   (https://github.com/NCAS-CMS/cf-python/issues/863)
+* New keyword parameter to `cf.DimensionCoordinate.create_bounds`:
+  ``inplace`` (https://github.com/NCAS-CMS/cf-python/issues/855)
+* Set new minimum version of `dask`: ``2025.5.1``
+  (https://github.com/NCAS-CMS/cf-python/issues/866)
 * Changed dependency: ``cfdm>=1.12.2.0, <1.12.3.0``
+* Changed dependency: ``dask>=2025.5.1``
 
 ----
 

cf/__init__.py

@@ -196,21 +196,17 @@
             f"Got {psutil.__version__} at {psutil.__file__}"
         )
 
+# Check the version of dask
 try:
     import dask
 except ImportError as error1:
     raise ImportError(_error0 + str(error1))
 else:
-    _minimum_vn = "2025.2.0"
-    # Note in this case max is inclusive, change inequalities if this changes
-    _maximum_vn = "2025.3.0"
-    _dask_version = Version(dask.__version__)
-    if _dask_version < Version(_minimum_vn) or _dask_version > Version(
-        _maximum_vn
-    ):
-        raise RuntimeError(
-            "Bad dask version: cf requires "
-            f"{_minimum_vn}<=dask<={_maximum_vn}. Got {_dask_version}."
+    _minimum_vn = "2025.5.1"
+    if Version(dask.__version__) < Version(_minimum_vn):
+        raise ValueError(
+            f"Bad dask version: cf requires dask>={_minimum_vn}. "
+            f"Got {dask.__version__} at {dask.__file__}"
         )
 
 try:

cf/dimensioncoordinate.py

@@ -533,18 +533,25 @@ def create_regular(cls, args, units=None, standard_name=None, bounds=True):
         return coordinate
 
     def create_bounds(
-        self, bound=None, cellsize=None, flt=0.5, max=None, min=None
+        self,
+        bound=None,
+        cellsize=None,
+        flt=0.5,
+        max=None,
+        min=None,
+        inplace=False,
     ):
         """Create cell bounds.
 
-        Creates new cell bounds, irrespective of whether the cells
-        already have cell bounds. The new bounds are not set on the
-        dimension coordinate construct, but if that is desired they
-        may always be added with the `set_bounds` method, for
-        instance:
+        When the operation is *not* in-place (the default), new bounds
+        will be created and returned, regardless of whether or not
+        bounds already exist, but the bounds are not set on the
+        dimension coordinate construct.
 
-        >>> b = d.create_bounds()
-        >>> d.set_bounds(b)
+        If the operation is in-place (i.e. the *inplace* parameter is
+        True) then the newly created bounds will be set on the
+        dimension coordinate construct and `None` is returned, but
+        only if there are no existing bounds.
 
         By default, Voronoi cells are created by defining cell bounds
         that are half way between adjacent coordinate values. For
@@ -640,10 +647,13 @@ def create_bounds(
                   ``-90``: ``min=-90``, or ``min=cf.Data(-90,
                   'degrees_north')``.
 
+            {{inplace: `bool`, optional}}
+
         :Returns:
 
-            `Bounds`
-                The new coordinate cell bounds.
+            `Bounds` or `None`
+                The new coordinate cell bounds, or `None` if the
+                operation was in-place.
 
         **Examples**
 
@@ -756,6 +766,13 @@ def create_bounds(
           cftime.DatetimeGregorian(1985, 12, 1, 0, 0, 0, 0)]]
 
         """
+        if inplace and self.has_bounds():
+            raise ValueError(
+                "Can't create dimension coordinate bounds in-place when "
+                "bounds already exist. Existing bounds may be removed "
+                "with the 'del_bounds' method."
+            )
+
         array = self.array
         size = array.size
 
@@ -907,6 +924,10 @@ def create_bounds(
         # Create coordinate bounds object
         bounds = Bounds(data=Data(bounds, units=self.Units), copy=False)
 
+        if inplace:
+            self.set_bounds(bounds)
+            return
+
         return bounds
 
     def del_cell_characteristics(self, default=ValueError()):

cf/functions.py

@@ -3187,50 +3187,50 @@ def environment(display=True, paths=True):
     **Examples**
 
     >>> cf.environment()
-    Platform: Linux-5.15.0-122-generic-x86_64-with-glibc2.35
-    HDF5 library: 1.12.2
-    netcdf library: 4.9.3-development
-    udunits2 library: /home/user/lib/libudunits2.so.0
-    esmpy/ESMF: 8.6.1 /home/user/lib/python3.12/site-packages/esmpy/__init__.py
-    Python: 3.12.2 /home/user/bin/python
-    dask: 2025.2.0 /home/user/lib/python3.12/site-packages/dask/__init__.py
-    netCDF4: 1.6.5 /home/user/lib/python3.12/site-packages/netCDF4/__init__.py
-    h5netcdf: 1.3.0 /home/user/lib/python3.12/site-packages/h5netcdf/__init__.py
-    h5py: 3.11.0 /home/user/lib/python3.12/site-packages/h5py/__init__.py
-    s3fs: 2024.6.0 /home/user/lib/python3.12/site-packages/s3fs/__init__.py
-    psutil: 5.9.8 /home/user/lib/python3.12/site-packages/psutil/__init__.py
-    packaging: 23.2 /home/user/lib/python3.12/site-packages/packaging/__init__.py
-    numpy: 1.26.4 /home/user/lib/python3.12/site-packages/numpy/__init__.py
-    scipy: 1.13.0 /home/user/lib/python3.12/site-packages/scipy/__init__.py
-    matplotlib: 3.8.4 /home/user/lib/python3.12/site-packages/matplotlib/__init__.py
-    cftime: 1.6.3 /home/user/lib/python3.12/site-packages/cftime/__init__.py
-    cfunits: 3.3.7 /home/user/lib/python3.12/site-packages/cfunits/__init__.py
-    cfplot: 3.3.0 /home/user/lib/python3.12/site-packages/cfplot/__init__.py
-    cfdm: 1.12.0.0 /home/user/cfdm/cfdm/__init__.py
-    cf: 3.17.0 /home/user/cf-python/cf/__init__.py
+    Platform: Linux-6.8.0-60-generic-x86_64-with-glibc2.39
+    HDF5 library: 1.14.2
+    netcdf library: 4.9.4-development
+    udunits2 library: libudunits2.so.0
+    esmpy/ESMF: 8.7.0 /home/miniconda/lib/python3.12/site-packages/esmpy/__init__.py
+    Python: 3.12.8 /home/miniconda/bin/python
+    dask: 2025.5.1 /home/miniconda/lib/python3.12/site-packages/dask/__init__.py
+    netCDF4: 1.7.2 /home/miniconda/lib/python3.12/site-packages/netCDF4/__init__.py
+    h5netcdf: 1.3.0  /home/miniconda/lib/python3.12/site-packages/h5netcdf/__init__.py
+    h5py: 3.12.1 /home/miniconda/lib/python3.12/site-packages/h5py/__init__.py
+    s3fs: 2024.12.0 /home/miniconda/lib/python3.12/site-packages/s3fs/__init__.py
+    psutil: 6.1.1 /home/miniconda/lib/python3.12/site-packages/psutil/__init__.py
+    packaging: 24.2 /home/miniconda/lib/python3.12/site-packages/packaging/__init__.py
+    numpy: 2.2.2 /home/miniconda/lib/python3.12/site-packages/numpy/__init__.py
+    scipy: 1.15.2 /home/miniconda/lib/python3.12/site-packages/scipy/__init__.py
+    matplotlib: 3.10.0 /home/miniconda/lib/python3.12/site-packages/matplotlib/__init__.py
+    cftime: 1.6.4.post1 /home/miniconda/lib/python3.12/site-packages/cftime/__init__.py
+    cfunits: 3.3.7 /home/miniconda/lib/python3.12/site-packages/cfunits/__init__.py
+    cfplot: 3.3.0 /home/miniconda/lib/python3.12/site-packages/cfplot/__init__.py
+    cfdm: 1.12.2.0  /home/miniconda/lib/python3.12/site-packages/cfdm/__init__.py
+    cf: NEXTVERSION  /home/miniconda/lib/python3.12/site-packages/cf/__init__.py
 
     >>> cf.environment(paths=False)
-    Platform: Linux-5.15.0-122-generic-x86_64-with-glibc2.35
-    HDF5 library: 1.12.2
-    netcdf library: 4.9.3-development
-    udunits2 library: /home/user/lib/libudunits2.so.0
-    esmpy/ESMF: 8.6.1
-    Python: 3.12.2
-    dask: 2025.2.0
-    netCDF4: 1.6.5
+    Platform: Linux-6.8.0-60-generic-x86_64-with-glibc2.39
+    HDF5 library: 1.14.2
+    netcdf library: 4.9.4-development
+    udunits2 library: libudunits2.so.0
+    esmpy/ESMF: 8.7.0
+    Python: 3.12.8
+    dask: 2025.5.1
+    netCDF4: 1.7.2
     h5netcdf: 1.3.0
-    h5py: 3.11.0
-    s3fs: 2024.6.0
-    psutil: 5.9.8
-    packaging: 23.2
-    numpy: 1.26.4
-    scipy: 1.13.0
-    matplotlib: 3.8.4
-    cftime: 1.6.3
+    h5py: 3.12.1
+    s3fs: 2024.12.0
+    psutil: 6.1.1
+    packaging: 24.2
+    numpy: 2.2.2
+    scipy: 1.15.2
+    matplotlib: 3.10.0
+    cftime: 1.6.4.post1
     cfunits: 3.3.7
     cfplot: 3.3.0
-    cfdm: 1.12.0.0
-    cf: 3.17.0
+    cfdm: 1.12.2.0
+    cf: NEXTVERSION
 
     """
     dependency_version_paths_mapping = {

cf/test/test_DimensionCoordinate.py

@@ -544,6 +544,15 @@ def test_DimensionCoordinate_create_bounds(self):
             ).all()
         )
 
+        # In-place
+        self.assertFalse(d.has_bounds())
+        self.assertIsNone(d.create_bounds(inplace=True))
+        self.assertTrue(d.has_bounds())
+
+        # Fail when inplace=True and bounds already exist
+        with self.assertRaises(ValueError):
+            d.create_bounds(inplace=True)
+
         # Cellsize units must be equivalent to the coordinate units,
         # or if the cell has no units then they are assumed to be
         # the same as the coordinates:

docs/source/installation.rst

@@ -194,8 +194,7 @@ Required
 
 * `numpy <http://www.numpy.org>`_, versions 2.0.0 or newer.
 
-* `dask <https://pypi.org/project/dask>`_, version 2025.2.0 or newer up to
-  2025.3.0 inclusive.
+* `dask <https://pypi.org/project/dask>`_, version 2025.5.1.
 
 * `netCDF4 <https://pypi.org/project/netcdf4/>`_, 1.7.2 or newer.
 
@@ -204,8 +203,8 @@ Required
 
 * `scipy <https://pypi.org/project/scipy>`_, version 1.10.0 or newer.
 
-* `cfdm <https://pypi.org/project/cfdm/>`_, version 1.12.1.0 or up to,
-  but not including, 1.12.2.0.
+* `cfdm <https://pypi.org/project/cfdm/>`_, version 1.12.2.0 or up to,
+  but not including, 1.12.3.0.
 
 * `cfunits <https://pypi.org/project/cfunits/>`_, version 3.3.7 or newer.
 

requirements.txt

@@ -4,6 +4,6 @@ numpy>=2.0.0
 cfdm>=1.12.1.0, <1.12.2.0
 psutil>=0.6.0
 cfunits>=3.3.7
-dask>=2025.2.0,<=2025.3.0
+dask>=2025.5.1
 packaging>=20.0
 scipy>=1.10.0