Metadata-Version: 2.1
Name: hydrodata
Version: 0.2.0
Summary: Hydrodata downloads climate data for a USGS station as well as land use, land cover data for the corresponding watershed.
Home-page: https://github.com/cheginit/hydrodata
Author: Taher Chegini
Author-email: cheginit@gmail.com
License: MIT license
Keywords: hydrodata
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Requires-Python: >=3.6
Requires-Dist: ETo (>=1.1.0)
Requires-Dist: OWSLib (>=0.18.0)
Requires-Dist: numpy (>=1.18.1)
Requires-Dist: rasterstats (>=0.14.0)
Requires-Dist: tables (>=3.6.1)
Requires-Dist: daymetpy (>=1.0.0)
Requires-Dist: numba (>=0.48.0)
Requires-Dist: tqdm (>=4.42.0)
Requires-Dist: requests (>=2.22.0)
Requires-Dist: Shapely (>=1.6.4.post2)
Requires-Dist: pandas (>=1.0.0)
Requires-Dist: matplotlib (>=3.1.1)
Requires-Dist: geopandas (>=0.6.1)
Requires-Dist: h5py (>=2.10.0)
Requires-Dist: py7zr (==0.4.4)
Requires-Dist: lxml (>=4.5)

Hydrodata
=========


.. image:: https://img.shields.io/pypi/v/hydrodata.svg
        :target: https://pypi.python.org/pypi/hydrodata

.. image:: https://travis-ci.com/cheginit/hydrodata.svg?branch=master
        :target: https://travis-ci.com/cheginit/hydrodata.svg?branch=master

.. image:: https://readthedocs.org/projects/hydrodata/badge/?version=latest
        :target: https://hydrodata.readthedocs.io/en/latest/?badge=latest
        :alt: Documentation Status

.. image:: https://zenodo.org/badge/237573928.svg
   :target: https://zenodo.org/badge/latestdoi/237573928

Hydrodata downloads climate data for USGS stations as well as land use, land cover data for the corresponding watershed.


* Free software: MIT license
* Documentation: https://hydrodata.readthedocs.io.


Features
--------

* Download daily climate data from the `Daymet <https://daymet.ornl.gov/>`__ database.
* Download daily streamflow data from the `NWIS <https://nwis.waterdata.usgs.gov/nwis>`__ database.
* Compute potential evapotranspiration using `ETo <https://eto.readthedocs.io/en/latest/>`__ package.
* Download land use, land cover data from `NLCD 2016 <https://www.mrlc.gov/>`__ database.
* Plot hydrological signature graphs.


Installation
------------

To install Hydrodata, run this command in your terminal:

.. code-block:: console

    $ pip install hydrodata


Alternatively, it can be installed from source by first using ``create_env.sh`` script to generate two environments using Miniconda framework; one for installing hydrodata and its dependencies and one for running the `nhdplus.R` script (for downloading a watershed geometry based on station ID or coordinates). Before running the script modify it based on the installation folder of Miniconda or Anaconda. Miniconda can be installed on Linux systems as follows:

.. code-block:: console

    $ wget https://repo.continuum.io/miniconda/Miniconda3-latest-Linux-x86_64.sh
    $ chmod +x Miniconda3-latest-Linux-x86_64.sh
    $ bash ./Miniconda3-latest-Linux-x86_64.sh -b -p ${APP_DIR}/miniconda
    $ rm -f Miniconda3-latest-Linux-x86_64.sh

where ``${APP_DIR}`` is the installation folder.

.. code-block:: console

    $ git clone https://github.com/cheginit/hydrodata.git
    $ cd hydrodata
    $ ./create_env.sh
    $ conda activate hydrodata
    $ python setup.py install


Credits
-------

This package was created with Cookiecutter_ and the `audreyr/cookiecutter-pypackage`_ project template.

.. _Cookiecutter: https://github.com/audreyr/cookiecutter
.. _`audreyr/cookiecutter-pypackage`: https://github.com/audreyr/cookiecutter-pypackage


=======
History
=======

0.2.0 (2020-02-09)
------------------

* Simplified import method
* Changed usage from `rst` format to `ipynb`
* Autoo-formatting with the black python package


0.1.6 (2020-02-04)
------------------

* Change docstring format based on Sphinx
* Fixed pytest warnings and changed its working directory

0.1.5 (2020-02-02)
------------------

* Added an example notebook with datafiles
* Added docstring for all the functions
* Added Module section to the documentation
* Fixed py7zr issue
* Changed 7z extractor from pyunpack to py7zr
* Fixed some linting issues.

0.1.0 (2020-01-31)
------------------

* First release on PyPI.


