Roocs-utils

-------------------
Bug Fixes
^^^^^^^^^
* Fixed ``get_coords_by_type`` in ``xarray_utils`` to handle non existing coords (99).

-------------------
Bug Fixes
^^^^^^^^^
* Added data_node_root in ``roocs.ini`` for C3S-CORDEX and C3S-CMIP5 (97).

-------------------
Bug Fixes
^^^^^^^^^
* Updated default ``roocs.ini`` for C3S-CORDEX (93, 95).
* Fix added for `get_bbox <https://github.com/roocs/catalog-maker/issues/11>`_ on C3S-CORDEX (#94).

-------------------
Bug Fixes
^^^^^^^^^
* When a project was provided to ``roocs_utils.project_utils.DatasetMapper``, getting the base directory would be skipped, causing an error. This has been resolved.
* ``roocs_utils.project_utils.DatasetMapper`` can now accept `fixed_path_mappings` that include ".gz" (gzip) files. This is allowed because `Xarray` can read gzipped `netCDF` files.

Breaking Changes
^^^^^^^^^^^^^^^^
* Intake catalog maker removed, now in it's own package: `roocs/catalog-maker <https://github.com/roocs/catalog-maker>`_
* Change to input parameter classes::
* Added: ``roocs_utils.parameter.time_components_parameter.TimeComponentsParameter``
* Modified input types required for classes::
* ``roocs_utils.parameter.time_parameter.TimeParameter``
* ``roocs_utils.parameter.level_parameter.LevelParameter``
* They both now require their inputs to be one of::
* ``roocs_utils.parameter.param_utils.Interval`` - to specify a range/interval
* ``roocs_utils.parameter.param_utils.Series`` - to specify a series of values

New Features
^^^^^^^^^^^^
* ``roocs_utils.xarray_utils.xarray_utils`` now accepts keyword arguments to pass through to xarray's ``open_dataset`` or ``open_mfdataset``. If the argument provided is not an option for ``open_dataset``, then ``open_mfdataset`` will be used, even for one file.
* The `roocs.ini` config file can now accept `fixed_path_modifiers` to work together with the `fixed_path_mappings` section. For example, you can specify parameters in the modifiers that will be expanded into the mappings::

fixed_path_modifiers =
variable:cld dtr frs pet pre tmn tmp tmx vap wet
fixed_path_mappings =
cru_ts.4.04.{variable}:cru_ts_4.04/data/{variable}/*.nc
cru_ts.4.05.{variable}:cru_ts_4.05/data/{variable}/cru_ts4.05.1901.2*.{variable}.dat.nc.gz

In this example, the `variable` parameter will be expanded out to each of the options provided in the list.
* The ``roocs_utils.xarray_utils.xarray_utils.open_xr_dataset()`` function was improved so that the time units of the first data file are preserved in: ``ds.time.encoding["units"]``. A multi-file dataset has now keeps the time "units" of the first file (if present). This is useful for converting to other formats (e.g. CSV).

Other Changes
^^^^^^^^^^^^^
* Python 3.6 no longer tested in GitHub actions.

-------------------
Breaking Changes
^^^^^^^^^^^^^^^^
* Remove abcunit-backend and psycopg2 dependencies from requirements.txt, these must now be manually installed in order to use the catalog maker.

-------------------
Breaking Changes
^^^^^^^^^^^^^^^^
* Inventory maker now removed and replaced by intake catalog maker which writes a csv file with the dataset entries and a yaml description file.
* In ``etc/roocs.ini`` the option ``use_inventory`` has been replaced by ``use_catalog`` and the inventory maker options have been replaced with equivalent catalog options. However, the option to include file paths or not no longer exists.
* The catalog maker now uses a database backend and creates a csv file so there are 3 new dependencies for the catalog maker: pandas and abcunit-backend and psycopg2.
This means a database backend must be specified and the paths for the pickle files in ``etc/roocs.ini`` are no longer necessary. For more information see the README.

Other Changes
^^^^^^^^^^^^^
* oyaml removed as a dependency