Cf-python

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

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

----

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

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



!/bin/bash

--------------------------------------------------------------------
Install and run tests in ~/tmp
--------------------------------------------------------------------

set -x

if [[ ! $1 ]] ; then
echo "Must set version as \$1 (e.g. 3.10.0)"
exit 1
fi

vn=$1

dir=~/tmp/test_cf-python
rm -fr $dir

tar ztvf dist/cf-python-$vn.tar.gz

pip install dist/cf-python-$vn.tar.gz -t $dir --no-deps

export PYTHONPATH=$dir:$PYTHONPATH
export PATH=$dir/bin:$PATH

cd $dir/cf/test
ls -o

./individual_tests.sh
test_result_status=$?

set -x

exit $test_result_status

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

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

----