hydrodata 0.3.0

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

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.

• Documentation: https://hydrodata.readthedocs.io

Features

• 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.

Installation

To install Hydrodata, run this command in your terminal:

$ pip install hydrodata

Alternatively, it can be installed from source by first using create_env.sh 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 create_env.sh 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 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.

$ 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.

History

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.