Skip to main content

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

Project description Documentation Status

Hydrodata is a python library designed to aid in NHDPlus watershed analysis. Hydrodata is capable of downloading, preprocessing, and visualizing climatological, hydrological, and geographical datasets pertaining to a given watershed. Supported datasets include: Daymet climate, USGS streamflow, and NLCD data with further additions planned.


  • Download daily climate data from the Daymet database.

  • Download watersheds geometry and characteristics using StreamStats service.

  • Compute potential evapotranspiration using ETo package.

  • Download land use, land cover, canopy and impervious data from NLCD 2016 database.

  • Download daily streamflow data from the USGS NWIS database.

  • Plot hydrological signature graphs.


To install Hydrodata, run this command in your terminal:

$ pip install hydrodata

Alternatively, it can be installed from source by first using script, which generates two environments using Miniconda; one for installing hydrodata and its dependencies and another for running the nhdplus.R script (for downloading a watershed geometry based on station ID or coordinates).

Before running the script, ensure Miniconda is installed, this can be accomplished by running the command conda on the command line. If Miniconda is not installed it can be downloaded on continuum’s site and installed on Linux as follows:

$ wget
$ chmod +x
$ bash ./ -b -p ${APP_DIR}/miniconda
$ rm -f

where ${APP_DIR} is the installation folder.

$ git clone
$ cd hydrodata
$ ./
$ conda activate hydrodata
$ python install


This package was created with Cookiecutter and the audreyr/cookiecutter-pypackage project template.


0.3.0 (2020-02-19)

  • Clipped the obtained NLCD data using the watershed geometry

  • Added support for specifying the year for getting NLCD

  • Cut NHDPlus dependecy but using StreamStats and USGS APIs

  • Renamed get_lulc function to get_nlcd

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.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

hydrodata-0.3.0.tar.gz (11.9 MB view hashes)

Uploaded Source

Built Distribution

hydrodata-0.3.0-py2.py3-none-any.whl (16.6 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page