{"id":348403,"name":"RRMPG","description":"Model the response of a catchment to meteorological input data and to forecast the river discharge.","url":"https://github.com/kratzert/rrmpg","last_synced_at":"2026-04-19T15:30:18.956Z","repository":{"id":49043222,"uuid":"100295569","full_name":"kratzert/RRMPG","owner":"kratzert","description":"Rainfall-Runoff modelling playground ","archived":false,"fork":false,"pushed_at":"2025-12-11T09:21:13.000Z","size":1898,"stargazers_count":85,"open_issues_count":1,"forks_count":24,"subscribers_count":6,"default_branch":"master","last_synced_at":"2026-03-29T05:41:29.760Z","etag":null,"topics":["hydrological-modelling","hydrology","numba","python"],"latest_commit_sha":null,"homepage":"http://rrmpg.readthedocs.io/en/latest/index.html","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kratzert.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2017-08-14T18:04:18.000Z","updated_at":"2026-03-11T09:26:06.000Z","dependencies_parsed_at":"2026-03-29T05:00:28.910Z","dependency_job_id":null,"html_url":"https://github.com/kratzert/RRMPG","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/kratzert/RRMPG","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kratzert%2FRRMPG","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kratzert%2FRRMPG/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kratzert%2FRRMPG/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kratzert%2FRRMPG/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kratzert","download_url":"https://codeload.github.com/kratzert/RRMPG/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kratzert%2FRRMPG/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31392188,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-04T04:26:24.776Z","status":"ssl_error","status_checked_at":"2026-04-04T04:23:34.147Z","response_time":60,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"owner":{"login":"kratzert","name":"Frederik Kratzert","uuid":"13069767","kind":"user","description":"Machine Learning/Hydrology Researcher \r\n","email":"","website":"https://kratzert.github.io","location":"Remote","twitter":"fkratzert","company":"Google Research","icon_url":"https://avatars.githubusercontent.com/u/13069767?u=d2cbe369e65cce00f6c69d3720408b65feaaf00a\u0026v=4","repositories_count":8,"last_synced_at":"2023-03-07T14:42:04.496Z","metadata":{"has_sponsors_listing":false},"html_url":"https://github.com/kratzert","funding_links":[],"total_stars":null,"followers":null,"following":null,"created_at":"2022-11-17T12:24:18.457Z","updated_at":"2023-03-07T14:42:04.546Z","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kratzert","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kratzert/repositories"},"packages":[],"commits":{"id":1322777,"full_name":"kratzert/RRMPG","default_branch":"master","total_commits":97,"total_committers":7,"total_bot_commits":0,"total_bot_committers":0,"mean_commits":13.857142857142858,"dds":0.12371134020618557,"past_year_total_commits":5,"past_year_total_committers":2,"past_year_total_bot_commits":0,"past_year_total_bot_committers":0,"past_year_mean_commits":2.5,"past_year_dds":0.4,"last_synced_at":"2026-04-16T14:19:13.862Z","last_synced_commit":"7de78c25acc1c255d2acaf739d65e9ce7bbd60c3","created_at":"2023-09-11T15:24:55.023Z","updated_at":"2026-04-16T14:19:00.159Z","committers":[{"name":"Unknown","email":"f.kratzert@gmail.com","login":"kratzert","count":85},{"name":"Daniel Klotz","email":"ido87@Daniels-iMac.local","login":null,"count":4},{"name":"martinma10","email":"martin.masten@uni-graz.at","login":"martinma10","count":2},{"name":"Ondřej Čertík","email":"ondrej.certik@gmail.com","login":"certik","count":2},{"name":"Daniel Klotz","email":"daniel.klotz@boku.ac.at","login":"danklotz","count":2},{"name":"Martin Gauch","email":"15731649+gauchm","login":"gauchm","count":1},{"name":"Martijn Visser","email":"mgvisser@gmail.com","login":"visr","count":1}],"past_year_committers":[{"name":"Frederik Kratzert","email":"f.kratzert@gmail.com","login":"kratzert","count":3},{"name":"martinma10","email":"martin.masten@uni-graz.at","login":"martinma10","count":2}],"commits_url":"https://commits.ecosyste.ms/api/v1/hosts/GitHub/repositories/kratzert%2FRRMPG/commits","host":{"name":"GitHub","url":"https://github.com","kind":"github","last_synced_at":"2026-04-18T00:00:07.883Z","repositories_count":6214355,"commits_count":900069861,"contributors_count":34919827,"owners_count":1144160,"icon_url":"https://github.com/github.png","host_url":"https://commits.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://commits.ecosyste.ms/api/v1/hosts/GitHub/repositories"}},"issues_stats":{"full_name":"kratzert/RRMPG","html_url":"https://github.com/kratzert/RRMPG","last_synced_at":"2025-12-11T11:05:18.888Z","status":null,"issues_count":10,"pull_requests_count":11,"avg_time_to_close_issue":18152315.0,"avg_time_to_close_pull_request":1407322.9090909092,"issues_closed_count":9,"pull_requests_closed_count":11,"pull_request_authors_count":6,"issue_authors_count":6,"avg_comments_per_issue":2.6,"avg_comments_per_pull_request":2.1818181818181817,"merged_pull_requests_count":10,"bot_issues_count":0,"bot_pull_requests_count":0,"past_year_issues_count":0,"past_year_pull_requests_count":4,"past_year_avg_time_to_close_issue":null,"past_year_avg_time_to_close_pull_request":3583276.5,"past_year_issues_closed_count":0,"past_year_pull_requests_closed_count":4,"past_year_pull_request_authors_count":2,"past_year_issue_authors_count":0,"past_year_avg_comments_per_issue":null,"past_year_avg_comments_per_pull_request":1.0,"past_year_bot_issues_count":0,"past_year_bot_pull_requests_count":0,"past_year_merged_pull_requests_count":4,"created_at":"2023-09-11T15:25:07.542Z","updated_at":"2025-12-11T11:05:18.889Z","repository_url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/repositories/kratzert%2FRRMPG","issues_url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/repositories/kratzert%2FRRMPG/issues","issue_labels_count":{"enhancement":3,"good first issue":2,"help wanted":1},"pull_request_labels_count":{},"issue_author_associations_count":{"NONE":6,"OWNER":4},"pull_request_author_associations_count":{"CONTRIBUTOR":8,"OWNER":2,"NONE":1},"issue_authors":{"kratzert":4,"bassoste":2,"stuartarchibald":1,"chooron":1,"jamesbutlerjba":1,"ckrapu":1},"pull_request_authors":{"danklotz":3,"martinma10":2,"certik":2,"kratzert":2,"gauchm":1,"visr":1},"host":{"name":"GitHub","url":"https://github.com","kind":"github","last_synced_at":"2026-04-14T00:00:07.923Z","repositories_count":14258203,"issues_count":34622516,"pull_requests_count":113210809,"authors_count":11234260,"icon_url":"https://github.com/github.png","host_url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/repositories","owners_url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/owners","authors_url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/authors"},"past_year_issue_labels_count":{},"past_year_pull_request_labels_count":{},"past_year_issue_author_associations_count":{},"past_year_pull_request_author_associations_count":{},"past_year_issue_authors":{},"past_year_pull_request_authors":{},"maintainers":[{"login":"kratzert","count":6,"url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/authors/kratzert"}],"active_maintainers":[]},"events":{"total":{"PullRequestEvent":4,"ForkEvent":1,"WatchEvent":6,"IssueCommentEvent":3,"PushEvent":3,"PullRequestReviewCommentEvent":4,"PullRequestReviewEvent":5,"CreateEvent":1},"last_year":{"PullRequestEvent":1,"IssueCommentEvent":1,"PushEvent":1,"PullRequestReviewCommentEvent":4,"PullRequestReviewEvent":3}},"keywords":["hydrological-modelling","hydrology","numba","python"],"dependencies":[{"ecosystem":"conda","filepath":"environment.yml","sha":null,"kind":"manifest","created_at":"2022-09-08T21:02:19.388Z","updated_at":"2022-09-08T21:02:19.388Z","repository_link":"https://github.com/kratzert/RRMPG/blob/master/environment.yml","dependencies":[{"id":4226445947,"package_name":"ipython","ecosystem":"conda","requirements":"","direct":true,"kind":"runtime","optional":false},{"id":4226445948,"package_name":"jupyter","ecosystem":"conda","requirements":"","direct":true,"kind":"runtime","optional":false},{"id":4226445949,"package_name":"matplotlib","ecosystem":"conda","requirements":"","direct":true,"kind":"runtime","optional":false},{"id":4226445950,"package_name":"numba","ecosystem":"conda","requirements":"","direct":true,"kind":"runtime","optional":false},{"id":4226445951,"package_name":"numpy","ecosystem":"conda","requirements":"","direct":true,"kind":"runtime","optional":false},{"id":4226445952,"package_name":"pandas","ecosystem":"conda","requirements":"","direct":true,"kind":"runtime","optional":false},{"id":4226445953,"package_name":"python","ecosystem":"conda","requirements":"3.6.*","direct":true,"kind":"runtime","optional":false},{"id":4226445954,"package_name":"scipy","ecosystem":"conda","requirements":"","direct":true,"kind":"runtime","optional":false}]},{"ecosystem":"actions","filepath":".github/workflows/test.yml","sha":null,"kind":"manifest","created_at":"2026-03-29T05:00:27.898Z","updated_at":"2026-03-29T05:00:27.898Z","repository_link":"https://github.com/kratzert/RRMPG/blob/master/.github/workflows/test.yml","dependencies":[{"id":25849758085,"package_name":"actions/checkout","ecosystem":"actions","requirements":"v4","direct":true,"kind":"composite","optional":false},{"id":25849758086,"package_name":"actions/setup-python","ecosystem":"actions","requirements":"v5","direct":true,"kind":"composite","optional":false}]},{"ecosystem":"pypi","filepath":"requirements.txt","sha":null,"kind":"manifest","created_at":"2026-03-29T05:00:28.311Z","updated_at":"2026-03-29T05:00:28.311Z","repository_link":"https://github.com/kratzert/RRMPG/blob/master/requirements.txt","dependencies":[{"id":25849758090,"package_name":"numpy","ecosystem":"pypi","requirements":"*","direct":true,"kind":"runtime","optional":false},{"id":25849758091,"package_name":"matplotlib","ecosystem":"pypi","requirements":"*","direct":true,"kind":"runtime","optional":false},{"id":25849758092,"package_name":"numba","ecosystem":"pypi","requirements":"*","direct":true,"kind":"runtime","optional":false},{"id":25849758115,"package_name":"jupyter","ecosystem":"pypi","requirements":"*","direct":true,"kind":"runtime","optional":false},{"id":25849758116,"package_name":"ipython","ecosystem":"pypi","requirements":"*","direct":true,"kind":"runtime","optional":false},{"id":25849758117,"package_name":"pandas","ecosystem":"pypi","requirements":"*","direct":true,"kind":"runtime","optional":false},{"id":25849758118,"package_name":"scipy","ecosystem":"pypi","requirements":"*","direct":true,"kind":"runtime","optional":false}]},{"ecosystem":"pypi","filepath":"setup.py","sha":null,"kind":"manifest","created_at":"2026-03-29T05:00:28.847Z","updated_at":"2026-03-29T05:00:28.847Z","repository_link":"https://github.com/kratzert/RRMPG/blob/master/setup.py","dependencies":[]}],"score":6.400257445308821,"created_at":"2026-03-14T08:47:28.617Z","updated_at":"2026-04-19T15:30:18.973Z","avatar_url":"https://github.com/kratzert.png","language":"Python","category":"Hydrosphere","sub_category":"Freshwater and Hydrology","monthly_downloads":0,"total_dependent_repos":0,"total_dependent_packages":0,"readme":"Introduction\n############\n\nThis repository is a work in progress repository.\n\nOfficial documentation can be found here: `http://rrmpg.readthedocs.io \u003chttp://rrmpg.readthedocs.io\u003e`_\n\nRead the :ref:`Idea section \u003cidea\u003e` for further information about the background and aim of this project.\n\n.. _idea:\n\nIdea\n----\nOne of the fundamental parts of hydrology is rainfall-runoff-modelling. The task here is to model the response of a catchment to meteorological input data and to forecast the river discharge. There are different approaches to tackle the problem, namely: conceptual models, physical-based models and data-driven models.\n\nAlthough this is taught at university, often hands-on experience is missing or is done on using very simple modelling approaches. One of the main reasons I see is, that most (at least the complex ones) hydrological models are implemented in Fortran but very few students of the field of hydrology know Fortran, when they first get in touch with RR-Models. So all they can probably do is simply apply a model to their data and play manually with parameter tuning, but not explore the model and see the effect of code changes.\n\nThis might be different if there would exist well performing implementations of hydrological models in a more simplistic and readable language, such as Python.\nWhat was hindering this step was always the speed of Python and the nature of RR-Models - they mostly have to be implemented using loops over all timesteps. And well, big surprise: Pure Python and for-loops is not the best combination in terms of performance.\n\nThis could be changed e.g. by using `Cython \u003chttp://cython.org/\u003e`_ for the hydrological model, but this again might hinder the code understanding, since Cython adds non-pythonic complexity to the code, which might be hard for beginners to understand and therefore play/experiment with the code.\n\nAnother option could be `PyPy \u003chttp://pypy.org/\u003e`_. The problem I see with PyPy is, that the user would be forced to install a different Python interpreter, while most I know of are quite comfortable using e.g. `Anaconda \u003chttps://www.continuum.io/anaconda-overview\u003e`_.\n\n`Numba \u003chttp://numba.pydata.org/\u003e`_ is another way to speed up array-oriented and math-heavy Python code but without changing the language/interpreter and just by few code adaptions. Using numba, the code stays easily readable and therefore better understandable for novices. I won't spend much time now on explaining how numba works, but I'll definitely add further information in the future.\nFirst performance comparisons between Fortran implementations and numba optimized Python code have shown, that the speed is roughly the same (Fortran is about ~1-2 times faster, using the GNU Fortran compiler).\n\n**Summary**: The idea of this code repository is to provide fast (roughly the speed of Fortan) implementations of hydrological models in Python to make it easier to play and experiment with rainfall-runoff models.\n\n\nYou want to contribute?\n-----------------------\n\nAt the moment I'm looking for a selection of hydrological models I'll implement in Python. If you want to see any (your?) model in this project, feel free to contact me.\nThere is also a `How to contribute section \u003chttp://rrmpg.readthedocs.io/en/latest/contribution.html\u003e`_ at the official documentation, were you can read more on the various ways you can contribute to this repository.\n\nContributors\n------------\nI'll add later a better looking section to the official documentation. For now I list everybody, who contributed to this repository here:\n\n- `Ondřej Čertík \u003chttps://github.com/certik\u003e`_ with pull request `#3 \u003chttps://github.com/kratzert/RRMPG/pull/3\u003e`_: Optimized Fortran code and compilation procedure for fair speed comparision.\n- `Daniel Klotz \u003chttps://github.com/danklotz\u003e`_ with pull request `#4 \u003chttps://github.com/kratzert/RRMPG/pull/4\u003e`_ , `#5 \u003chttps://github.com/kratzert/RRMPG/pull/4\u003e`_ and `#9 \u003chttps://github.com/kratzert/RRMPG/pull/9\u003e`_: All spell checking.\n- `Andrew MacDonald \u003chttps://github.com/amacd31\u003e`_ for providing HBV-Edu simulation data from the original MATLAB implementation (see `##10 \u003chttps://github.com/kratzert/RRMPG/issues/10\u003e`_)\n- `Martijn Visser \u003chttps://github.com/visr\u003e`_ with pull request `#13 \u003chttps://github.com/kratzert/RRMPG/pull/13\u003e`_ to update the unittest for pandas 1.0\n- `Martin Gauch \u003chttps://github.com/gauchm\u003e`_ with pull request `#14 \u003chttps://github.com/kratzert/RRMPG/pull/14\u003e`_ to fix a bug in the HBV model, when running multiple parameter sets at once.\n- `martinma10 \u003chttps://github.com/martinma10\u003e`_ with pull request `#18 \u003chttps://github.com/kratzert/RRMPG/pull/18\u003e`_ adding Snow Hysteresis and Icemelt model.\n\n\nContact\n-------\n\nRaise an issue here in this repository or contact me by mail f.kratzert(at)gmail.com\n","funding_links":[],"readme_doi_urls":[],"works":{},"citation_counts":{},"total_citations":0,"keywords_from_contributors":["hydrological-modelling","hydrology"],"project_url":"https://ost.ecosyste.ms/api/v1/projects/348403","html_url":"https://ost.ecosyste.ms/projects/348403"}