Cf-python

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

**2022-01-18**

* New method: `cf.Field.grad_xy`
(https://github.com/NCAS-CMS/cf-python/issues/292)
* New method: `cf.Field.laplacian_xy`
(https://github.com/NCAS-CMS/cf-python/issues/292)
* New function: `cf.div_xy`
(https://github.com/NCAS-CMS/cf-python/issues/292)
* New function: `cf.curl_xy`
(https://github.com/NCAS-CMS/cf-python/issues/292)
* Allow element-wise comparisons with `None` on `cf.Data` and
`cf.Field` objects (https://github.com/NCAS-CMS/cf-python/issues/281)
* Add missing closing parenthesis in `cf.Query` string representations
(https://github.com/NCAS-CMS/cf-python/issues/279)
* Fix `cf.aggregate` failures when using the ``dimension`` keyword
parameter (https://github.com/NCAS-CMS/cf-python/issues/283)
* Fix bug that raised error with subtraction of a `cf.TimeDuration`
(https://github.com/NCAS-CMS/cf-python/issues/287)
* Fix bug in `cf.Field.derivative` when wrapping with periodic
coordinates (https://github.com/NCAS-CMS/cf-python/issues/289)
* Changed dependency: ``1.9.0.1<=cfdm<1.9.1.0``
* Changed dependency: ``cfunits>=3.3.4``

----

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

**2021-10-08**

* Python 3.6 support removed
(https://github.com/NCAS-CMS/cf-python/issues/208)
* Conversion of `cf.Domain` to a non-abstract that may be read from
and written to a netCDF dataset
(https://github.com/NCAS-CMS/cf-python/issues/220)
* New method: `cf.Domain.creation_commands`
* New method: `cf.Domain.climatological_time_axes`
* New method: `cf.AuxiliaryCoordinate.del_climatology`
* New method: `cf.AuxiliaryCoordinate.get_climatology`
* New method: `cf.AuxiliaryCoordinate.is_climatology`
* New method: `cf.AuxiliaryCoordinate.set_climatology`
* New method: `cf.DimensionCoordinate.del_climatology`
* New method: `cf.DimensionCoordinate.get_climatology`
* New method: `cf.DimensionCoordinate.is_climatology`
* New method: `cf.DimensionCoordinate.set_climatology`
* New function: `cf.unique_constructs`
* New function: `cf.example_fields`
(https://github.com/NCAS-CMS/cf-python/issues/220)
* New keyword parameter to `cf.read`: ``cdl_string``
(https://github.com/NCAS-CMS/cf-python/issues/171)
* Improved verbose information output from `cf.aggregate`
(https://github.com/NCAS-CMS/cf-python/issues/228)
* Fix bug that causes a failure in `cf.aggregate` when otherwise
aggregatable fields have non-valid units
(https://github.com/NCAS-CMS/cf-python/issues/229)
* Fix for `cf.aggregate` failures when a datum or coordinate
conversion parameter has an array value
(https://github.com/NCAS-CMS/cf-python/issues/230)
* Allow for regridding using a destination field featuring size 1
dimension(s) (https://github.com/NCAS-CMS/cf-python/issues/250)
* Fix bug that sometimes caused `cf.Field.autocyclic` to fail when
setting a construct that is cyclic and has a defined period
* Fix bug that sometimes caused a failure when reading PP extra data
(https://github.com/NCAS-CMS/cf-python/issues/241)
* Changed dependency: ``1.9.0.0<=cfdm<1.9.1.0``

----

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

**2021-06-10**

* Improve performance by allowing a saved `RegridOperator` instance to
define the regrid operator in `cf.Field.regridc` and
`cf.Field.regrids` (https://github.com/NCAS-CMS/cf-python/issues/222)
* Fix for incorrectly formatted `logging.info` statement sometimes
causing a hang in `cf.Field.collapse`
(https://github.com/NCAS-CMS/cf-python/issues/217)

----

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

**2021-05-25**

* Construct access API changes
(https://github.com/NCAS-CMS/cf-python/issues/201,
https://github.com/NCAS-CMS/cf-python/issues/202,
https://github.com/NCAS-CMS/cf-python/issues/203,
https://github.com/NCAS-CMS/cf-python/issues/204)
* Performance enhancements
(https://github.com/NCAS-CMS/cf-python/issues/201,
https://github.com/NCAS-CMS/cf-python/issues/202)
* New write mode ``mode='a'`` for appending to, rather than over-writing,
a netCDF file on disk (https://github.com/NCAS-CMS/cf-python/issues/30)
* Temporarily removed the experimental ability to parallelise the
collapse operation with MPI
(https://github.com/NCAS-CMS/cf-python/issues/207)
* Improved docstrings
* Fix for unlimited dimensions read from a netCDF4 sub-group having
zero size (https://github.com/NCAS-CMS/cfdm/issues/113)
* Fixes for changes in behaviour in cftime==1.4.0
(https://github.com/NCAS-CMS/cf-python/issues/184)
* Better error message in the case of a `numpy.ma.core.MaskError` occurring
upon reading of CDL files with only header or coordinate information
(https://github.com/NCAS-CMS/cf-python/issues/197)
* Changed dependency: ``1.8.9.0<=cfdm<1.8.10.0``
* Changed dependency: ``cftime>=1.5.0``
* Changed dependency: ``cfunits>=3.3.3``
* Changed dependency: ``netCDF4>=1.5.4``

----

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

**2020-12-18**

* The setting of global constants can now be controlled by a context
manager (https://github.com/NCAS-CMS/cf-python/issues/154)
* Changed the behaviour of binary operations for constructs that have
bounds (https://github.com/NCAS-CMS/cf-python/issues/146)
* Changed the behaviour of unary operations for constructs that have
bounds (https://github.com/NCAS-CMS/cf-python/issues/147)
* New function: `cf.bounds_combination_mode`
(https://github.com/NCAS-CMS/cf-python/issues/146)
* New method: `cf.Field.compute_vertical_coordinates`
(https://github.com/NCAS-CMS/cf-python/issues/142)
* Fixed bug that prevented the verbosity from changing to any value
specified as a ``verbose`` keyword parameter to `cf.aggregate` (only).
* Fixed bug that caused a failure when writing a dataset that contains
a scalar domain ancillary construct
(https://github.com/NCAS-CMS/cf-python/issues/152)
* Fixed bug that prevented aggregation of fields with external cell measures
(https://github.com/NCAS-CMS/cf-python/issues/150#issuecomment-729747867)
* Fixed bug that caused rows full of zeros to appear in WGDOS packed
UM data that contain masked points
(https://github.com/NCAS-CMS/cf-python/issues/161)
* Changed dependency: ``1.8.8.0<=cfdm<1.8.9.0``
* Changed dependency: ``cftime>=1.3.0``
* Changed dependency: ``cfunits>=3.3.1``

----

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

**2020-10-15**

* Python 3.5 support deprecated (3.5 was retired on 2020-09-13)
* New method: `cf.Field.del_domain_axis`
* New method: `cf.Field._docstring_special_substitutions`
* New method: `cf.Field._docstring_substitutions`
* New method: `cf.Field._docstring_package_depth`
* New method: `cf.Field._docstring_method_exclusions`
* New keyword parameter to `cf.Field.set_data`: ``inplace``
* New keyword parameter to `cf.write`: ``coordinates``
(https://github.com/NCAS-CMS/cf-python/issues/125)
* New keyword parameter to `cf.aggregate`: ``ignore``
(https://github.com/NCAS-CMS/cf-python/issues/115)
* Fixed bug that caused a failure when reading a dataset with
incompatible bounds units. Now a warning is given (controllable by
the logging level) and the offending bounds are returned as a
separate field construct.
* Fixed bug in `cf.aggregate` that caused it to error if either the
`equal_all` or `exist_all` parameter were set to `True`.
* Fixed bug in `Data.percentile` that caused it to error for non-singular
ranks if the squeeze parameter was set to `True`.
* ``cfa`` now prints error messages to the stderr stream rather than
stdout.
* Changed dependency: ``1.8.7.0<=cfdm<1.8.8.0``
* Changed dependency: ``cfunits>=3.3.0``

----