iudsim README

The project's README from github.com/THU-iUWLab/iudsim. As one markdown file: README.md.

IUDSim

介绍

城市排水系统是城市重要基础设施,承担着抵御内涝保障居民生命财产与出行秩序,以及控制污染保障受纳水体水质安全等诸多功能。国内外研究广泛采用SWMM、Infoworks、MIKE等排水系统模拟模型,但这些模型除少数开源模型外费用高昂,同时缺乏对管网、污水厂、河道及地表迁移过程的集成模拟。 在这样的背景下,iUWLab开发了能够实现“事件驱动-设施状态-社会响应-环境质量”全过程紧耦合模拟的城市排水系统模拟器(Integrated Urban Drainage Simulator,IUDSim),实现了“人-地-网-厂-河”互作关系的动态刻画,为城市排水系统管理提供模型支撑。

软件架构

IUDSim包括地表、管网、污水厂、河流和人类轨迹五个模块。

  1. 地表模块 采用霍顿方程计算降雨后的地表下渗量,基于元胞自动机模拟地表径流流动。当径流到达管网节点所在网格时,转入管网模块继续模拟。
  2. 管网模块 通过圣维南方程计算管网水流动力学,同时追踪总悬浮物、COD、总氮、总磷、氨氮的迁移转化,包括管道内污染物反应和污泥沉积与冲刷过程等过程。若节点发生内涝,转入地表模块模拟地表水流迁移和下渗过程。
  3. 污水厂模块 污水厂模块接受管网模块的水力水质输出,基于ASM2d模拟脱氮除磷等过程,处理后的尾水进入河流模块进行模拟。
  4. 河流模块 河流模块接受污水厂、管网和地表的水力水质输出,基于RWQM1建模为明渠进行模拟,考虑了河流的顶托作用对污水厂出水和管网排水的影响,并分析了河水漫上堤岸和地表径流直接流入河流的过程。
  5. 人流轨迹模块 基于职住数据,采用最短路算法生成上下班路径。实时读取网格内涝水深,若水深超过阈值,居民路径动态调整为绕行路线。职住位置分布还通过用水量变化间接影响管网模块的水量负荷。

安装教程

  1. 下载仓库到本地。
  2. 确保本机安装了Microsoft Visual C++ 2015-2022 Redistributable (x64),若未安装,可进入install文件夹,双击vc_redist.x64.exe安装。
  3. 打开software/console,双击IUDSim.exe即可运行。

使用说明

参见软件操作手册.pdf。

压缩包解压密码获取方式

为帮助我们更好地提升软件功能,请您填写以下问卷,在提交问卷后页面会显示IUDSim压缩包的解压密码。感谢您的支持与配合!
https://www.wjx.cn/vm/PrHM4IZ.aspx#

联系我们

[email protected]
[email protected]

iudsim (THU-iUWLab/iudsim)

Searching Database…

247 ·GitHub
What is this?IUDSim (Integrated Urban Drainage Simulator) is an urban drainage system simulator built by Tsinghua's iUWLab that tightly couples surface runoff, pipe networks, wastewater treatment, rivers, and human movement into one simulation to model the full event-facility-social-environmental process chain.
Is this a standalone app or a library I'd plug into something?It is a standalone Windows desktop application with a console-style executable; you launch it directly, there's nothing to import into another project.
How do I get it running?Download the repository, install the required Microsoft redistributable if missing, then double-click IUDSim.exe inside the software/console folder to launch it.
Do I need to install anything before running IUDSim.exe?Yes, you need the Microsoft Visual C++ 2015-2022 Redistributable (x64); a copy (vcredist.x64.exe) is bundled in the repo's install folder if you don't already have it.
Is the download ready to use right away?No — the distributed archive is password-protected. You have to fill out a short questionnaire first, and the extraction password is shown after submitting it.
Who is this aimed at?It's aimed at urban drainage researchers and municipal managers studying flooding, sewer network performance, and pollutant transport, reflecting its origin in Tsinghua's urban water lab (iUWLab).
What are IUDSim's five simulation modules?Surface (Horton infiltration and cellular-automaton runoff), pipe network (Saint-Venant hydraulics with pollutant tracking), wastewater treatment plant (ASM2d), river (RWQM1 open-channel model), and a human-trajectory module that routes commuters based on shortest paths.
How is IUDSim different from tools like SWMM or MIKE?Unlike SWMM or MIKE, which typically model only a single compartment, IUDSim tightly couples surface, pipe network, treatment plant, river and human movement in one integrated simulation, aiming to capture the whole urban drainage system at once.
How does flooding affect the simulated people in the model?The human-trajectory module reads real-time flood depth on each grid cell during a simulation; if depth exceeds a threshold, a resident's commuting path is dynamically rerouted to avoid the flooded area.
Where do I find detailed usage instructions?The included '软件操作手册.pdf' (software operation manual) covers how to use IUDSim in detail.
Creator
THU-iUWLab
Size
167.7 MB
Stars
247
Updated
CommitJul 02
Age
2mo
Commits · 90 Days