Cf-python

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

**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)

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

**2023-07-21**

* Performance improvements to `cf.Field.regrids` and
`cf.Field.regridc`
(https://github.com/NCAS-CMS/cf-python/issues/675)
* Performance improvements to `cf.read` when reading datasets with
compression-by-convention
(https://github.com/NCAS-CMS/cf-python/pull/671)
* New keyword parameter to `cf.Field.regrids` and `cf.Field.regridc`:
``weights_file`` (https://github.com/NCAS-CMS/cf-python/issues/675)
* New keyword parameter to `cf.aggregate`: ``cells``
(https://github.com/NCAS-CMS/cf-python/issues/452)
* New function: `cf.isclose`
(https://github.com/NCAS-CMS/cf-python/issues/661)
* Allow `cf.Data` and other objects that have data (such as
`cf.DimensionCoordinate`) to be used as indices
(https://github.com/NCAS-CMS/cf-python/issues/677)
* Fix bug that caused `cf.Field.regrids` and `cf.Field.regridc` to
fail when the regrid axes are chunked with more than one chunk
(https://github.com/NCAS-CMS/cf-python/issues/665)
* Fix bug that caused `cf.read` to fail for some PP data with a single
vertical level (https://github.com/NCAS-CMS/cf-python/issues/667)
* Changed dependency: ``1.10.1.1<=cfdm<1.10.2.0``

----