Cfdm

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

**2020-06-10**

* Fixed bug that prevented the reading of certain netCDF files, such
as those with at least one external variable.

----

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

**2020-06-08**

* Added new example field ``7`` to `cfdm.example_field`.
* Enabled configuration of the extent and nature of informational and
warning messages output by `cfdm` using a logging framework (see
points below) (https://github.com/NCAS-CMS/cfdm/issues/31)
* New function `cfdm.LOG_LEVEL` to set the minimum log level for which
messages are displayed globally, i.e. to change the project-wide
verbosity (https://github.com/NCAS-CMS/cfdm/issues/35).
* Changed behaviour and default of `verbose` keyword argument when
available to a function/method so it interfaces with the new logging
functionality (https://github.com/NCAS-CMS/cfdm/issues/35).
* Changed dependency: ``cftime>=1.1.3``
* Fixed bug the wouldn't allow the reading of a netCDF file which
specifies Conventions other than CF
(https://github.com/NCAS-CMS/cfdm/issues/36).

----

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

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

----