[](https://doi.org/10.5281/zenodo.5758979)
[](https://mybinder.org/v2/gh/MAfarrag/HAPI/master)
[](https://img.shields.io/pypi/pyversions/HAPI-Nile)
[](https://hapi-hm.readthedocs.io/en/latest/?badge=latest)
[](https://www.gnu.org/licenses/gpl-3.0)
[](https://github.com/pre-commit/pre-commit)
[](https://lgtm.com/projects/g/MAfarrag/Hapi/context:python)
[](https://github.com/MShawon/github-clone-count-badge) [](https://saythanks.io/to/MAfarrag)
Current build status
====================
<table><tr><td>All platforms:</td>
<td>
<a href="https://dev.azure.com/conda-forge/feedstock-builds/_build/latest?definitionId=12419&branchName=master">
<img src="https://dev.azure.com/conda-forge/feedstock-builds/_apis/build/status/hapi-feedstock?branchName=master">
</a>
</td>
</tr>
</table>
[](https://ci.appveyor.com/project/MAfarrag/hapi)
[](https://codecov.io/gh/Serapieum-of-alex/Hapi)
[](https://GitHub.com/Naereen/StrapDown.js/releases/)
Current release info
====================
| Name | Downloads | Version | Platforms |
| --- |-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| --- | --- |
| [](https://anaconda.org/conda-forge/hapi) | [](https://anaconda.org/conda-forge/hapi) [](https://pepy.tech/project/hapi-nile) [](https://pepy.tech/project/hapi-nile) [](https://pepy.tech/project/hapi-nile)   | [](https://anaconda.org/conda-forge/hapi) [](https://badge.fury.io/py/HAPI-Nile) [](https://anaconda.org/conda-forge/hapi) | [](https://anaconda.org/conda-forge/hapi) [](https://gitter.im/Hapi-Nile/Hapi?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) |
 
Hapi - Hydrological library for Python
=====================================================================
**Hapi** is an open-source Python Framework for building raster-based conceptual distributed hydrological models using HBV96 lumped
model & Muskingum routing method at a catchment scale (Farrag & Corzo, 2021), Hapi gives a high degree of flexibility to all components of the model
(spatial discretization - cell size, temporal resolution, parameterization approaches and calibration (Farrag et al., 2021)).
 
Hapi
Main Features
-------------
- Modified version of HBV96 hydrological model (Bergström, 1992) with 15 parameters in case of considering
snow processes, and 10 parameters without snow, in addition to 2 parameters of Muskingum routing method
- Remote sensing module to download the meteorological inputs required for the hydrologic model simulation (ECMWF)
- GIS modules to enable the modeler to fully prepare the meteorological inputs and do all the preprocessing
needed to build the model (align rasters with the DEM), in addition to various methods to manipulate and
convert different forms of distributed data (rasters, NetCDF, shapefiles)
- Sensitivity analysis module based on the concept of one-at-a-time OAT and analysis of the interaction among
model parameters using the Sobol concept ((Rusli et al., 2015)) and a visualization
- Statistical module containing interpolation methods for generating distributed data from gauge data, some
distribution for frequency analysis and Maximum likelihood method for distribution parameter estimation.
- Visualization module for animating the results of the distributed model, and the meteorological inputs
- Optimization module, for calibrating the model based on the Harmony search method
The recent version of Hapi (Hapi 1.0.1) integrates the global hydrological parameters obtained by Beck et al., (2016),
to reduce model complexity and uncertainty of parameters.
Future work
-------------
- Developing a regionalization method for connection model parameters with some catchment characteristics for better model calibration.
- Developing and integrate river routing method (kinematic and diffusive wave approximation)
- Apply the model for large scale (regional/continental) cases
- Developing a DEM processing module for generating the river network at different DEM spatial resolutions.
For using Hapi please cite Farrag et al. (2021) and Farrag & Corzo (2021)
IHE-Delft sessions
------------------
- In April 14-15 we had a two days session for Masters and PhD student in IHE-Delft to explain the different modules and the distributed hydrological model in Hapi [Day 1](https://youtu.be/HbmUdN9ehSo) , [Day 2](https://youtu.be/m7kHdOFQFIY)
References
-------------
Farrag, M. & Corzo, G. (2021) MAfarrag/Hapi: Hapi. doi:10.5281/ZENODO.4662170
Farrag, M., Perez, G. C. & Solomatine, D. (2021) Spatio-Temporal Hydrological Model Structure and Parametrization Analysis. J. Mar. Sci. Eng. 9(5), 467. doi:10.3390/jmse9050467 [Link](https://www.researchgate.net/publication/351143581_Spatio-Temporal_Hydrological_Model_Structure_and_Parametrization_Analysis)
Beck, H. E., Dijk, A. I. J. M. van, Ad de Roo, Diego G. Miralles, T. R. M. & Jaap Schellekens, and L. A. B. (2016) Global-scale regionalization of hydrologic model parameters-Supporting materials 3599–3622. doi:10.1002/2015WR018247.Received
Bergström, S. (1992) The HBV model - its structure and applications. Smhi Rh 4(4), 35.
Rusli, S. R., Yudianto, D. & Liu, J. tao. (2015) Effects of temporal variability on HBV model calibration. Water Sci. Eng. 8(4), 291–300. Elsevier Ltd. doi:10.1016/j.wse.2015.12.002
Installing hapi
===============
Installing `hapi` from the `conda-forge` channel can be achieved by:
```
conda install -c conda-forge hapi
```
It is possible to list all of the versions of `hapi` available on your platform with:
```
conda search hapi --channel conda-forge
```
## Install from Github
to install the last development to time you can install the library from github
```
pip install git+https://github.com/MAfarrag/HAPI
```
## pip
to install the last release you can easly use pip
```
pip install HAPI-Nile==1.6.0
```
Quick start
===========
```
>>> import Hapi
```
[other code samples](https://hapi-hm.readthedocs.io/en/latest/?badge=latest)
## Naming Convention
[PEP8](https://peps.python.org/pep-0008/#naming-conventions)
- module names: lower case word, preferably one word if not, separate words with underscores (module.py, my_module.py).
- class names: PascalCase (Model, MyClass).
- class method/function: CamelCase(getFile, readConfig).should have a verb one them, because they perform some action
=======
History
=======
1.3.2 (2022-12-26)
------------------
* remove parameters from the package and retrieve them with the parameter package.
1.3.3 (2022-12-27)
------------------
* use joblib to parallelize reading laterals in hydraulic model
1.3.4 (2022-12-27)
------------------
* merge two function readLaterals and readRRMProgression, rename RRMProgression to routedRRM
1.3.5 (2022-12-27)
------------------
* fix pypi package names in the requirements.txt file for all internal packages
* fix python version number
* tests are all passing
1.4.0 (2022-12-27)
------------------
* remove fiona and the reading file exception using fion
* unify reading results of rainfall-runoff model in the readRRMResults, ReadLaterals, ReadUSHydrographs
* refactor code and change methods to camelcase
* add hydrodynamic model 1d config file read function
* simplify functions with too many parameters using decorator
* add automatic pypi build and publish github actions
1.5.0 (2023-01-10)
------------------
* hydraulic model can read chunked big zip file
* fix CI
* fix missing module (saint venant script and module)
1.6.0 (2023-02-03)
------------------
* all attributes follows snake case naming convention
* refactor all modules with pre-commit
* add smoothDikeLevel, getReach and updateReach
* bump up denpendencies versions
* move un-necessary functions to serapeum-utils
Raw data
{
"_id": null,
"home_page": "https://github.com/MAfarrag/Hapi",
"name": "HAPI-Nile",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "Hydrology,Distributed hydrological model,Hydaulic model",
"author": "Mostafa Farrag",
"author_email": "moah.farag@gmail.come",
"download_url": "https://files.pythonhosted.org/packages/1a/f9/0a363d6ca0502ba57c967c09bd44dc9124bd84eb4040c91d618a25b3b100/HAPI-Nile-1.6.0.tar.gz",
"platform": null,
"description": "\r\n[](https://doi.org/10.5281/zenodo.5758979)\r\n[](https://mybinder.org/v2/gh/MAfarrag/HAPI/master)\r\n[](https://img.shields.io/pypi/pyversions/HAPI-Nile)\r\n[](https://hapi-hm.readthedocs.io/en/latest/?badge=latest)\r\n[](https://www.gnu.org/licenses/gpl-3.0)\r\n[](https://github.com/pre-commit/pre-commit)\r\n[](https://lgtm.com/projects/g/MAfarrag/Hapi/context:python)\r\n\r\n\r\n[](https://github.com/MShawon/github-clone-count-badge) [](https://saythanks.io/to/MAfarrag)\r\n\r\nCurrent build status\r\n====================\r\n\r\n\r\n<table><tr><td>All platforms:</td>\r\n <td>\r\n <a href=\"https://dev.azure.com/conda-forge/feedstock-builds/_build/latest?definitionId=12419&branchName=master\">\r\n <img src=\"https://dev.azure.com/conda-forge/feedstock-builds/_apis/build/status/hapi-feedstock?branchName=master\">\r\n </a>\r\n </td>\r\n </tr>\r\n</table>\r\n\r\n[](https://ci.appveyor.com/project/MAfarrag/hapi)\r\n[](https://codecov.io/gh/Serapieum-of-alex/Hapi)\r\n\r\n\r\n\r\n\r\n\r\n\r\n[](https://GitHub.com/Naereen/StrapDown.js/releases/)\r\n\r\n\r\n\r\n\r\nCurrent release info\r\n====================\r\n\r\n| Name | Downloads | Version | Platforms |\r\n| --- |-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| --- | --- |\r\n| [](https://anaconda.org/conda-forge/hapi) | [](https://anaconda.org/conda-forge/hapi) [](https://pepy.tech/project/hapi-nile) [](https://pepy.tech/project/hapi-nile) [](https://pepy.tech/project/hapi-nile)   | [](https://anaconda.org/conda-forge/hapi) [](https://badge.fury.io/py/HAPI-Nile) [](https://anaconda.org/conda-forge/hapi) | [](https://anaconda.org/conda-forge/hapi) [](https://gitter.im/Hapi-Nile/Hapi?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) |\r\n\r\n\r\n \r\n\r\n\r\nHapi - Hydrological library for Python\r\n=====================================================================\r\n**Hapi** is an open-source Python Framework for building raster-based conceptual distributed hydrological models using HBV96 lumped\r\nmodel & Muskingum routing method at a catchment scale (Farrag & Corzo, 2021), Hapi gives a high degree of flexibility to all components of the model\r\n(spatial discretization - cell size, temporal resolution, parameterization approaches and calibration (Farrag et al., 2021)).\r\n\r\n\r\n \r\n\r\nHapi\r\n\r\nMain Features\r\n-------------\r\n - Modified version of HBV96 hydrological model (Bergstr\u00c3\u00b6m, 1992) with 15 parameters in case of considering\r\n snow processes, and 10 parameters without snow, in addition to 2 parameters of Muskingum routing method\r\n - Remote sensing module to download the meteorological inputs required for the hydrologic model simulation (ECMWF)\r\n - GIS modules to enable the modeler to fully prepare the meteorological inputs and do all the preprocessing\r\n needed to build the model (align rasters with the DEM), in addition to various methods to manipulate and\r\n convert different forms of distributed data (rasters, NetCDF, shapefiles)\r\n - Sensitivity analysis module based on the concept of one-at-a-time OAT and analysis of the interaction among\r\n model parameters using the Sobol concept ((Rusli et al., 2015)) and a visualization\r\n - Statistical module containing interpolation methods for generating distributed data from gauge data, some\r\n distribution for frequency analysis and Maximum likelihood method for distribution parameter estimation.\r\n - Visualization module for animating the results of the distributed model, and the meteorological inputs\r\n - Optimization module, for calibrating the model based on the Harmony search method\r\n\r\nThe recent version of Hapi (Hapi 1.0.1) integrates the global hydrological parameters obtained by Beck et al., (2016),\r\nto reduce model complexity and uncertainty of parameters.\r\n\r\nFuture work\r\n-------------\r\n - Developing a regionalization method for connection model parameters with some catchment characteristics for better model calibration.\r\n - Developing and integrate river routing method (kinematic and diffusive wave approximation)\r\n - Apply the model for large scale (regional/continental) cases\r\n - Developing a DEM processing module for generating the river network at different DEM spatial resolutions.\r\n\r\nFor using Hapi please cite Farrag et al. (2021) and Farrag & Corzo (2021)\r\n\r\nIHE-Delft sessions\r\n------------------\r\n- In April 14-15 we had a two days session for Masters and PhD student in IHE-Delft to explain the different modules and the distributed hydrological model in Hapi [Day 1](https://youtu.be/HbmUdN9ehSo) , [Day 2](https://youtu.be/m7kHdOFQFIY)\r\n\r\nReferences\r\n-------------\r\nFarrag, M. & Corzo, G. (2021) MAfarrag/Hapi: Hapi. doi:10.5281/ZENODO.4662170\r\n\r\nFarrag, M., Perez, G. C. & Solomatine, D. (2021) Spatio-Temporal Hydrological Model Structure and Parametrization Analysis. J. Mar. Sci. Eng. 9(5), 467. doi:10.3390/jmse9050467 [Link](https://www.researchgate.net/publication/351143581_Spatio-Temporal_Hydrological_Model_Structure_and_Parametrization_Analysis)\r\n\r\nBeck, H. E., Dijk, A. I. J. M. van, Ad de Roo, Diego G. Miralles, T. R. M. & Jaap Schellekens, and L. A. B. (2016) Global-scale regionalization of hydrologic model parameters-Supporting materials 3599\u00e2\u20ac\u201c3622. doi:10.1002/2015WR018247.Received\r\n\r\nBergstr\u00c3\u00b6m, S. (1992) The HBV model - its structure and applications. Smhi Rh 4(4), 35.\r\n\r\nRusli, S. R., Yudianto, D. & Liu, J. tao. (2015) Effects of temporal variability on HBV model calibration. Water Sci. Eng. 8(4), 291\u00e2\u20ac\u201c300. Elsevier Ltd. doi:10.1016/j.wse.2015.12.002\r\n\r\n\r\nInstalling hapi\r\n===============\r\n\r\nInstalling `hapi` from the `conda-forge` channel can be achieved by:\r\n\r\n```\r\nconda install -c conda-forge hapi\r\n```\r\n\r\nIt is possible to list all of the versions of `hapi` available on your platform with:\r\n\r\n```\r\nconda search hapi --channel conda-forge\r\n```\r\n\r\n## Install from Github\r\nto install the last development to time you can install the library from github\r\n```\r\npip install git+https://github.com/MAfarrag/HAPI\r\n```\r\n\r\n## pip\r\nto install the last release you can easly use pip\r\n```\r\npip install HAPI-Nile==1.6.0\r\n```\r\n\r\nQuick start\r\n===========\r\n\r\n```\r\n >>> import Hapi\r\n```\r\n\r\n[other code samples](https://hapi-hm.readthedocs.io/en/latest/?badge=latest)\r\n\r\n## Naming Convention\r\n[PEP8](https://peps.python.org/pep-0008/#naming-conventions)\r\n- module names: lower case word, preferably one word if not, separate words with underscores (module.py, my_module.py).\r\n- class names: PascalCase (Model, MyClass).\r\n- class method/function: CamelCase(getFile, readConfig).should have a verb one them, because they perform some action\r\n\r\n\r\n=======\r\nHistory\r\n=======\r\n\r\n1.3.2 (2022-12-26)\r\n------------------\r\n\r\n* remove parameters from the package and retrieve them with the parameter package.\r\n\r\n\r\n1.3.3 (2022-12-27)\r\n------------------\r\n\r\n* use joblib to parallelize reading laterals in hydraulic model\r\n\r\n\r\n1.3.4 (2022-12-27)\r\n------------------\r\n\r\n* merge two function readLaterals and readRRMProgression, rename RRMProgression to routedRRM\r\n\r\n1.3.5 (2022-12-27)\r\n------------------\r\n\r\n* fix pypi package names in the requirements.txt file for all internal packages\r\n* fix python version number\r\n* tests are all passing\r\n\r\n1.4.0 (2022-12-27)\r\n------------------\r\n\r\n* remove fiona and the reading file exception using fion\r\n* unify reading results of rainfall-runoff model in the readRRMResults, ReadLaterals, ReadUSHydrographs\r\n* refactor code and change methods to camelcase\r\n* add hydrodynamic model 1d config file read function\r\n* simplify functions with too many parameters using decorator\r\n* add automatic pypi build and publish github actions\r\n\r\n1.5.0 (2023-01-10)\r\n------------------\r\n* hydraulic model can read chunked big zip file\r\n* fix CI\r\n* fix missing module (saint venant script and module)\r\n\r\n1.6.0 (2023-02-03)\r\n------------------\r\n* all attributes follows snake case naming convention\r\n* refactor all modules with pre-commit\r\n* add smoothDikeLevel, getReach and updateReach\r\n* bump up denpendencies versions\r\n* move un-necessary functions to serapeum-utils\r\n",
"bugtrack_url": null,
"license": "GNU General Public License v3",
"summary": "Distributed hydrological-model",
"version": "1.6.0",
"split_keywords": [
"hydrology",
"distributed hydrological model",
"hydaulic model"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "6d355f38258b45ab2fb70cedc82b4be4e298dca3d3ec9f77d227d958ec09bc09",
"md5": "d1c0ae1ec52d98f400ae8b7bdf35307c",
"sha256": "3cd6016278fade8f6608cab24efa62bbf0449a9d44e73757383fc95e3afc4714"
},
"downloads": -1,
"filename": "HAPI_Nile-1.6.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d1c0ae1ec52d98f400ae8b7bdf35307c",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 184449,
"upload_time": "2023-02-02T23:39:40",
"upload_time_iso_8601": "2023-02-02T23:39:40.013712Z",
"url": "https://files.pythonhosted.org/packages/6d/35/5f38258b45ab2fb70cedc82b4be4e298dca3d3ec9f77d227d958ec09bc09/HAPI_Nile-1.6.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "1af90a363d6ca0502ba57c967c09bd44dc9124bd84eb4040c91d618a25b3b100",
"md5": "35b9c431307eb9552ebfd3b83decd251",
"sha256": "e66d971a6724832a1a69714c5622d216482fea7b8fc2227fea1644d829269936"
},
"downloads": -1,
"filename": "HAPI-Nile-1.6.0.tar.gz",
"has_sig": false,
"md5_digest": "35b9c431307eb9552ebfd3b83decd251",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 164301,
"upload_time": "2023-02-02T23:39:43",
"upload_time_iso_8601": "2023-02-02T23:39:43.180061Z",
"url": "https://files.pythonhosted.org/packages/1a/f9/0a363d6ca0502ba57c967c09bd44dc9124bd84eb4040c91d618a25b3b100/HAPI-Nile-1.6.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-02-02 23:39:43",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "MAfarrag",
"github_project": "Hapi",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "hapi-nile"
}
JSON
