{"id":349246,"name":"mizuRoute","description":"A tool that takes runoff data from a hydrologic or land surface model to compute streamflow in a user-defined catchment-based river network.","url":"https://github.com/escomp/mizuroute","last_synced_at":"2026-04-17T02:30:18.563Z","repository":{"id":37024852,"uuid":"37952512","full_name":"ESCOMP/mizuRoute","owner":"ESCOMP","description":"Reach-based river routing model","archived":false,"fork":false,"pushed_at":"2026-03-25T17:59:39.000Z","size":42902,"stargazers_count":55,"open_issues_count":48,"forks_count":71,"subscribers_count":9,"default_branch":"main","last_synced_at":"2026-04-14T01:02:51.178Z","etag":null,"topics":["climate","hydrology","river"],"latest_commit_sha":null,"homepage":"http://escomp.github.io/mizuRoute/","language":"Fortran","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ESCOMP.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"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":"2015-06-24T00:26:03.000Z","updated_at":"2026-04-10T19:51:03.000Z","dependencies_parsed_at":"2023-02-09T06:00:56.339Z","dependency_job_id":"3b2f7a68-8606-42ac-83fb-314fc29d1be5","html_url":"https://github.com/ESCOMP/mizuRoute","commit_stats":{"total_commits":509,"total_committers":8,"mean_commits":63.625,"dds":0.2573673870333988,"last_synced_commit":"0a62ee6185bdc9b99cd88ed5f15ea850602c43a2"},"previous_names":["ncar/mizuroute"],"tags_count":19,"template":false,"template_full_name":null,"purl":"pkg:github/ESCOMP/mizuRoute","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ESCOMP%2FmizuRoute","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ESCOMP%2FmizuRoute/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ESCOMP%2FmizuRoute/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ESCOMP%2FmizuRoute/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ESCOMP","download_url":"https://codeload.github.com/ESCOMP/mizuRoute/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ESCOMP%2FmizuRoute/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31867712,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-15T15:24:51.572Z","status":"online","status_checked_at":"2026-04-16T02:00:06.042Z","response_time":69,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":"ESCOMP","name":"Earth System Community Modeling Portal","uuid":"33552285","kind":"organization","description":"","email":null,"website":"https://escomp.github.io/","location":null,"twitter":null,"company":null,"icon_url":"https://avatars.githubusercontent.com/u/33552285?v=4","repositories_count":65,"last_synced_at":"2024-06-05T19:10:08.483Z","metadata":{"has_sponsors_listing":false},"html_url":"https://github.com/ESCOMP","funding_links":[],"total_stars":842,"followers":99,"following":0,"created_at":"2022-11-11T11:04:09.366Z","updated_at":"2024-06-05T19:10:12.028Z","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ESCOMP","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ESCOMP/repositories"},"packages":[],"commits":{"id":1320072,"full_name":"ESCOMP/mizuRoute","default_branch":"main","total_commits":1599,"total_committers":18,"total_bot_commits":0,"total_bot_committers":0,"mean_commits":88.83333333333333,"dds":0.38086303939962474,"past_year_total_commits":225,"past_year_total_committers":6,"past_year_total_bot_commits":0,"past_year_total_bot_committers":0,"past_year_mean_commits":37.5,"past_year_dds":0.09333333333333338,"last_synced_at":"2026-04-14T01:02:22.057Z","last_synced_commit":"ccc3c33b2c70059d3461357306bf7fa8935cc91b","created_at":"2023-09-11T14:50:35.622Z","updated_at":"2026-04-14T01:01:24.514Z","committers":[{"name":"Naoki Mizukami","email":"mizukami@ucar.edu","login":"nmizukami","count":990},{"name":"Erik Kluzek","email":"erik@ucar.edu","login":"ekluzek","count":263},{"name":"mizukami","email":"mizukami@hydro-c1.rap.ucar.edu","login":null,"count":70},{"name":"ShervanGharari","email":"shg096@gra-login3.graham.sharcnet","login":null,"count":59},{"name":"ShervanGharari","email":"sh.gharari@gmail.com","login":"ShervanGharari","count":54},{"name":"Martyn Clark","email":"mclark@ucar.edu","login":null,"count":52},{"name":"ShervanGharari","email":"shg096@gra-login1.graham.sharcnet","login":null,"count":44},{"name":"ShervanGharari","email":"shg096@gra-login2.graham.sharcnet","login":null,"count":43},{"name":"ivanderkelen","email":"inne.vanderkelen@vub.be","login":"Ivanderkelen","count":10},{"name":"Naoki Mizukami","email":"mizukami@uncertainty.rap.ucar.edu","login":null,"count":5},{"name":"James Edwards","email":"jedwards@ucar.edu","login":"jedwards4b","count":2},{"name":"Bill Sacks","email":"sacks@ucar.edu","login":"billsacks","count":1},{"name":"Bart Nijssen","email":"nijssen@uw.edu","login":"bartnijssen","count":1},{"name":"Brian Dobbins","email":"bdobbins@gmail.com","login":"briandobbins","count":1},{"name":"Wouter Knoben","email":"wouter.knoben@usask.ca","login":"wknoben","count":1},{"name":"Naoki Mizukami","email":"mizukami@gra-login2.graham.sharcnet","login":null,"count":1},{"name":"Hongli Liu","email":"hongliliu@Honglis-MacBook-Pro.local","login":null,"count":1},{"name":"kdraeder","email":"raeder@ucar.edu","login":"kdraeder","count":1}],"past_year_committers":[{"name":"Naoki Mizukami","email":"mizukami@ucar.edu","login":"nmizukami","count":204},{"name":"ShervanGharari","email":"sh.gharari@gmail.com","login":"ShervanGharari","count":13},{"name":"Erik Kluzek","email":"erik@ucar.edu","login":"ekluzek","count":5},{"name":"kdraeder","email":"raeder@ucar.edu","login":"kdraeder","count":1},{"name":"Jim Edwards","email":"jedwards@ucar.edu","login":"jedwards4b","count":1},{"name":"Bill Sacks","email":"sacks@ucar.edu","login":"billsacks","count":1}],"commits_url":"https://commits.ecosyste.ms/api/v1/hosts/GitHub/repositories/ESCOMP%2FmizuRoute/commits","host":{"name":"GitHub","url":"https://github.com","kind":"github","last_synced_at":"2026-04-16T00:00:20.271Z","repositories_count":6213671,"commits_count":900161423,"contributors_count":34924161,"owners_count":1144720,"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":"ESCOMP/mizuRoute","html_url":"https://github.com/ESCOMP/mizuRoute","last_synced_at":"2026-04-15T01:02:54.308Z","status":null,"issues_count":104,"pull_requests_count":121,"avg_time_to_close_issue":21230914.14925373,"avg_time_to_close_pull_request":990286.6875,"issues_closed_count":66,"pull_requests_closed_count":96,"pull_request_authors_count":7,"issue_authors_count":13,"avg_comments_per_issue":3.1346153846153846,"avg_comments_per_pull_request":0.7768595041322314,"merged_pull_requests_count":90,"bot_issues_count":0,"bot_pull_requests_count":4,"past_year_issues_count":12,"past_year_pull_requests_count":23,"past_year_avg_time_to_close_issue":1473981.0,"past_year_avg_time_to_close_pull_request":252674.75,"past_year_issues_closed_count":2,"past_year_pull_requests_closed_count":8,"past_year_pull_request_authors_count":5,"past_year_issue_authors_count":5,"past_year_avg_comments_per_issue":1.0833333333333333,"past_year_avg_comments_per_pull_request":0.30434782608695654,"past_year_bot_issues_count":0,"past_year_bot_pull_requests_count":1,"past_year_merged_pull_requests_count":8,"created_at":"2023-09-11T14:51:08.816Z","updated_at":"2026-04-15T01:02:54.309Z","repository_url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/repositories/ESCOMP%2FmizuRoute","issues_url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/repositories/ESCOMP%2FmizuRoute/issues","issue_labels_count":{"cesm-coupling":50,"bug":34,"enhancement":27,"standalone":15,"science":7,"high priority":6,"cleanup":6,"discussions":5,"infrastructure":5,"question":4,"bugfix":3,"new features":3,"help wanted":2,"no answer change":1,"low priority":1,"wontfix":1,"documentation":1},"pull_request_labels_count":{"standalone":60,"cesm-coupling":58,"bugfix":31,"new features":25,"enhancement":24,"cleanup":20,"science":16,"documentation":10,"infrastructure":5,"no answer change":5,"dependencies":4,"WIP [DO NOT MERGE]":2,"python":1},"issue_author_associations_count":{"COLLABORATOR":89,"NONE":15},"pull_request_author_associations_count":{"COLLABORATOR":113,"NONE":6,"CONTRIBUTOR":2},"issue_authors":{"ekluzek":61,"nmizukami":23,"ShervanGharari":5,"PrateekSharma99":4,"BernardoTeufel":3,"shuihou":1,"h294liu":1,"DIPESHSINGHCHUPHAL":1,"rogerzzl":1,"AlaBahrami":1,"wknoben":1,"kasra-keshavarz":1,"csun15":1},"pull_request_authors":{"nmizukami":100,"ShervanGharari":7,"ekluzek":6,"dependabot[bot]":4,"jedwards4b":2,"kdraeder":1,"briandobbins":1},"host":{"name":"GitHub","url":"https://github.com","kind":"github","last_synced_at":"2026-04-16T00:00:09.014Z","repositories_count":14278736,"issues_count":34603228,"pull_requests_count":113215899,"authors_count":11235550,"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":{"cesm-coupling":3,"cleanup":2,"standalone":2,"enhancement":2,"bug":1,"no answer change":1,"science":1,"documentation":1},"past_year_pull_request_labels_count":{"standalone":9,"cesm-coupling":7,"documentation":6,"no answer change":5,"bugfix":5,"enhancement":4,"cleanup":3,"new features":2,"WIP [DO NOT MERGE]":1,"dependencies":1,"infrastructure":1,"python":1,"science":1},"past_year_issue_author_associations_count":{"COLLABORATOR":8,"NONE":4},"past_year_pull_request_author_associations_count":{"COLLABORATOR":20,"NONE":2,"CONTRIBUTOR":1},"past_year_issue_authors":{"nmizukami":5,"ekluzek":3,"BernardoTeufel":2,"csun15":1,"PrateekSharma99":1},"past_year_pull_request_authors":{"nmizukami":18,"ShervanGharari":2,"dependabot[bot]":1,"ekluzek":1,"kdraeder":1},"maintainers":[{"login":"nmizukami","count":123,"url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/authors/nmizukami"},{"login":"ekluzek","count":67,"url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/authors/ekluzek"},{"login":"ShervanGharari","count":11,"url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/authors/ShervanGharari"},{"login":"briandobbins","count":1,"url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/authors/briandobbins"}],"active_maintainers":[{"login":"nmizukami","count":23,"url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/authors/nmizukami"},{"login":"ekluzek","count":4,"url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/authors/ekluzek"},{"login":"ShervanGharari","count":1,"url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/authors/ShervanGharari"}]},"events":{"total":{"ReleaseEvent":2,"DeleteEvent":6,"MemberEvent":4,"PullRequestEvent":122,"ForkEvent":15,"DiscussionEvent":1,"IssuesEvent":61,"WatchEvent":6,"IssueCommentEvent":153,"PushEvent":55,"PullRequestReviewCommentEvent":130,"PullRequestReviewEvent":99,"GollumEvent":50,"CreateEvent":8},"last_year":{"ReleaseEvent":1,"DeleteEvent":2,"MemberEvent":3,"PullRequestEvent":74,"ForkEvent":6,"DiscussionEvent":1,"IssuesEvent":30,"WatchEvent":2,"IssueCommentEvent":73,"PushEvent":31,"PullRequestReviewCommentEvent":105,"GollumEvent":28,"PullRequestReviewEvent":72,"CreateEvent":4}},"keywords":["climate","hydrology","river"],"dependencies":[],"score":7.5251007461258,"created_at":"2026-03-22T11:05:01.019Z","updated_at":"2026-04-17T02:30:18.566Z","avatar_url":"https://github.com/ESCOMP.png","language":"Fortran","category":"Hydrosphere","sub_category":"Freshwater and Hydrology","monthly_downloads":0,"total_dependent_repos":0,"total_dependent_packages":0,"readme":"[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.595402.svg)](https://doi.org/10.5281/zenodo.595402)\n[![Documentation Status](https://readthedocs.org/projects/mizuroute/badge/?version=main)](https://mizuroute.readthedocs.io/en/main/?badge=main)\n[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://www.apache.org/licenses/LICENSE-2.0)\n\n# mizuRoute\nMizuRoute is a tool that takes runoff data from a hydrologic or land surface model to compute streamflow in a user-defined catchment-based (vector) river network.\nA user can add Lakes into the river network, allowing the model to simulate discharge and volume in rivers and lakes (natural lakes or reservoir).\n\nMizuRoute uses Message Passing Interface (MPI) for parallel computing to work on multi-decdal to a century simulation over large river networks (e.g., the river network over the contiguous United States).\n\nMizuRoute can be run in two ways: \n\n1. Stand-alone mode - users needs provides their own runoff time series as a model input. \n2. CESM coupled model - MizuRoute runs as a river model component in Community Earth System Model (CESM).\nCurrently, mizuRoute is coupled to Community Terrestrial Systems Model ([CTSM](https://github.com/ESCOMP/CTSM)), the land-model component of CESM. \n\n\n## To get started for a stand-alone mode\n1. Obtaining mizuRoute package. Just to use the tool, download the package by clicking “Download Zip” button on right column. \n\n2. To compile the codes, and prepare for the input data, please refer to [User's Guide](https://mizuroute.readthedocs.io/en/main/)\n\n3. A user is encouraged to start with example data to get familiarize the process. Link to testCase data are given in [testCase data](https://mizuroute.readthedocs.io/en/main/users_guide/testCase.html) in User's Guide.\n\n## To get started for ctsm coupling mode\n\nUser interested in using mizuRoute with CTSM is referred to CESM's user guide. Here, quick guide is provided.  \n\n1. Obtain CTSM code from [github](https://github.com/ESCOMP/CTSM/tree/master)\n\n2. Create the case\n\n   ```bash\n   cd cime/scripts\n   ```\n\n   ```bash\n   ./create_newcase --case \u003ctestcase\u003e --mach derecho --res f09_f09_rHDMAlk_mg17 -compset I2000Clm60SpMizGs \n   ```\n   (`./create_newcase -help --` to get help on the script)\n\n3. Setup the case\n\n   ```bash\n   cd \u003ctestcase\u003e\n   ```\n\n   ```bash\n   ./xmlchange id1=val1,id2=val2  # to make changes to any settings in the env_*.xml files\n   ./case.setup\n   ```\n   (./case.setup -help -- to get help on the script)\n\n3. Add any namelist changes to the `user_nl_*` files\n\n   ```bash\n   $EDITOR user_nl_*\n   ```\n\n4. Compile the code\n\n   ```bash\n   ./case.build\n   ```\n\n5. Submit the run\n\n   ```bash\n   ./case.submit\n   ```\n\n## Prerequisite \n 1. Linux commands.\n 2. Geographic Information System to develop and visualize river network data\n 3. python or similar other languages to analyze/visualize data, prepare for the input\n 4. Fortran (if a user desires to change the codes)\n\n\n## Funding\n - U.S. Army Corps of Engineers\n - Bureau of Reclamation\n - NASA’s Advanced Information Systems Technology program\n - National Science Foundation\n\n\nLICENSE\n-------\n\nmizuRoute is [licensed](LICENSE.txt) under Apache 2.0\n","funding_links":[],"readme_doi_urls":["https://doi.org/10.5281/zenodo.595402"],"works":{},"citation_counts":{},"total_citations":0,"keywords_from_contributors":["earth-system-model","climate-model","datamodeling","cesm","clm","ecosystem","land","land-surface-model","ncar","snl-applications"],"project_url":"https://ost.ecosyste.ms/api/v1/projects/349246","html_url":"https://ost.ecosyste.ms/projects/349246"}