Cfdm

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

**2020-04-30**

* `cfdm.Field.apply_masking` now masks metadata constructs.
* New method: `cfdm.Field.get_filenames`
* New method: `cfdm.Data.get_filenames`
* New function: `cfdm.abspath`
* New keyword parameter to `cfdm.read`: ``warn_valid``
(https://github.com/NCAS-CMS/cfdm/issues/30)
* New keyword parameter to `cfdm.write`: ``warn_valid``
(https://github.com/NCAS-CMS/cfdm/issues/30)


----

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

**2020-04-24**

* Added time coordinate bounds to the polygon geometry example field
``6`` returned by `cfdm.example_field`.
* New method: `cfdm.Field.apply_masking`
* New method: `cfdm.Data.apply_masking`
* New keyword parameter to `cfdm.read`: ``mask``
* New keyword parameter to `cfdm.Field.nc_global_attributes`:
``values``
* Fixed bug in `cfdm.write` that caused (what are effectively)
string-valued scalar auxiliary coordinates to not be written to disk
as such, or even an exception to be raised.

----

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

**2020-04-16**

* Improved source code highlighting in links from the documentation
(https://github.com/NCAS-CMS/cfdm/issues/21).
* Fixed bug that erroneously required netCDF geometry container
variables to have a ``geometry_dimension`` netCDF attribute.

----

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

**2020-03-23**

* First release for CF-1.8 (does not include netCDF hierarchical
groups functionality).
* Implementation of simple geometries for CF-1.8
(https://github.com/NCAS-CMS/cfdm/issues/11).
* Implementing of string data-types for CF-1.8
(https://github.com/NCAS-CMS/cfdm/issues/12).
* New function: `cfdm.example_field`
(https://github.com/NCAS-CMS/cfdm/issues/18)
* New attributes: `cfdm.Field.dtype`, `cfdm.Field.ndim`,
`cfdm.Field.shape`, `cfdm.Field.size`
* New method: `cfdm.Data.any`
* New ``paths`` keyword parameter to `cfdm.environment`
* Changed dependency: ``netCDF4>=1.5.3``
* Changed dependency: ``cftime>=1.1.1``
* Fixed bug that prevented the writing of ``'NETCDF3_64BIT_OFFSET'``
and ``'NETCDF3_64BIT_DATA'`` format files
(https://github.com/NCAS-CMS/cfdm/issues/9).
* Fixed bug that caused a failure when a "_FillValue" or
"missing_value" property is set and data type conversions are
specified with the ``datatype`` keyword to `cfdm.write`
(https://github.com/NCAS-CMS/cfdm/issues/16).
* Fixed bug whereby `cfdm.Field.has_construct` would try to delete the
construct rather than check whether it existed.

----

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

**2019-11-27**

* New methods: `cfdm.Field.compress`, `cfdm.Field.uncompress`
* New methods: `cfdm.Data.flatten`, `cfdm.Data.uncompress`
* New ``dtype`` and ``mask`` keyword parameters to `cfdm.Data`
* Changed the default value of the ``ignore_compression`` parameter to
`True`.

----

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

**2019-11-14**

* New method: `cfdm.Field.nc_set_global_attributes`.
* Fixed bug relating to the reading of some CDL files
(https://github.com/NCAS-CMS/cfdm/issues/5).
* Fixed bug relating numpy warning when printing a field with masked
reference time values (https://github.com/NCAS-CMS/cfdm/issues/8).

----