Pydaymet

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

**Since the release of Daymet v4 R1 on November 2022, the URL of Daymet's server has
been changed. Therefore, only PyDaymet v0.13.7+ is going to work, and previous
versions will not work anymore.**

New Features
~~~~~~~~~~~~
- Add support for passing a list of coordinates to the ``get_bycoords`` function.
Also, optionally, you can pass a list of IDs for the input coordinates that
will be used as ``keys`` for the returned ``pandas.DataFrame`` or a dimension
called ``id`` in the returned ``xarray.Dataset`` if ``to_xarray`` is enabled.
- Add a new argument called ``to_xarray`` to the ``get_bycoords`` function for
returning the results as a ``xarray.Dataset`` instead of a ``pandas.DataFrame``.
When set to ``True``, the returned ``xarray.Dataset`` will have three attributes
called ``units``, ``description``, and ``long_name``.
- The ``date`` argument of both ``get_bycoords`` and ``by_geom`` functions
now accepts ``range``-type objects for passing years, e.g., ``range(2000-2005)``.

.. code-block:: python

import pydaymet as daymet

coords = [(-94.986, 29.973), (-95.478, 30.134)]
idx = ["P1", "P2"]
clm = daymet.get_bycoords(coords, range(2000, 2021), coords_id=idx, to_xarray=True)

Internal Changes
~~~~~~~~~~~~~~~~
- Use ``pyupgrade`` package to update the type hinting annotations
to Python 3.10 style.
- Fix the Daymet server URL.

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

Internal Changes
~~~~~~~~~~~~~~~~
- Add the missing PyPi classifiers for the supported Python versions.

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

Breaking Changes
~~~~~~~~~~~~~~~~
- Append "Error" to all exception classes for conforming to PEP-8 naming conventions.

Internal Changes
~~~~~~~~~~~~~~~~
- Bump the minimum versions of ``pygeoogc``, ``pygeoutils``, ``py3dep`` to 0.13.5 and
that of ``async-retriever`` to 0.3.5.

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

Bug Fixes
~~~~~~~~~
- Fix a bug in ``PETGridded`` where the wrong data type was being set for
``pet`` and ``elevation`` variables.
- When initializing ``PETGridded``, only chunk the elevation if the input
climate data is chunked.

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

Breaking Changes
~~~~~~~~~~~~~~~~
- Set the minimum supported version of Python to 3.8 since many of the
dependencies such as ``xarray``, ``pandas``, ``rioxarray`` have dropped support
for Python 3.7.

Internal Changes
~~~~~~~~~~~~~~~~
- Use `micromamba <https://github.com/marketplace/actions/provision-with-micromamba>`__
for running tests
and use `nox <https://github.com/marketplace/actions/setup-nox>`__
for linting in CI.

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

New Features
~~~~~~~~~~~~
- Adopt the default snow parameters' values from a new source
https://doi.org/10.5194/gmd-11-1077-2018 and add the citation.

Bug Fixes
~~~~~~~~~
- Set the end year based on the current year since Daymet data get updated
every year (:pull_day:`55`) by `Tim Cera <https://github.com/timcera>`__.
- Set the months for the annual timescale to correct values (:pull_day:`55`)
by `Tim Cera <https://github.com/timcera>`__.