Pygeohydro

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

New Features
~~~~~~~~~~~~
- Add support for the
`Water Quality Portal <http://www.waterqualitydata.us>`__ Web Services. (:issue_hydro:`72`)
- Add support for two versions of NID web service. The original NID web service is considered
version 2 and the new NID is considered version 3. You can pass the version number to the
``NID`` like so ``NID(2)``. The default version is 2.

Bug Fixes
~~~~~~~~~
- Fix an issue with background percentage calculation in ``cover_statistics``.

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

New Features
~~~~~~~~~~~~
- Add a `new <https://ags03.sec.usace.army.mil/server/rest/services/Dams_Public/MapServer/0>`__
map service for National Inventory of Dams (NID).

Internal Changes
~~~~~~~~~~~~~~~~
- Use ``importlib-metadata`` for getting the version instead of ``pkg_resources``
to decrease import time as discussed in this
`issue <https://github.com/pydata/xarray/issues/5676>`__.

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

Bug Fixes
~~~~~~~~~
- Refactor ``cover_statistics`` to address an issue with wrong category names and also
improve performance for large datasets by using ``numpy``'s functions.
- Fix an issue with detecting wrong number of stations in ``NWIS.get_streamflow``.
Also, improve filtering stations that their start/end date don't match the user requested
interval.

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

The highlight of this release is adding support for NLCD 2019 and significant improvements
in NWIS support.

New Features
~~~~~~~~~~~~
- Add support for the recently released version of NLCD (2019), including the impervious
descriptor layer. Highlights of the new database are:

NLCD 2019 now offers land cover for years 2001, 2004, 2006, 2008, 2011, 2013, 2016, 2019,
and impervious surface and impervious descriptor products now updated to match each date
of land cover. These products update all previously released versions of land cover and
impervious products for CONUS (NLCD 2001, NLCD 2006, NLCD 2011, NLCD 2016) and are not
directly comparable to previous products. NLCD 2019 land cover and impervious surface product
versions of previous dates must be downloaded for proper comparison. NLCD 2019 also offers an
impervious surface descriptor product that identifies the type of each impervious surface pixel.
This product identifies types of roads, wind tower sites, building locations, and energy
production sites to allow deeper analysis of developed features.

-- `MRLC <https://www.mrlc.gov>`__

- Add support for all the supported regions of NLCD database (CONUS, AK, HI, and PR).
- Add support for passing multiple years to the NLCD function, like so ``{"cover": [2016, 2019]}``.
- Add ``plot.descriptor_legends`` function to plot the legend for the impervious descriptor layer.
- New features in ``NWIS`` class are:

* Remove ``query_*`` methods since it's not convenient to pass them directly as a dictionary.
* Add a new function called ``get_parameter_codes`` to query parameters and get information
about them.
* To decrease complexity of ``get_streamflow`` method add a new private function to handle
some tasks.
* For handling more of NWIS's services make ``retrieve_rdb`` more general.

- Add a new argument called ``nwis_kwds`` to ``interactive_map`` so any NWIS
specific keywords can be passed for filtering stations.
- Improve exception handling in ``get_info`` method and simplify and improve
its performance for getting HCDN.

Internal Changes
~~~~~~~~~~~~~~~~
- Migrate to using ``AsyncRetriever`` for handling communications with web services.

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

Breaking Changes
~~~~~~~~~~~~~~~~
- Drop support for Python 3.6 since many of the dependencies such as ``xarray`` and ``pandas``
have done so.
- Remove ``get_nid`` and ``get_nid_codes`` functions since NID now has a ArcGISRESTFul service.

New Features
~~~~~~~~~~~~
- Add a new class called ``NID`` for accessing the recently released National Inventory of Dams
web service. This service is based on ArcGIS's RESTful service. So now the user just need to
instantiate the class like so ``NID()`` and with three methods of ``AGRBase`` class, the
user can retrieve the data. These methods are: ``bygeom``, ``byids``, and ``bysql``. Moreover,
it has a ``attrs`` property that includes descriptions of the database fields with their units.
- Refactor ``NWIS.get_info`` to be more generic by accepting any valid queries that are
documented at
`USGS Site Web Service <https://waterservices.usgs.gov/rest/Site-Service.html#outputDataTypeCd>`__.
- Allow for passing a list of queries to ``NWIS.get_info`` and use ``async_retriever`` that
significantly improves the network response time.
- Add two new flags to ``interactive_map`` for limiting the stations to those with
daily values (``dv=True``) and/or instantaneous values (``iv=True``). This function
now includes a link to stations webpage on USGS website.

Internal Changes
~~~~~~~~~~~~~~~~
- Use persistent caching for all send/receive requests that can significantly improve the
network response time.
- Explicitly include all the hard dependencies in ``setup.cfg``.
- Refactor ``interactive_map`` and ``NWIS.get_info`` to make them more efficient and reduce
their code complexity.

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

Internal Changes
~~~~~~~~~~~~~~~~
- Add announcement regarding the new name for the software stack, HyRiver.
- Improve ``pip`` installation and release workflow.