Cf-python

--------------

**2025-01-28**

* Allow ``'nearest_dtos'`` 2-d regridding to work with discrete
sampling geometry source grids
(https://github.com/NCAS-CMS/cf-python/issues/832)
* New method: `cf.Field.filled`
(https://github.com/NCAS-CMS/cf-python/issues/811)
* New method: `cf.Field.is_discrete_axis`
(https://github.com/NCAS-CMS/cf-python/issues/784)
* Include the UM version as a field property when reading UM files
(https://github.com/NCAS-CMS/cf-python/issues/777)
* Fix bug that caused climatological time collapses within/over days
to fail (https://github.com/NCAS-CMS/cf-python/issues/809)
* New keyword parameter to `cf.Field.derivative`:
``ignore_coordinate_units``
(https://github.com/NCAS-CMS/cf-python/issues/807)
* Allow access to netCDF-4 files in S3 object stores
(https://github.com/NCAS-CMS/cf-python/issues/712)
* New class `cf.H5netcdfArray`
* New class `cf.NetCDF4Array`
* New class `cf.CFAH5netcdfArray`
* New class `cf.CFANetCDF4Array`
* Replace core `dask` functionality with that imported from `cfdm`
(https://github.com/NCAS-CMS/cf-python/issues/839)
* Fix bug that sometimes puts an incorrect ``radian-1`` or
``radian-2`` in the returned units of the differential operator
methods and functions
(https://github.com/NCAS-CMS/cf-python/issues/807)
* Fix bug where `cf.example_fields` returned a `list` of Fields rather
than a `Fieldlist`
(https://github.com/NCAS-CMS/cf-python/issues/725)
* Fix bug where combining UGRID fields erroneously creates an extra
axis and broadcasts over it
(https://github.com/NCAS-CMS/cf-python/issues/784)
* Fix bug where `cf.normalize_slice` doesn't correctly
handle certain cyclic slices
(https://github.com/NCAS-CMS/cf-python/issues/774)
* Fix bug where `cf.Field.subspace` doesn't always correctly handle
global or near-global cyclic subspaces
(https://github.com/NCAS-CMS/cf-python/issues/828)
* New dependency: ``h5netcdf>=1.3.0``
* New dependency: ``h5py>=3.10.0``
* New dependency: ``s3fs>=2024.6.0``
* Changed dependency: ``numpy>=1.15,<2.0``
* Changed dependency: ``1.11.2.0<=cfdm<1.11.3.0``
* Changed dependency: ``cfunits>=3.3.7``
* Changed dependency: ``dask>=2024.6.0,<=2024.7.1``

----

--------------

**2024-04-26**

* Improve the performance of reading and accessing the data of PP and
UM fields files (https://github.com/NCAS-CMS/cf-python/issues/746)
* Improve `cf.Field.collapse` performance by lazily computing reduced
axis coordinates (https://github.com/NCAS-CMS/cf-python/issues/741)
* Improve `cf.Field.__getitem__` performance by not re-calculating
axis cyclicity (https://github.com/NCAS-CMS/cf-python/issues/744)
* Reduce output CFA netCDF file size by setting the HDF5 chunksizes of
CFA variables to be no larger than required
(https://github.com/NCAS-CMS/cf-python/issues/739)
* Allow a halo to be added by `cf.Field.indices` and
`cf.Field.subspace`
(https://github.com/NCAS-CMS/cf-python/issues/759)
* Added spherical regridding to discrete sampling geometry destination
grids (https://github.com/NCAS-CMS/cf-python/issues/716)
* Added 3-d spherical regridding to `cf.Field.regrids`, and the option
to regrid the vertical axis in logarithmic coordinates to
`cf.Field.regrids` and `cf.Field.regridc`
(https://github.com/NCAS-CMS/cf-python/issues/715)
* New keyword parameter to `cf.Field.regrids` and `cf.Field.regridc`:
``return_esmpy_regrid_operator``
(https://github.com/NCAS-CMS/cf-python/issues/766)
* New keyword parameters to `cf.wi`: ``open_lower`` and ``open_upper``
(https://github.com/NCAS-CMS/cf-python/issues/740)
* Fix misleading error message when it is not possible to create area
weights requested from `cf.Field.collapse`
(https://github.com/NCAS-CMS/cf-python/issues/731)
* Fix bug in `cf.read` when reading UM files that caused LBPROC value
131072 (Mean over an ensemble of parallel runs) to be ignored
(https://github.com/NCAS-CMS/cf-python/issues/737)
* Fix bug in `cf.aggregate` that sometimes put a null transpose
operation into the Dask graph when one was not needed
(https://github.com/NCAS-CMS/cf-python/issues/754)
* Fix bug in `cf.aggregate` that caused a failure when property values
were `numpy` arrays with two or more elements
(https://github.com/NCAS-CMS/cf-python/issues/764)
* Fix bug in `cf.aggregate` that didn't correctly handle the
"actual_range" CF attribute
(https://github.com/NCAS-CMS/cf-python/issues/764)
* Fix bug whereby `Field.cyclic` is not updated after a
`Field.del_construct` operation
(https://github.com/NCAS-CMS/cf-python/issues/758)
* Fix bug that meant `cyclic()` always returned an empty
set for domains produced by `cf.Field.domain`
(https://github.com/NCAS-CMS/cf-python/issues/762)
* Changed dependency: ``cfunits>=3.3.7``
* Changed dependency: ``netCDF4>=1.6.5``

----

--------------

**2024-03-01**

* Allow DSG trajectories with identical `trajectory_id` values to be
aggregated (https://github.com/NCAS-CMS/cf-python/issues/723)
* New methods: `cf.Field.pad_missing` and `cf.Data.pad_missing`
(https://github.com/NCAS-CMS/cf-python/issues/717)
* Fix occasional bug when calculating UGRID cell areas when
non-spatial coordinates span the discrete axis
(https://github.com/NCAS-CMS/cf-python/issues/721)
* New keyword parameter to `cf.Field.insert_dimension`:
``constructs`` (https://github.com/NCAS-CMS/cf-python/issues/719)
* Added the ``cell_measures`` and ``coordinates`` keyword arguments to
`cf.Field.weights`
(https://github.com/NCAS-CMS/cf-python/issues/709)
* Added the ``cell_measures``, ``coordinates``,
``return_cell_measure``, and ``methods`` keyword arguments to
`cf.Field.cell_area`
(https://github.com/NCAS-CMS/cf-python/issues/709)
* Allow `cf.Data` to be initialised with `xarray.DataAarray`
(https://github.com/NCAS-CMS/cf-python/issues/706)
* Fix bug that caused `cf.Field.del_file_location` to fail when
updating its metadata constructs
(https://github.com/NCAS-CMS/cf-python/issues/707)
* Fix bug that caused incorrect data arrays in some cyclic subspaces
created by `cf.Field.subspace` and `cf.Field.__getitem__`
(https://github.com/NCAS-CMS/cf-python/issues/713)
* Changed dependency: ``1.11.1.0<=cfdm<1.11.2.0``

----

--------------

**2023-12-06**

* Implemented the reading and manipulation of UGRID mesh topologies
(https://github.com/NCAS-CMS/cf-python/issues/696)
* New methods: `cf.Field.cell_connectivity`,
`cf.Field.cell_connectivities`
(https://github.com/NCAS-CMS/cf-python/issues/696)
* New methods: `cf.Field.domain_topology`,
`cf.Field.domain_topologies`
(https://github.com/NCAS-CMS/cf-python/issues/696)
* New method: `cf.Data.masked_values`
(https://github.com/NCAS-CMS/cf-python/issues/696)
* New method: `cf.Data.arctan2`
(https://github.com/NCAS-CMS/cf-python/issues/38)
* Fix bug that caused `cf.Field.collapse` to give incorrect results
for the "sum", "sum_of_weights" and "sum_of_weights2" methods, only
in the case that weights have been requested
(https://github.com/NCAS-CMS/cf-python/issues/701)
* Changed dependency: ``1.11.0.0<=cfdm<1.11.1.0``
* New dependency: ``scipy>=1.10.0``

----

--------------

**2023-10-10**

* Record dimension coordinate cell characteristics
(https://github.com/NCAS-CMS/cf-python/issues/692)
* New set of methods to query, set, del, and `get_cell_characteristics`
* Fix bug in `cf.Field.match_by_construct` that always returned True for
1-d constructs whose axis is not in the data, even when the
criterion was not matched
(https://github.com/NCAS-CMS/cf-python/issues/691)
* Fix bug that prevented "https://" netCDF files from being read
(https://github.com/NCAS-CMS/cf-python/issues/699)

----

--------------

**2023-08-31**

* Prevent unlimited dimensions from being written to CFA-netCDF files
(https://github.com/NCAS-CMS/cf-python/issues/689)