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.

Files for hydrodata, version 0.3.0
Filename, size File type Python version Upload date Hashes
Filename, size hydrodata-0.3.0-py2.py3-none-any.whl (16.6 kB) File type Wheel Python version py2.py3 Upload date Hashes View hashes
Filename, size hydrodata-0.3.0.tar.gz (11.9 MB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page