Xoa

==================

New features
------------
- :meth:`xoa.cf.CFSpecs.decode` better supports staggered grids.
- :meth:`xoa.cf.CFSpecs.search_dim` supports generic names in addition to dimension types as second argument.
- Add the :meth:`xoa.cf.CFSpecs.match_dim` method to check if a given dimension name is known.
- Add the :meth:`~xoa.cf.CFSpecs.reloc` and :meth:`~xoa.cf.CFSpecs.to_loc` methods to :class:`xoa.cf.CFSpecs` for quickly changing the staggered grid indicators in names.
- Add the :meth:`xoa.cf.SGLocator.add_loc` method to quickly change the location markers in a data array.

Breaking changes
----------------
- :func:`xoa.coords.get_dims` is renamed to :func:`xoa.coords.get_cf_dims`.
- The `name` argument of :class:`xoa.cf.CFSpecs` methods is renamed to `cf_name`, and the `dim_type(s)` argument is renamed to `cf_arg(s)`.
- :meth:`xoa.cf.SGLocator.get_location` is renamed to :meth:`~xoa.cf.SGLocator.get_loc_from_da` and the :meth:`~xoa.cf.SGLocator.get_loc` is added.

Bug fixes
---------
- Fix the output formatting of :func:`xoa.grid.dz2depth`.

Documentation
-------------
- The :ref:`uses.cf` section and :ref:`sphx_glr_examples_plot_hycom_gdp.py` example are adapted to reflect changes.

===================

New features
------------
- Add an `autolim` keyword to :func:`xoa.plot.plot_flow` to speedup the processing with cartopy maps.

Breaking changes
----------------
- Rename the `cf` and `sigma` keyword of :func:`xoa.register_accessors` respectively to `xcf` and `decode_sigma` to match the default name of accessors.
- Rename the `sigma` accessor to `decode_sigma`.

Bug fixes
---------
- Fix the access to the xoa executable on windows.
- Fix the minimal version for xarray [:pull:`23`].

Documentation
-------------
- Add a "How to start" section.
- Accessors are now documented separately with `sphinx-autosummary-accessors` [:pull:`20`].
- The Hycom-GDP example now uses :func:`xoa.plot.plot_flow`.

===================

New features
------------
- Add the :func:`xoa.plot.plot_flow` function [:pull:`9`].
- Improve :func:`xoa.coords.get_depth` so that it can compute depth from sigma coordinates or layer thinknesses [:pull:`8`].
- Add the :func:`xoa.dyn.flow2d` function [:pull:`7`].
- Add the :func:`xoa.regrid.extrap1d` function.
- Add the :func:`xoa.filter.erode_coast` function which is specialized version of the :func:`xoa.filter.erode_mask` for horizontal data.
- Add the :func:`xoa.coords.get_xdim`, :func:`~xoa.coords.get_ydim`, :func:`~xoa.coords.get_zdim`, :func:`~xoa.coords.get_tdim` and :func:`~xoa.coords.get_fdim` for quickly finding standard dimensions.

Bug fixes
---------
- Fix u and v CF config [:pull:`6`]

=====

New features
------------

Breaking changes
----------------

Deprecations
------------

Bug fixes
---------

Documentation
-------------