Pydaymet

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

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>`__.

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

Breaking Changes
~~~~~~~~~~~~~~~~
- Remove caching-related arguments from all functions since now they
can be set globally via three environmental variables:

* ``HYRIVER_CACHE_NAME``: Path to the caching SQLite database.
* ``HYRIVER_CACHE_EXPIRE``: Expiration time for cached requests in seconds.
* ``HYRIVER_CACHE_DISABLE``: Disable reading/writing from/to the cache file.

You can do this like so:

.. code-block:: python

import os

os.environ["HYRIVER_CACHE_NAME"] = "path/to/file.sqlite"
os.environ["HYRIVER_CACHE_EXPIRE"] = "3600"
os.environ["HYRIVER_CACHE_DISABLE"] = "true"

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

New Features
~~~~~~~~~~~~
- Add a new flag to both ``get_bycoords`` and ``get_bygeom`` functions
called ``snow`` which separates snow from the precipitation using
the `Martinez and Gupta (2010) <https://doi.org/10.1029/2009WR008294>`__ method.

Internal Changes
~~~~~~~~~~~~~~~~
- Add elevation data when computing PET regardless of the ``pet`` method.
- Match the chunk size of ``elevation`` with that of the climate data.
- Drop ``time`` dimension from ``elevation``, ``lon``, and ``lat`` variables.

Bug Fixes
~~~~~~~~~
- Fix a bug in setting dates for monthly timescales. For monthly timescale
Daymet calendar is at 15th or 16th of the month, so input dates need to be
adjusted accordingly.

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

Internal Changes
~~~~~~~~~~~~~~~~
- Clean up the PET computation functions' output by removing temporary
variables that are created during the computation.
- Add more attributes for ``elevation`` and ``pet`` variables.
- Add type checking with ``typeguard`` and fixed typing issues raised by
``typeguard``.
- Refactor ``show_versions`` to ensure getting correct versions of all
dependencies.

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

Internal Changes
~~~~~~~~~~~~~~~~
- Use the three new ``ar.retrieve_*`` functions instead of the old ``ar.retrieve``
function to improve type hinting and to make the API more consistent.