{"id":31592424,"url":"https://github.com/opengeoscience/uvdat-flood-sim","last_synced_at":"2026-01-23T20:12:00.352Z","repository":{"id":314496560,"uuid":"1055745485","full_name":"OpenGeoscience/uvdat-flood-sim","owner":"OpenGeoscience","description":"Dynamic flood simulation module made in collaboration with Northeastern University","archived":false,"fork":false,"pushed_at":"2025-09-28T17:24:26.000Z","size":28,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-28T18:26:11.204Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/OpenGeoscience.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2025-09-12T18:27:43.000Z","updated_at":"2025-09-28T17:24:30.000Z","dependencies_parsed_at":"2025-09-12T21:11:01.702Z","dependency_job_id":"77bf9f3e-c258-4ca8-be9b-e168d1281778","html_url":"https://github.com/OpenGeoscience/uvdat-flood-sim","commit_stats":null,"previous_names":["opengeoscience/uvdat-flood-sim"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/OpenGeoscience/uvdat-flood-sim","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenGeoscience%2Fuvdat-flood-sim","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenGeoscience%2Fuvdat-flood-sim/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenGeoscience%2Fuvdat-flood-sim/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenGeoscience%2Fuvdat-flood-sim/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/OpenGeoscience","download_url":"https://codeload.github.com/OpenGeoscience/uvdat-flood-sim/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenGeoscience%2Fuvdat-flood-sim/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278551964,"owners_count":26005482,"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-06T02:00:05.630Z","response_time":65,"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"}},"keywords":[],"created_at":"2025-10-06T03:09:16.575Z","updated_at":"2025-12-29T21:27:08.901Z","avatar_url":"https://github.com/OpenGeoscience.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Dynamic Flood Simulations\n\nCreated in collaboration with Northeastern University\n\n## Overview\n\nThis end-to-end dynamic flood simulation is intended for use with the Analytics workflow in [UVDAT (Urban Visualization and Data Analysis Toolkit)](https://github.com/OpenGeoscience/uvdat). This module consists of three parts: downscaling prediction, hydrological prediction, and hydrodynamic prediction.\n\n## Explanation\n\nFirst, an AI downscaling model uses regional climate projections to determine future local precipitation conditions, such as the intensity of extreme rainstorms. These extreme precipitation levels are fed into a hydrological model, which uses precipitation and evapotranspiration to determine runoff and discharge. Finally, a hydrodynamic model uses discharge to map flood depth over time.\n\nThis is a proof of concept for the Charles River in Boston that could be translated to other rivers and cities. The user selects the inputs described below, and the output is a flood simulation, represented as a multiframe stacked GeoTIFF raster, a time-varying map of flood depth with one frame per hour for 24 hours.\n\n## Inputs\n\n1. Time Period: the 20 year time period in which to predict a flood. Options are \"2031-2050\" and \"2041-2060\" (the former is the default).\n\n2. Annual Probability: the probability that a flood of this magnitude will occur in any given year. This value must be greater than 0 and less than 1. The default is 0.04, which represents a 1 in 25 year flood.\n\n3. Hydrograph: a list of proportions that sum to 1; these represent fractions of the total rainfall volume per timestep.\n\n4. Potential Evapotranspiration Percentile: Select the 25th, 50th, 75th, or 90th percentile value for potential evapotranspiration\n\n5. Soil Moisture Percentile: Select the 25th, 50th, 75th, or 90th percentile value for soil moisture\n\n6. Ground Water Percentile: Select the 25th, 50th, 75th, or 90th percentile value for ground water\n\n## Installation\n\n```\npip install uvdat-flood-sim\n```\n\n## Example usage\n\nTo run a flood simulation with default inputs:\n\n```\npython -m uvdat_flood_sim\n```\n\nTo see the help menu explaining how to use arguments to specify input values:\n\n```\npython -m uvdat_flood_sim --help\n```\n\n## Viewing Results\n\nBy default, results will be displayed with a `matplotlib` animation. This animation is saved in the outputs folder as `animation.gif`. Results are also saved in the outputs folder as a multiframe geospatial tiff called `flood_simulation.tif`, which can be added to UVDAT for visualization.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopengeoscience%2Fuvdat-flood-sim","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopengeoscience%2Fuvdat-flood-sim","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopengeoscience%2Fuvdat-flood-sim/lists"}