Clisops

Bug fixes:
* Fix inconsistent bounds in metadata after subset operation (224).

Other Changes:
* Use ``roocs-utils`` 0.6.2 to avoid test failure (226).
* Removed unneeded testing dep from environment.yml (223).
* Merged pre-commit autoupdate (227).

New Features:
* ``clisops.ops.average.average_time`` and ``clisops.core.average.average_time`` added (211). Allowing averaging over time frequencies of day, month and year.
* New function ``create_time_bounds`` in ``clisops.utils.time_utils``, to generate time bounds for temporally averaged datasets.

* ``clisops`` now uses the `loguru <https://loguru.readthedocs.io/en/stable/index.html>`_ library as its primary logging engine (#216).

Other Changes:
* Pandas now pinned below version 1.4.0.
* Pre-commit configuration updated with code style conventions (black, pyupgrade) set to Python3.7+ (219).
* ``loguru`` is now an install dependency, with ``pytest-loguru`` as a development-only dependency.
* Added function to convert the longitude axis between different longitude frames (eg. [-180, 180] and [0, 360]) (217, 218).

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

New Features

* ``clisops.core.average.average_shape`` copies the global and variable attributes from the input data to the results.

Bug fixes

* ``average_shape`` and ``create_weight_masks`` were adapted to work with xESMF 0.6.2, while maintaining compatibility with earlier versions.
* Fix added to remove ``_FillValue`` added to coordinate variables and bounds by xarray when outputting to netCDF.

Other Changes

* Passing ``DataArray`` objects to ``clisops.core.average.average_shape`` is now deprecated. Averaging requires grid cell boundaries, which are not ``DataArray`` coordinates, but independent ``Dataset`` variables. Please pass ``Dataset`` objects and an optional list of variables to average.
* ``average_shape`` performs an initial subset over the averaging region, before computing the weights, to reduce memory usage.
* Minimum xesmf version set to 0.6.2.
* Minimum pygeos version set to 0.9.
* Replace ``cascaded_union`` by ``unary_union`` to anticipate a `shapely` deprecation.

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

Breaking Changes

* ``time`` input for ``time`` in ``ops.subset.subset`` but now be one of [<class 'roocs_utils.parameter.param_utils.Interval'>, <class 'roocs_utils.parameter.param_utils.Series'>, <class 'NoneType'>, <class 'str'>].
* ``level`` input for ``level`` in ``ops.subset.subset`` but now be one of [<class 'roocs_utils.parameter.param_utils.Interval'>, <class 'roocs_utils.parameter.param_utils.Series'>, <class 'NoneType'>, <class 'str'>].
* ``roocs-utils``>= 0.5.0 required.

New Features

* ``time_values`` and ``level_values`` arguments added to ``core.subset.subset_bbox`` which allows the user to provide a list of time/level values to select.
* ``subset_time_by_values`` and ``subset_level_by_values`` added to ``core.subset.subset_bbox``. These allow subsetting on sequence of datetimes or levels.
* ``subset_time_by_components`` added to ``core.subset.subset_bbox``. This allows subsetting by time components - year, month, day etc.
* ``check_levels_exist`` and ``check_datetimes_exist`` function checkers added in ``core.subset`` to check requested levels and datetimes exist. An exception is raised if they do not exist in the dataset.
* ``time_components`` argument added to ``ops.subset`` to allowing subsetting by time components such as year, month, day etc.

Other Changes

* Python 3.6 no longer tested in GitHub actions.

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

New Features
* New optional dependency ``PyGEOS``, when installed the performance of ``core.subset.create_mask`` and ``cure.subset.subset_shape`` are greatly improved.

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

Breaking Changes
* Exception raised in ``core.average.average_over_dims`` when dims is None.
* Exception raised in ``core.average.average_over_shape`` when grid and polygon have no overlapping values.

New Features
* ``ops.subset.subset`` now ensures all latitude and longitude bounds are in ascending order before passing to ``core.subset.subset_bbox``
* ``core.subset.subset_level`` now checks that the order of the bounds matches the order of the level data.
* ``core.subset._check_desc_coords`` now checks the bounds provided are ascending before flipping them.

Other Changes
* clisops logging no longer disables other loggers.
* GitHub CI now leverages ``tox`` for testing as well as tests averaging functions via a conda-based build.
* Added a CI build to run against xarraymaster that is allowed to fail.