3.15.1

2023-06-09

• New documentation cheat sheet (#591)
• Performance improvements to cf.aggregate (#640)
• New methods: cf.Data.argmin, cf.Field.argmin (#577)
• Deprecate cf.relative_vorticity in favour of cf.curl_xy (#643)
• Fix bug when using the -d option to the cfa script (#649)
• Fix the return tppe from cf.example_fields (#654)
• Fix set_data when the units are invalid (#646)
• Fix cf.Field.laplacian_xy, cf.Field.grad_xy, cf.curl_xy and cf.div_xy to work in cases when the dimension coordinates are missing standard names (#643)
• Changed dependency: cfunits>=3.3.6
• Changed dependency: cftime>=1.6.2

3.15.0

2023-04-27

• Re-introduction of CFA-netCDF functionality for CFA-0.6 (#451, #475, #637)
• New function: cf.CFA
• New method: cf.Data.get_cfa_write
• New method: cf.Data.set_cfa_write
• Fix excessive memory use arising from cf.Field.regrids and cf.Field.regridc (#623)
• Fixed bug in cf.Field.read when reading UM/PP data that are run-length encoded (#621)
• Fixed bug in cf.Field.compute_vertical_coordinates that retained incorrect bounds properties (#626)
• Removed benign UserWarning from cf.Field.percentile (#619)
• Handled the renaming of the ESMF Python interface from ESMF to esmpy at version 8.4.0. Both module names are accepted for now.
• Changed dependency: 1.10.1.0<=cfdm<1.10.2.0
• Changed (optional) dependency: 8.0.0<=esmpy
• Changed (optional) dependency: 1.10.0<=scipy

3.14.1

2023-03-10

• Python 3.7 support removed (#611)
• New method: cf.Field.del_properties (#598)
• New keyword parameter to cf.Data.concatenate: relaxed_units (#602)
• New keyword parameter to cf.unique_constructs: ignore_properties (#597)
• Allow cf.aggregate and to retain external cell measures (#605)
• Fixed bug in cf.Field.collapse that always retained invalid vertical coordinate reference systems (#599)
• Changed dependency: 1.10.0.3<=cfdm<1.10.1.0
• Changed dependency: cfunits>=3.3.5
• Changed dependency: 8.0.0<=ESMPYcfdm<8.2.0

3.14.0

2023-01-31

• Introduction of dask for all data manipulations, replacing the old LAMA methodology (e.g. #295, #428)
• Backwards incompatible API changes to facilitate the use of Dask (#579)
• New method: cf.Field.get_original_filenames (#448)
• New method: cf.Field.to_dask_array
• Fixed bug when reading UM stash codes that imply an area mean cell method (#487)
• New keyword parameter to cf.write: omit_data (#477)
• New keyword parameter to cf.read: chunks (#522)
• Extend functionality of cf.Data.roll and cf.Field.roll to allow multiple axes to be rolled simultaneously.
• Fixed bug that raised an exception when using the equal or exist keyword of cf.aggregate (#499)
• Fixed bug that created incorrect cyclic Voronoi bounds from DimensionCoordinate.create_bounds (#514)
• Changed dependency: 1.10.0.2<=cfdm<1.10.1.0
• New dependency: dask>=2022.12.1

3.13.1

2022-10-17

• Upgrade to allow cf to work with Python 3.10 (#419)
• Fix bug when setting coordinate bounds with different units to their parent coordinates (#417)
• Fixed bug that created incorrect hybrid height levels when reading UM fields that also have pseudolevels (#468)
• Fixed bug when reading zero length netCDF or PP files caused cf-python to hang (#422)
• Changed dependency: 1.9.0.4<=cfdm<1.9.1.0

3.13.0

2022-06-23

• Fix bug in cf.read when reading PP or fields files for which the um keyword has been set, but without the 'version' key (#306)
• Fix bug when setting the CFA "base" option to an empty string in cf.write (#346)
• Fixed failure from cf.write when writing identical (auxiliary) coordinates to different data variables in different groups (#336)
• Removed -g from the umread_lib/c-lib compiler options (#305)
• Updated the deprecated distutils.version to packaging.version (#324)
• Changed dependency: 1.9.0.3<=cfdm<1.9.1.0
• New dependency: packaging>=20.0

3.12.0

2022-01-18

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

3.11.0

2021-10-08

• Python 3.6 support removed (#208)
• Conversion of cf.Domain to a non-abstract that may be read from and written to a netCDF dataset (#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 (#220)
• New keyword parameter to cf.read: cdl_string (#171)
• Improved verbose information output from cf.aggregate (#228)
• Fix bug that causes a failure in cf.aggregate when otherwise aggregatable fields have non-valid units (#229)
• Fix for cf.aggregate failures when a datum or coordinate conversion parameter has an array value (#230)
• Allow for regridding using a destination field featuring size 1 dimension(s) (#250)
• Fix bug that sometimes caused cf.Field.autocyclic to fail when setting a construct that is cyclic and has a defined period (#237)
• Changed dependency: 1.9.0.0<=cfdm<1.9.1.0

3.10.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 (#222)
• Fix for incorrectly formatted logging.info statement sometimes causing a hang in cf.Field.collapse (#217)

3.9.0

2021-05-25

• Construct access API changes (#201, #202, #203, #204)
• Performance enhancements (#201, #202)
• New write mode mode='a' for appending to, rather than over-writing, a netCDF file on disk (#30)
• Temporarily removed the experimental ability to parallelize the collapse operation with MPI (#207)
• Improved docstrings
• Fix for unlimited dimensions read from a netCDF4 sub-group having zero size (NCAS-CMS/cfdm#113)
• Fixes for changes in behaviour in cftime==1.4.0 (#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 (#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