{"id":23794,"name":"python-for-hydrology","description":"Focusing on general python for data analysis in hydrologic contexts and the python interface into MODFLOW for groundwater modeling.","url":"https://github.com/DOI-USGS/python-for-hydrology","last_synced_at":"2026-04-11T16:30:38.147Z","repository":{"id":59840339,"uuid":"537542085","full_name":"DOI-USGS/python-for-hydrology","owner":"DOI-USGS","description":"python and flopy tutorials for hydrologic applications and MODFLOW modeling","archived":false,"fork":false,"pushed_at":"2025-09-26T14:27:59.000Z","size":514294,"stargazers_count":62,"open_issues_count":1,"forks_count":22,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-10-25T06:14:05.129Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Jupyter Notebook","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/DOI-USGS.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":"CODE_OF_CONDUCT.md","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":"2022-09-16T16:44:54.000Z","updated_at":"2025-10-19T03:26:56.000Z","dependencies_parsed_at":"2025-01-09T10:13:59.994Z","dependency_job_id":"3ce75a34-f1a8-4b7b-bd93-233bebc9f3dc","html_url":"https://github.com/DOI-USGS/python-for-hydrology","commit_stats":{"total_commits":204,"total_committers":5,"mean_commits":40.8,"dds":0.5784313725490196,"last_synced_commit":"ead60e56250172e3a94d881222bbf42c72567df9"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/DOI-USGS/python-for-hydrology","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DOI-USGS%2Fpython-for-hydrology","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DOI-USGS%2Fpython-for-hydrology/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DOI-USGS%2Fpython-for-hydrology/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DOI-USGS%2Fpython-for-hydrology/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DOI-USGS","download_url":"https://codeload.github.com/DOI-USGS/python-for-hydrology/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DOI-USGS%2Fpython-for-hydrology/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":281068936,"owners_count":26438554,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-26T02:00:06.575Z","response_time":61,"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":"DOI-USGS","name":"U.S. Geological Survey","uuid":"65027635","kind":"organization","description":"By integrating our diverse scientific expertise, we understand complex natural science phenomena and provide scientific products that lead to solutions.","email":"gs_help_git@usgs.gov","website":"https://www.usgs.gov/","location":"United States of America","twitter":"USGS","company":null,"icon_url":"https://avatars.githubusercontent.com/u/65027635?v=4","repositories_count":59,"last_synced_at":"2023-06-11T08:40:17.441Z","metadata":{"has_sponsors_listing":false},"html_url":"https://github.com/DOI-USGS","funding_links":[],"total_stars":null,"followers":null,"following":null,"created_at":"2022-11-05T08:13:26.577Z","updated_at":"2023-06-11T08:40:17.459Z","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DOI-USGS","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DOI-USGS/repositories"},"packages":[],"commits":{"id":1356828,"full_name":"DOI-USGS/python-for-hydrology","default_branch":"main","total_commits":367,"total_committers":11,"total_bot_commits":0,"total_bot_committers":0,"mean_commits":33.36363636363637,"dds":0.6158038147138964,"past_year_total_commits":81,"past_year_total_committers":9,"past_year_total_bot_commits":0,"past_year_total_bot_committers":0,"past_year_mean_commits":9.0,"past_year_dds":0.7283950617283951,"last_synced_at":"2025-10-22T23:58:32.406Z","last_synced_commit":"4aedfab077745037037f45904b6f55fc2bf5af85","created_at":"2023-09-12T11:51:04.854Z","updated_at":"2025-10-22T23:58:10.293Z","committers":[{"name":"Mike Fienen","email":"mnfienen@usgs.gov","login":"mnfienen","count":141},{"name":"Leaf, Andrew T","email":"aleaf@usgs.gov","login":"aleaf","count":98},{"name":"jlarsen","email":"jlarsen@usgs.gov","login":"jlarsen-usgs","count":68},{"name":"Joseph Hughes","email":"jdhughes@usgs.gov","login":"jdhughes-usgs","count":27},{"name":"ncorson-dosch","email":"ncorson-dosch@usgs.gov","login":"ntdosch","count":11},{"name":"Langevin, Christian D","email":"langevin@usgs.gov","login":"langevin-usgs","count":9},{"name":"Laura DeCicco","email":"ldecicco@usgs.gov","login":"ldecicco-USGS","count":4},{"name":"Jahn, Kalle L","email":"kjahn@usgs.gov","login":null,"count":4},{"name":"Mike Taves","email":"mwtoews@gmail.com","login":"mwtoews","count":2},{"name":"George Dang","email":"53052793+gtdang","login":"gtdang","count":2},{"name":"wpbonelli","email":"wbonelli@ucar.edu","login":"w-bonelli","count":1}],"past_year_committers":[{"name":"Mike Fienen","email":"mnfienen@usgs.gov","login":"mnfienen","count":22},{"name":"jlarsen-usgs","email":"jlarsen@usgs.gov","login":"jlarsen-usgs","count":18},{"name":"Leaf, Andrew T","email":"aleaf@usgs.gov","login":"aleaf","count":17},{"name":"ncorson-dosch","email":"ncorson-dosch@usgs.gov","login":"ntdosch","count":11},{"name":"Laura DeCicco","email":"ldecicco@usgs.gov","login":"ldecicco-USGS","count":4},{"name":"Jahn, Kalle L","email":"kjahn@usgs.gov","login":null,"count":4},{"name":"Mike Taves","email":"mwtoews@gmail.com","login":"mwtoews","count":2},{"name":"George Dang","email":"53052793+gtdang","login":"gtdang","count":2},{"name":"wpbonelli","email":"wbonelli@ucar.edu","login":"w-bonelli","count":1}],"commits_url":"https://commits.ecosyste.ms/api/v1/hosts/GitHub/repositories/DOI-USGS%2Fpython-for-hydrology/commits","host":{"name":"GitHub","url":"https://github.com","kind":"github","last_synced_at":"2025-10-25T00:00:16.883Z","repositories_count":6087540,"commits_count":922327189,"contributors_count":35995347,"owners_count":1108987,"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":"DOI-USGS/python-for-hydrology","html_url":"https://github.com/DOI-USGS/python-for-hydrology","last_synced_at":"2025-10-06T23:46:38.674Z","status":"error","issues_count":16,"pull_requests_count":228,"avg_time_to_close_issue":5977238.888888889,"avg_time_to_close_pull_request":17545.336492890994,"issues_closed_count":9,"pull_requests_closed_count":211,"pull_request_authors_count":10,"issue_authors_count":5,"avg_comments_per_issue":0.5,"avg_comments_per_pull_request":0.12280701754385964,"merged_pull_requests_count":209,"bot_issues_count":0,"bot_pull_requests_count":0,"past_year_issues_count":7,"past_year_pull_requests_count":42,"past_year_avg_time_to_close_issue":5924024.5,"past_year_avg_time_to_close_pull_request":31552.235294117647,"past_year_issues_closed_count":2,"past_year_pull_requests_closed_count":34,"past_year_pull_request_authors_count":8,"past_year_issue_authors_count":3,"past_year_avg_comments_per_issue":0.42857142857142855,"past_year_avg_comments_per_pull_request":0.4523809523809524,"past_year_bot_issues_count":0,"past_year_bot_pull_requests_count":0,"past_year_merged_pull_requests_count":34,"created_at":"2023-09-12T11:51:11.107Z","updated_at":"2025-10-06T23:46:38.674Z","repository_url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/repositories/DOI-USGS%2Fpython-for-hydrology","issues_url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/repositories/DOI-USGS%2Fpython-for-hydrology/issues","issue_labels_count":{},"pull_request_labels_count":{},"issue_author_associations_count":{"COLLABORATOR":9,"CONTRIBUTOR":5,"NONE":2},"pull_request_author_associations_count":{"CONTRIBUTOR":126,"COLLABORATOR":96,"NONE":6},"issue_authors":{"mnfienen":9,"langevin-usgs":2,"mcekiz":2,"jlarsen-usgs":2,"aleaf":1},"pull_request_authors":{"mnfienen":96,"aleaf":48,"jlarsen-usgs":30,"jdhughes-usgs":27,"langevin-usgs":14,"ntdosch":6,"kallejahn":2,"mwtoews":2,"gtdang":2,"wpbonelli":1},"host":{"name":"GitHub","url":"https://github.com","kind":"github","last_synced_at":"2025-10-29T00:00:18.463Z","repositories_count":11231576,"issues_count":34951320,"pull_requests_count":113363389,"authors_count":11041952,"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":{"COLLABORATOR":4,"NONE":2,"CONTRIBUTOR":1},"past_year_pull_request_author_associations_count":{"CONTRIBUTOR":22,"COLLABORATOR":15,"NONE":5},"past_year_issue_authors":{"mnfienen":4,"mcekiz":2,"jlarsen-usgs":1},"past_year_pull_request_authors":{"mnfienen":15,"jlarsen-usgs":8,"aleaf":6,"ntdosch":6,"kallejahn":2,"gtdang":2,"mwtoews":2,"wpbonelli":1},"maintainers":[{"login":"mnfienen","count":105,"url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/authors/mnfienen"}],"active_maintainers":[{"login":"mnfienen","count":19,"url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/authors/mnfienen"}]},"events":{"total":{"IssuesEvent":7,"WatchEvent":20,"IssueCommentEvent":20,"PushEvent":44,"PullRequestEvent":38,"ForkEvent":8},"last_year":{"IssuesEvent":7,"WatchEvent":18,"IssueCommentEvent":20,"PushEvent":44,"PullRequestEvent":38,"ForkEvent":7}},"keywords":[],"dependencies":[{"ecosystem":"actions","filepath":".github/workflows/test.yaml","sha":null,"kind":"manifest","created_at":"2023-01-21T03:03:26.121Z","updated_at":"2023-01-21T03:03:26.121Z","repository_link":"https://github.com/DOI-USGS/python-for-hydrology/blob/main/.github/workflows/test.yaml","dependencies":[{"id":7072377544,"package_name":"actions/checkout","ecosystem":"actions","requirements":"v2","direct":true,"kind":"composite","optional":false},{"id":7072377549,"package_name":"actions/cache","ecosystem":"actions","requirements":"v2.1.0","direct":true,"kind":"composite","optional":false},{"id":7072377551,"package_name":"conda-incubator/setup-miniconda","ecosystem":"actions","requirements":"v2","direct":true,"kind":"composite","optional":false},{"id":7072377553,"package_name":"modflowpy/install-modflow-action","ecosystem":"actions","requirements":"v1","direct":true,"kind":"composite","optional":false}]},{"ecosystem":"actions","filepath":".github/workflows/notebook-output.yaml","sha":null,"kind":"manifest","created_at":"2024-02-04T18:31:26.550Z","updated_at":"2024-02-04T18:31:26.550Z","repository_link":"https://github.com/DOI-USGS/python-for-hydrology/blob/main/.github/workflows/notebook-output.yaml","dependencies":[{"id":16024333310,"package_name":"actions/checkout","ecosystem":"actions","requirements":"v3","direct":true,"kind":"composite","optional":false},{"id":16024333317,"package_name":"mamba-org/setup-micromamba","ecosystem":"actions","requirements":"main","direct":true,"kind":"composite","optional":false}]},{"ecosystem":"actions","filepath":".github/workflows/build_docs.yaml","sha":null,"kind":"manifest","created_at":"2024-02-08T22:14:54.013Z","updated_at":"2024-02-08T22:14:54.013Z","repository_link":"https://github.com/DOI-USGS/python-for-hydrology/blob/main/.github/workflows/build_docs.yaml","dependencies":[{"id":16121020631,"package_name":"actions/checkout","ecosystem":"actions","requirements":"v3","direct":true,"kind":"composite","optional":false},{"id":16121020632,"package_name":"mamba-org/setup-micromamba","ecosystem":"actions","requirements":"v1","direct":true,"kind":"composite","optional":false},{"id":16121020633,"package_name":"modflowpy/install-modflow-action","ecosystem":"actions","requirements":"v1","direct":true,"kind":"composite","optional":false},{"id":16121021587,"package_name":"JamesIves/github-pages-deploy-action","ecosystem":"actions","requirements":"3.7.1","direct":true,"kind":"composite","optional":false}]},{"ecosystem":"actions","filepath":".github/workflows/notebook-headers.yaml","sha":null,"kind":"manifest","created_at":"2024-04-12T16:35:28.416Z","updated_at":"2024-04-12T16:35:28.416Z","repository_link":"https://github.com/DOI-USGS/python-for-hydrology/blob/main/.github/workflows/notebook-headers.yaml","dependencies":[{"id":17384330559,"package_name":"actions/checkout","ecosystem":"actions","requirements":"v4","direct":true,"kind":"composite","optional":false},{"id":17384330560,"package_name":"mamba-org/setup-micromamba","ecosystem":"actions","requirements":"main","direct":true,"kind":"composite","optional":false}]},{"ecosystem":"conda","filepath":"installation/environment.yml","sha":null,"kind":"manifest","created_at":"2025-01-09T10:13:46.680Z","updated_at":"2025-01-09T10:13:46.680Z","repository_link":"https://github.com/DOI-USGS/python-for-hydrology/blob/main/installation/environment.yml","dependencies":[{"id":21419693927,"package_name":"affine","ecosystem":"conda","requirements":"","direct":true,"kind":"runtime","optional":false},{"id":21419693928,"package_name":"dataretrieval","ecosystem":"conda","requirements":"","direct":true,"kind":"runtime","optional":false},{"id":21419693936,"package_name":"descartes","ecosystem":"conda","requirements":"","direct":true,"kind":"runtime","optional":false},{"id":21419693937,"package_name":"fiona","ecosystem":"conda","requirements":"","direct":true,"kind":"runtime","optional":false},{"id":21419693943,"package_name":"flopy","ecosystem":"conda","requirements":"\u003e=3.7","direct":true,"kind":"runtime","optional":false},{"id":21419693955,"package_name":"geojson","ecosystem":"conda","requirements":"","direct":true,"kind":"runtime","optional":false},{"id":21419693992,"package_name":"geopandas","ecosystem":"conda","requirements":"","direct":true,"kind":"runtime","optional":false},{"id":21419694136,"package_name":"geos","ecosystem":"conda","requirements":"","direct":true,"kind":"runtime","optional":false},{"id":21419694155,"package_name":"gis-utils","ecosystem":"conda","requirements":"","direct":true,"kind":"runtime","optional":false},{"id":21419694162,"package_name":"git","ecosystem":"conda","requirements":"","direct":true,"kind":"runtime","optional":false},{"id":21419694285,"package_name":"imageio","ecosystem":"conda","requirements":"","direct":true,"kind":"runtime","optional":false},{"id":21419694289,"package_name":"jupyter","ecosystem":"conda","requirements":"","direct":true,"kind":"runtime","optional":false},{"id":21419694588,"package_name":"jupyterlab","ecosystem":"conda","requirements":"","direct":true,"kind":"runtime","optional":false},{"id":21419694589,"package_name":"jupytext","ecosystem":"conda","requirements":"","direct":true,"kind":"runtime","optional":false},{"id":21419694595,"package_name":"matplotlib","ecosystem":"conda","requirements":"","direct":true,"kind":"runtime","optional":false},{"id":21419694596,"package_name":"modflow-export","ecosystem":"conda","requirements":"","direct":true,"kind":"runtime","optional":false},{"id":21419694597,"package_name":"modflow-setup","ecosystem":"conda","requirements":"","direct":true,"kind":"runtime","optional":false},{"id":21419694598,"package_name":"netcdf4","ecosystem":"conda","requirements":"","direct":true,"kind":"runtime","optional":false},{"id":21419694599,"package_name":"numpy","ecosystem":"conda","requirements":"","direct":true,"kind":"runtime","optional":false},{"id":21419694600,"package_name":"openpyxl","ecosystem":"conda","requirements":"","direct":true,"kind":"runtime","optional":false},{"id":21419694602,"package_name":"pandas","ecosystem":"conda","requirements":"","direct":true,"kind":"runtime","optional":false},{"id":21419694603,"package_name":"pip","ecosystem":"conda","requirements":"","direct":true,"kind":"runtime","optional":false},{"id":21419694604,"package_name":"pyproj","ecosystem":"conda","requirements":"","direct":true,"kind":"runtime","optional":false},{"id":21419694606,"package_name":"pyshp","ecosystem":"conda","requirements":"","direct":true,"kind":"runtime","optional":false},{"id":21419694674,"package_name":"pytest","ecosystem":"conda","requirements":"","direct":true,"kind":"runtime","optional":false},{"id":21419695003,"package_name":"python","ecosystem":"conda","requirements":"3.11.*","direct":true,"kind":"runtime","optional":false},{"id":21419695004,"package_name":"python-dateutil","ecosystem":"conda","requirements":"","direct":true,"kind":"runtime","optional":false},{"id":21419695166,"package_name":"pyvista","ecosystem":"conda","requirements":"","direct":true,"kind":"runtime","optional":false},{"id":21419695167,"package_name":"pyyaml","ecosystem":"conda","requirements":"","direct":true,"kind":"runtime","optional":false},{"id":21419695168,"package_name":"rasterio","ecosystem":"conda","requirements":"","direct":true,"kind":"runtime","optional":false},{"id":21419695260,"package_name":"rasterstats","ecosystem":"conda","requirements":"","direct":true,"kind":"runtime","optional":false},{"id":21419695261,"package_name":"requests","ecosystem":"conda","requirements":"","direct":true,"kind":"runtime","optional":false},{"id":21419695262,"package_name":"rioxarray","ecosystem":"conda","requirements":"","direct":true,"kind":"runtime","optional":false},{"id":21419695809,"package_name":"rtree","ecosystem":"conda","requirements":"","direct":true,"kind":"runtime","optional":false},{"id":21419695812,"package_name":"scipy","ecosystem":"conda","requirements":"","direct":true,"kind":"runtime","optional":false},{"id":21419695813,"package_name":"sfrmaker","ecosystem":"conda","requirements":"","direct":true,"kind":"runtime","optional":false},{"id":21419695830,"package_name":"shapely","ecosystem":"conda","requirements":"","direct":true,"kind":"runtime","optional":false},{"id":21419695944,"package_name":"statsmodels","ecosystem":"conda","requirements":"","direct":true,"kind":"runtime","optional":false},{"id":21419695977,"package_name":"uxarray","ecosystem":"conda","requirements":"","direct":true,"kind":"runtime","optional":false},{"id":21419696088,"package_name":"vtk","ecosystem":"conda","requirements":"","direct":true,"kind":"runtime","optional":false},{"id":21419696089,"package_name":"xarray","ecosystem":"conda","requirements":"","direct":true,"kind":"runtime","optional":false},{"id":21419696090,"package_name":"xlrd","ecosystem":"conda","requirements":"","direct":true,"kind":"runtime","optional":false}]}],"score":6.541029999189903,"created_at":"2023-09-12T07:38:36.944Z","updated_at":"2026-04-11T16:30:38.150Z","avatar_url":"https://github.com/DOI-USGS.png","language":"Jupyter Notebook","category":"Sustainable Development","sub_category":"Education","monthly_downloads":0,"total_dependent_repos":0,"total_dependent_packages":0,"readme":"# python-for-hydrology\n\n[![Tests](https://github.com/DOI-USGS/python-for-hydrology/actions/workflows/test.yaml/badge.svg)](https://github.com/DOI-USGS/python-for-hydrology/actions/workflows/test.yaml)\n[![Project Status: Active – The project has reached a stable, usable state and is being actively developed.](https://www.repostatus.org/badges/latest/active.svg)](https://www.repostatus.org/#active)\n\nWelcome to the USGS python for hydrology and flopy course. This is organized into two parts: part 0 focusing on general python for data analysis in hydrologic contexts, and part 1 focusing on flopy - the python interface into MODFLOW for groundwater modeling.\n\nThe main curriculum is found in the `notebooks` folder and includes tutorial notebooks and activities.\n\nClick [here](https://doi-usgs.github.io/python-for-hydrology/latest/) to see a rendered version of the course notebooks.\n\nWe encourage students to explore these materials for their own study or to reach out to USGS to attend an in-person course.\n\nIf you are on the code.usgs.gov site, note that up-to-date changes are maintained on the version on the [GitHub](https://github.com/doi-usgs/python-for-hydrology) version.\n\nSuggested Citation:\nFienen MN, Hughes, JD, Langevin, CL, Larsen, JD, and Leaf, AT. 2024.\npython-for-hydrology \nU.S. Geological Survey software release. Reston, VA.\nhttps://doi.org/10.5066/P1QTRYJY\n","funding_links":[],"readme_doi_urls":["https://doi.org/10.5066/P1QTRYJY"],"works":{},"citation_counts":{},"total_citations":0,"keywords_from_contributors":["hydrology","groundwater","modflow","water","earth-science","prms","modflow6","surfacehydrology","swb","groundwater-modelling"],"project_url":"https://ost.ecosyste.ms/api/v1/projects/23794","html_url":"https://ost.ecosyste.ms/projects/23794"}