Cf-python

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

**2023-06-09**

* New documentation cheat sheet
(https://github.com/NCAS-CMS/cf-python/issues/591)
* Performance improvements to `cf.aggregate`
(https://github.com/NCAS-CMS/cf-python/issues/640)
* New methods: `cf.Data.argmin`, `cf.Field.argmin`
(https://github.com/NCAS-CMS/cf-python/issues/577)
* Deprecate `cf.relative_vorticity` in favour of `cf.curl_xy`
(https://github.com/NCAS-CMS/cf-python/pull/643)
* Fix bug when using the ``-d`` option to the `cfa` script
(https://github.com/NCAS-CMS/cf-python/issues/649)
* Fix the return type from `cf.example_fields`
(https://github.com/NCAS-CMS/cf-python/pull/654)
* Fix `set_data` when the units are invalid
(https://github.com/NCAS-CMS/cf-python/pull/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
(https://github.com/NCAS-CMS/cf-python/pull/643)
* Changed dependency: ``cfunits>=3.3.6``
* Changed dependency: ``cftime>=1.6.2``

----

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

**2023-04-27**

* Re-introduction of CFA-netCDF functionality for CFA-0.6
(https://github.com/NCAS-CMS/cf-python/issues/451,
https://github.com/NCAS-CMS/cf-python/issues/475,
https://github.com/NCAS-CMS/cf-python/issues/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`
(https://github.com/NCAS-CMS/cf-python/issues/623)
* Fixed bug in `cf.Field.read` when reading UM/PP data that are
run-length encoded
(https://github.com/NCAS-CMS/cf-python/issues/621)
* Fixed bug in `cf.Field.compute_vertical_coordinates` that retained
incorrect bounds properties
(https://github.com/NCAS-CMS/cf-python/issues/626)
* Removed benign UserWarning from `cf.Field.percentile`
(https://github.com/NCAS-CMS/cf-python/issues/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``

----

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

**2023-03-10**

* Python 3.7 support removed
(https://github.com/NCAS-CMS/cf-python/issues/611)
* New method: `cf.Field.del_properties`
(https://github.com/NCAS-CMS/cf-python/issues/598)
* New keyword parameter to `cf.Data.concatenate`: ``relaxed_units``
(https://github.com/NCAS-CMS/cf-python/issues/602)
* New keyword parameter to `cf.unique_constructs`:
``ignore_properties``
(https://github.com/NCAS-CMS/cf-python/issues/597)
* Allow `cf.aggregate` and to retain external cell measures
(https://github.com/NCAS-CMS/cf-python/issues/605)
* Fixed bug in `cf.Field.collapse` that always retained invalid
vertical coordinate reference systems
(https://github.com/NCAS-CMS/cf-python/issues/599)
* Changed dependency: ``1.10.0.3<=cfdm<1.10.1.0``
* Changed dependency: ``cfunits>=3.3.5``
* Changed dependency: ``8.0.0<=ESMPY<8.2.0``

----

* Push recent commits using

bash
git push origin main


* Tag the release:

bash
./tag <vn> E.g. ./tag 3.14.0


* Upload the source tarball to PyPI. Note this requires the `twine`
library (which can be installed via `pip`) and relevant project
privileges on PyPI.

bash
./upload_to_pypi <vn> E.g. ./upload_to_pypi 3.14.0


* Update the GitHub releases page for the new version:
https://github.com/NCAS-CMS/cf-python/releases

* Upload the new release to Zenodo: https://zenodo.org/record/3961353

* Copy the archive docs to https://github.com/NCAS-CMS/cf-python-docs

* Move and commit the previously-generated archived copy of the documentation to https://github.com/NCAS-CMS/cf-python-docs (fork or clone that repo first):

bash
mv docs/<vn>/ ~/cf-python-docs/
cd ~/cf-python-docs/
git add <vn>/
Then commit and push to the NCAS-CMS repo (named origin or upstream as appropriate)

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

**2022-10-17**

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

----

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

**2022-06-23**

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

----