Wavespectra

__________________


New Features
------------
* New method to construct spectra from NDBC buoy data (`PR17 <https://github.com/wavespectra/wavespectra/pull/17>`_).
* New method to output spectra in native WW3 format.

Bug Fixes
---------
* Fix bug with selecting circular longitudes in different conventions (`GH20 <https://github.com/wavespectra/wavespectra/issues/20>`_).
* Ensure directions in coming-from convention in read_era5 (`PR18 <https://github.com/wavespectra/wavespectra/pull/18>`_).
* Fix radian convertions in read_era5 (`PR19 <https://github.com/wavespectra/wavespectra/pull/19>`_).
* Fix coordinate values assignment errors with xarray>=0.15.1 (`GH16 <https://github.com/wavespectra/wavespectra/issues/16>`_).
* Ensure coordinates attributes are kept with certain readers.

deprecation
-----------
* Deprecated legacy `read_ww3_msl` reader.
* Deprecated `read_dictionary` in favour of using xarray's `to_dict`_ and `from_dict`_ methods.

.. _`to_dict`: http://xarray.pydata.org/en/stable/generated/xarray.DataArray.to_dict.html
.. _`from_dict`: http://xarray.pydata.org/en/stable/generated/xarray.DataArray.from_dict.html


Internal Changes
----------------
* Remove curly brackets from units.
* Remove original variable attributes from files hidden with underscores (`_units` and `_variable_name`).
* Remove xarray version limitation to <0.15.0.

__________________

Fix xarray version until breaking changes with 0.15.1 are taken care of.

Bug Fixes
---------
* Avoid index duplication when merging datasets in to_octopus function.

Internal Changes
----------------
* Fix xarray at 0.15.0 for now as 0.15.1 introduces many breaking changes.

__________________


New Features
------------
* New method `read_era5`_ to read spectra in ERA5 format by `John Harrington`_.
* New method `read_wavespectra`_ to read files already in wavespectra convention.

.. _`read_era5`: https://github.com/wavespectra/wavespectra/blob/master/wavespectra/input/era5.py
.. _`read_wavespectra`: https://github.com/wavespectra/wavespectra/blob/master/wavespectra/input/wavespectra.py
.. _`John Harrington`: https://github.com/JohnCHarrington

__________________


Bug Fixes
---------
* Import accessors within try block in __init__.py so install won't break.

Internal Changes
----------------
* Implemented coveralls.
* Added some more tests.

__________________

**The first PyPI release from new** `wavespectra`_ **github organisation.**

Breaking Changes
----------------
* Drop support for Python 2.
* Drop support for Python < 3.6.

New Features
------------
* Add method in SpecDataset accessor to plot polar wave spectra, api borrowed from `xarray`_.
* New `sel` method in SpecDataset accessor to select sites using different methods.
* Support for `zarr`_ wave spectra datasets from either local or remote sources.
* New `read_spotter` function to read spectra from Spotter file format, currently only reading as 1D.
* Add `read_dataset` function to convert existing dataset from unknown file into SpecDataset.
* Python Notebooks split into a new `notebooks`_ repository within the `wavespectra`_ organisation.
* New branch `pure-python`_ with fortran watershed algorithm replaced by python. This code is ~3x slower
than the fortran one but it is easier to install particularly if the system does not have fortran
compiler. We will make an effort to keep this branch in sync with Master.
* Redefined autodocs.

.. _`pure-python`: https://github.com/wavespectra/wavespectra/tree/pure-python

Bug Fixes
---------
* Consolidate history to link to github commits from all contributors.
* Fix error in `partition` with dask array not supportting item assignment.
* Fix docs building, currently working from `pure-python` branch due to gfortran dependency.

Internal Changes
----------------
* Decouple file reading from accessor definition in input functions so existing datasets can be converted.
* Compute method `_twod` lazily.
* Replace drop calls to fix deprecation warnings.
* Consolidate changelog in history file.
* Building with travis and tox.
* Adopt `black`_ code formatting.
* Set up flake8.

__________________

**The last PyPI release from old metocean github organisation.**

New Features
------------
* Add support to Python 3.