{ "info": { "author": "Thibault Hallouin", "author_email": "thibault.hallouin@ucdconnect.ie", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Intended Audience :: Developers", "Intended Audience :: Science/Research", "License :: OSI Approved :: GNU General Public License v3 (GPLv3)", "Natural Language :: English", "Operating System :: MacOS", "Operating System :: Microsoft :: Windows", "Operating System :: POSIX :: Linux", "Programming Language :: Python :: 2", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.5", "Programming Language :: Python :: 3.6", "Programming Language :: Python :: Implementation :: CPython", "Topic :: Scientific/Engineering :: Hydrology" ], "description": "[![License: GPL v3](https://img.shields.io/badge/License-GPL%20v3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)\n[![PyPI Version](https://badge.fury.io/py/hydroeval.svg)](https://pypi.python.org/pypi/hydroeval)\n[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.2591217.svg)](https://doi.org/10.5281/zenodo.2591217)\n\n# HydroEval - An efficient evaluator for streamflow time series in Python\n\nHydroEval is an open-source evaluator for streamflow time series in Python. It is licensed under GNU GPL-3.0 (see [licence file](https://github.com/ThibHlln/hydroeval/blob/master/LICENCE.md) 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](https://github.com/numpy/numpy), and therefore C code in the background) which makes for very efficient computation of the objective functions.\n\n## How to Install\n\nHydroEval is available on PyPI, so you can simply use pip and the name of the package:\n\n python -m pip install hydroeval\n\nYou can also use pip and a link to the GitHub repository directly:\n\n\tpython -m pip install git+https://github.com/ThibHlln/hydroeval.git\n\nAlternatively, you can download the source code (*i.e.* the GitHub repository) and, from the downloaded directory itself, run the command:\n\n python setup.py install\n\n## How to Use\n\nA tutorial in the form of a [Jupyter notebook](https://github.com/ThibHlln/hydroeval/blob/master/examples/api_usage_example.ipynb) 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.\n\n## How to Cite\n\nIf you are using HydroEval, please consider citing the software as follows (click on the link to get the DOI of a specific version):\n* Hallouin, T. (XXXX). HydroEval: Streamflow Simulations Evaluator (Version X.X.X). Zenodo. https://doi.org/10.5281/zenodo.2591217\n\n## Objective Functions Available\n\nThe objective functions currently available in HydroEval to evaluate the fit between observed and simulated stream flow time series are as follows:\n* [Nash-Sutcliffe Efficiency](https://doi.org/10.1016/0022-1694(70)90255-6) (`nse`)\n* [Original Kling-Gupta Efficiency](https://doi.org/10.1016/j.jhydrol.2009.08.003) (`kge`) and its three components (r, \u03b1, \u03b2)\n* [Modified Kling-Gupta Efficiency](https://doi.org/10.1016/j.jhydrol.2012.01.011) (`kgeprime`) and its three components (r, \u03b3, \u03b2)\n* [Non-Parametric Kling-Gupta Efficiency](https://doi.org/10.1080/02626667.2018.1552002) (`kgenp`) and its three components (r, \u03b1, \u03b2)\n* Root Mean Square Error (`rmse`)\n* Mean Absolute Relative Error (`mare`)\n* Percent Bias (`pbias`)\n\nMoreover, KGE and NSE can be calculated in a bounded version following [Mathevet et al. (2006)](https://iahs.info/uploads/dms/13614.21--211-219-41-MATHEVET.pdf):\n\n* Bounded Nash-Sutcliffe Efficiency (`nse_c2m`)\n* Bounded Original Kling-Gupta Efficiency (`kge_c2m`)\n* Bounded Modified Kling-Gupta Efficiency (`kgeprime_c2m`)\n* Bounded Non-Parametric Kling-Gupta Efficiency (`kgenp_c2m`)\n\nFinally, 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:\n* Inverted flows (using `transform='inv'`)\n* Square Root-transformed flows (using `transform='sqrt'`)\n* Natural Logarithm-transformed flows (using `transform='log'`)\n\n## Dependencies\n\nHydroEval requires the Python package `numpy` to be installed on the Python interpreter where `hydroeval` is installed.\n\n## Version History\n\n* 0.0.3 [09 Sep 2019]: [General enhancements](https://github.com/ThibHlln/hydroeval/releases/tag/v0.0.3)\n* 0.0.2 [29 Nov 2018]: [General improvements](https://github.com/ThibHlln/hydroeval/releases/tag/v0.0.2)\n* 0.0.1 [26 Oct 2018]: [First version of HydroEval](https://github.com/ThibHlln/hydroeval/releases/tag/v0.0.1)\n\n## Acknowledgment\n\nThis tool was developed with the financial support of Ireland's Environmental Protection Agency (Grant Number 2014-W-LS-5).\n\n\n", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/ThibHlln/hydroeval", "keywords": "", "license": "GPLv3", "maintainer": "", "maintainer_email": "", "name": "hydroeval", "package_url": "https://pypi.org/project/hydroeval/", "platform": "", "project_url": "https://pypi.org/project/hydroeval/", "project_urls": { "Homepage": "https://github.com/ThibHlln/hydroeval" }, "release_url": "https://pypi.org/project/hydroeval/0.0.3/", "requires_dist": [ "numpy" ], "requires_python": "", "summary": "HydroEval: An Efficient Evaluator for Streamflow Time Series In Python", "version": "0.0.3" }, "last_serial": 5798828, "releases": { "0.0.1": [ { "comment_text": "", "digests": { "md5": "03d534df1157156b4cf30de65d77f336", "sha256": "5974a63478c6eef94730426af61196845b02b4e966dc9d44a41a17efa1c0f3b5" }, "downloads": -1, "filename": "hydroeval-0.0.1-py2-none-any.whl", "has_sig": false, "md5_digest": "03d534df1157156b4cf30de65d77f336", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": null, "size": 5178, "upload_time": "2018-10-26T09:52:21", "url": "https://files.pythonhosted.org/packages/02/10/1da67918625c15b585c001d54bda4006cd24ef76828cdf1828cc872f1f93/hydroeval-0.0.1-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "4eaeeecd8490b2e562538b0eab40c7f4", "sha256": "b425b162c4e29cfcb1bc79c640fedebd7171fbdb1cb5aa635244df171522a230" }, "downloads": -1, "filename": "hydroeval-0.0.1-py3-none-any.whl", "has_sig": false, "md5_digest": "4eaeeecd8490b2e562538b0eab40c7f4", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 17568, "upload_time": "2018-10-26T09:52:22", "url": "https://files.pythonhosted.org/packages/9d/38/1fd1b6cc126521603fd8883aad04103371cb33775f74d540d673351e9691/hydroeval-0.0.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "5c387327049324cda14a867de34ec418", "sha256": "fb1da69d33f6b2fc081bf4188d1467cd93fe01afe23f05a13e1ebdaf4c9d97f6" }, "downloads": -1, "filename": "hydroeval-0.0.1.tar.gz", "has_sig": false, "md5_digest": "5c387327049324cda14a867de34ec418", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4659, "upload_time": "2018-10-26T09:52:24", "url": "https://files.pythonhosted.org/packages/5d/aa/bce389e932aeac0e5ce9d64ace318d5388cdb8deeca0a82627f6a3a0c27d/hydroeval-0.0.1.tar.gz" } ], "0.0.1.post1": [ { "comment_text": "", "digests": { "md5": "c6fbcd05c5061dded4ddfa90da02d0d3", "sha256": "7381da6e322918d5781698715a3addf3e5de85556f5f7ba4e2a036c5bc09026f" }, "downloads": -1, "filename": "hydroeval-0.0.1.post1-py2-none-any.whl", "has_sig": false, "md5_digest": "c6fbcd05c5061dded4ddfa90da02d0d3", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": null, "size": 6686, "upload_time": "2018-10-26T10:05:59", "url": "https://files.pythonhosted.org/packages/0a/18/1cbba5f9f2929bb6a102dfa05b9cc43bea0d8d74456bf3c47cd2b0bb682f/hydroeval-0.0.1.post1-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "8abc45942ea6805a27f2f6c08ad3ca8d", "sha256": "45313e0abfb8ede55c9b26cbe211c2ff1f021e61a36d256fa208f2133720c89e" }, "downloads": -1, "filename": "hydroeval-0.0.1.post1-py3-none-any.whl", "has_sig": false, "md5_digest": "8abc45942ea6805a27f2f6c08ad3ca8d", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 19079, "upload_time": "2018-10-26T10:06:00", "url": "https://files.pythonhosted.org/packages/d4/06/590290f5b45a13673a553788fb934fcf3658acbcb19d38e4ec2abbe3e307/hydroeval-0.0.1.post1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "372d26fc79a7b81c8455e1525e6d9b3f", "sha256": "5f13c53809742efa08ecd6035fd55a3c80b2e35beef5410ae82d07cb19d36747" }, "downloads": -1, "filename": "hydroeval-0.0.1.post1.tar.gz", "has_sig": false, "md5_digest": "372d26fc79a7b81c8455e1525e6d9b3f", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5015, "upload_time": "2018-10-26T10:06:01", "url": "https://files.pythonhosted.org/packages/f8/2f/8c4bc49d4fc1caa181fac41813e0a424935cce9742b66d0259b8450fd33d/hydroeval-0.0.1.post1.tar.gz" } ], "0.0.2": [ { "comment_text": "", "digests": { "md5": "c737b3c34c88153c8daa08ba53ef5194", "sha256": "bd62d4ca219f9adaa98b78775ac1852832216ed79fa2da7bb3e719cf17a2fadb" }, "downloads": -1, "filename": "hydroeval-0.0.2-py2-none-any.whl", "has_sig": false, "md5_digest": "c737b3c34c88153c8daa08ba53ef5194", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": null, "size": 20200, "upload_time": "2018-11-29T18:23:14", "url": "https://files.pythonhosted.org/packages/61/97/51cc4f0694da3e8e39e837090c88474a0efd2eb7eb5c948f0ae08a05daf4/hydroeval-0.0.2-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "726d055cc36959aa1a6165fa4b7e3085", "sha256": "9c5161bac5b3cb2e577f4d51306d3b9ba8d657ff1574a314d4f23d5e1ca4a5ef" }, "downloads": -1, "filename": "hydroeval-0.0.2-py3-none-any.whl", "has_sig": false, "md5_digest": "726d055cc36959aa1a6165fa4b7e3085", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 20181, "upload_time": "2018-11-29T18:23:16", "url": "https://files.pythonhosted.org/packages/ef/c9/0a8c4bf6c453c02c29e9400fdd2ddb745bb5d97e7e7a10c254b4fc7fb65d/hydroeval-0.0.2-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "bc6cdcfa3a20beb9bba195c04b0df5c3", "sha256": "2e0f94809d5cac5da0088f548ccf01f2f975d0b56f84fa791f13e0bf528ebf78" }, "downloads": -1, "filename": "hydroeval-0.0.2.tar.gz", "has_sig": false, "md5_digest": "bc6cdcfa3a20beb9bba195c04b0df5c3", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5540, "upload_time": "2018-11-29T18:23:17", "url": "https://files.pythonhosted.org/packages/a6/08/d12d892f6ff1287dfee46c3dbdbc1b38658f129ffd131126a7c07b66333f/hydroeval-0.0.2.tar.gz" } ], "0.0.3": [ { "comment_text": "", "digests": { "md5": "0fae12ab7c721c6c87feb4202a3b678a", "sha256": "c569f486593e47d4483eb37604b11fbc6fe338596a2c92eb6cec455c0aca4e4b" }, "downloads": -1, "filename": "hydroeval-0.0.3-py2-none-any.whl", "has_sig": false, "md5_digest": "0fae12ab7c721c6c87feb4202a3b678a", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": null, "size": 20160, "upload_time": "2019-09-08T09:22:05", "url": "https://files.pythonhosted.org/packages/34/e9/f4033dd82140a74ae45ad68ce0838da16bafee904211f851bca9c2304bc2/hydroeval-0.0.3-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "5fcb7c761eff5732271be154ce840edd", "sha256": "8ee8c7fcc35a6fa92d1638606f8180ab40199073d66592c17d50bfc00a49ff41" }, "downloads": -1, "filename": "hydroeval-0.0.3-py3-none-any.whl", "has_sig": false, "md5_digest": "5fcb7c761eff5732271be154ce840edd", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 20160, "upload_time": "2019-09-08T09:22:06", "url": "https://files.pythonhosted.org/packages/b7/17/e32bd50ba4e135983d4d5bb8679b1fab51ece8e49453d13c4710b84d1105/hydroeval-0.0.3-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "8042c0cf7fa423684a02037830d433be", "sha256": "4217e0ad9075dd33bb8f3fa6ab8fe8b3897a7d81b5acb2d6c61aaf0016472615" }, "downloads": -1, "filename": "hydroeval-0.0.3.tar.gz", "has_sig": false, "md5_digest": "8042c0cf7fa423684a02037830d433be", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5627, "upload_time": "2019-09-08T09:22:08", "url": "https://files.pythonhosted.org/packages/5a/38/9c3c1579413360afbaee6186a54dd328f6e26c640afd797c6dc4f68b45f3/hydroeval-0.0.3.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "0fae12ab7c721c6c87feb4202a3b678a", "sha256": "c569f486593e47d4483eb37604b11fbc6fe338596a2c92eb6cec455c0aca4e4b" }, "downloads": -1, "filename": "hydroeval-0.0.3-py2-none-any.whl", "has_sig": false, "md5_digest": "0fae12ab7c721c6c87feb4202a3b678a", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": null, "size": 20160, "upload_time": "2019-09-08T09:22:05", "url": "https://files.pythonhosted.org/packages/34/e9/f4033dd82140a74ae45ad68ce0838da16bafee904211f851bca9c2304bc2/hydroeval-0.0.3-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "5fcb7c761eff5732271be154ce840edd", "sha256": "8ee8c7fcc35a6fa92d1638606f8180ab40199073d66592c17d50bfc00a49ff41" }, "downloads": -1, "filename": "hydroeval-0.0.3-py3-none-any.whl", "has_sig": false, "md5_digest": "5fcb7c761eff5732271be154ce840edd", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 20160, "upload_time": "2019-09-08T09:22:06", "url": "https://files.pythonhosted.org/packages/b7/17/e32bd50ba4e135983d4d5bb8679b1fab51ece8e49453d13c4710b84d1105/hydroeval-0.0.3-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "8042c0cf7fa423684a02037830d433be", "sha256": "4217e0ad9075dd33bb8f3fa6ab8fe8b3897a7d81b5acb2d6c61aaf0016472615" }, "downloads": -1, "filename": "hydroeval-0.0.3.tar.gz", "has_sig": false, "md5_digest": "8042c0cf7fa423684a02037830d433be", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5627, "upload_time": "2019-09-08T09:22:08", "url": "https://files.pythonhosted.org/packages/5a/38/9c3c1579413360afbaee6186a54dd328f6e26c640afd797c6dc4f68b45f3/hydroeval-0.0.3.tar.gz" } ] }