HydroEval: An Efficient Evaluator for Streamflow Time Series In Python

# HydroEval - An efficient evaluator for streamflow time series in Python

HydroEval is an open-source evaluator for streamflow time series in Python. It is licensed under GNU GPL-3.0 (see licence file provided). The purpose of this evaluator is to compare observed and simulated hydrographs using one or more objective functions. HydroEval is designed to calculate all objective functions in a vectorised manner (using numpy, and therefore C code in the background) which makes for very efficient computation of the objective functions.

## How to Install

HydroEval is available on PyPI, so you can simply use pip and the name of the package:

``````python -m pip install hydroeval
``````

You can also use pip and a link to the GitHub repository directly:

``````python -m pip install git+https://github.com/ThibHlln/hydroeval.git
``````

``````python setup.py install
``````

## How to Use

A tutorial in the form of a Jupyter notebook is available to get started with the usage of HydroEval's API. The input files required for the tutorial are all provided in the `examples/` folder.

## How to Cite

If you are using HydroEval, please consider citing the software as follows (click on the link to get the DOI of a specific version):

## Objective Functions Available

The objective functions currently available in HydroEval to evaluate the fit between observed and simulated stream flow time series are as follows:

Moreover, KGE and NSE can be calculated in a bounded version following Mathevet et al. (2006):

• Bounded Nash-Sutcliffe Efficiency (`nse_c2m`)
• Bounded Original Kling-Gupta Efficiency (`kge_c2m`)
• Bounded Modified Kling-Gupta Efficiency (`kgeprime_c2m`)
• Bounded Non-Parametric Kling-Gupta Efficiency (`kgenp_c2m`)

Finally, any of the objective functions can take an optional argument `transform`. This argument allows to apply a transformation on both the observed and the simulated streamflow time series prior the calculation of the objective function. The possible transformations are as follows:

• Inverted flows (using `transform='inv'`)
• Square Root-transformed flows (using `transform='sqrt'`)
• Natural Logarithm-transformed flows (using `transform='log'`)

## Dependencies

HydroEval requires the Python package `numpy` to be installed on the Python interpreter where `hydroeval` is installed.

## Acknowledgment

This tool was developed with the financial support of Ireland's Environmental Protection Agency (Grant Number 2014-W-LS-5).

## Project details

This version 0.0.3 0.0.2 0.0.1.post1 0.0.1