Pygeohydro

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

New Features
~~~~~~~~~~~~
- Add a two new function for retrieving soil properties across the US:

* ``soil_properties``: Porosity, available water capacity, and field capacity,
* ``soil_gnatsgo``: Soil properties from the gNATSGO database.

- Add a new help function called ``state_lookup_table`` for getting
a lookup table of US states and their counties. This can be particularly
useful for mapping the digit ``state_cd`` and ``county_cd`` that NWIS
returns to state names/codes.
- Add support for getting individual state geometries using ``get_us_states``
function by passing their two letter state code. Also, use TIGER 2022
data for the US states and counties instead of TIGER 2021.

Internal Changes
~~~~~~~~~~~~~~~~
- Remove ``proplot`` as a dependency and use ``matplotlib`` instead.

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

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.
- Deprecate ``ssebopeta_byloc`` since it's been replaced with ``ssebopeta_bycoords``
since version 0.13.0.

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

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

New Features
~~~~~~~~~~~~
- Add a new argument to ``NID.inventory_byid`` class for staging the entire NID dataset
prior to inventory queries. There a new public method called ``NID.stage_nid_inventory``
that can be used to download the entire NID dataset and save it as a ``feather`` file.
This is useful inventory queries with large number of IDs and is much more efficient
than querying the NID web service.

Bug Fixes
~~~~~~~~~
- The background value in ``cover_statistics`` function should have been 127 not 0.
Also, dropped the background value from the return statistics.

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

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
~~~~~~~~~~~~~~~~
- Remove ``USGS`` prefixes from the input station IDs in ``NWIS.get_streamflow``
function. Also, check if the remaining parts of the IDs are all digits and throw
an exception if otherwise. Additionally, make sure that IDs have at least 8 chars by
adding leading zeros (:issue_hydro:`99`).
- 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
~~~~~~~~~~~~
- Add a new function called ``get_us_states`` to the ``helpers`` module for obtaining
a GeoDataFrame of the US states. It has an optional argument for returning the
``contiguous`` states, ``continental`` states, ``commonwealths`` states, or
US ``territories``. The data are retrieved from the Census' Tiger 2021 database.
- In the ``NID`` class keep the ``valid_fields`` property as a ``pandas.Series``
instead of a ``list``, so it can be searched easier via its ``str`` accessor.

Internal Changes
~~~~~~~~~~~~~~~~
- Refactor the ``plot.signatures`` function to use ``proplot`` instead of ``matplotlib``.
- Improve performance of ``NWIS.get_streamflow`` by not validating the layer name
when instantiating the ``WaterData`` class. Also, make the function more robust
by checking if streamflow data is available for each station and throw a warning
if not.

Bug Fixes
~~~~~~~~~
- Fix an issue in ``NWIS.get_streamflow`` where ``-9999`` values were not being
filtered out. According to NWIS, these values are reserved for ice-affected
data. This fix sets these values to ``numpy.nan``.