Metadata-Version: 2.1
Name: WFM4Cities
Version: 2.6
Summary: Water-flooding Method for urban 3D-morphology
Home-page: https://github.com/你的用户名/你的项目
Author: 张祚, 江驭鲲, 王哲
Author-email: jiangyukunccnu@163.com
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Intended Audience :: Science/Research
Classifier: Natural Language :: English
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Requires-Dist: scipy==1.13.1
Requires-Dist: scikit-learn==1.3.0
Requires-Dist: matplotlib==3.9.4
Requires-Dist: geopandas==0.13.1
Requires-Dist: shapely==2.0.6
Requires-Dist: pysal==24.1
Requires-Dist: numpy==1.25.2

﻿“地形-漫水”城市复杂空间演化模拟分析系统 V2.0

**1.1 编写背景**

该软件设计基于社会地形学理论中的分层概念以及水淹法的初始假设，对“淹水模型”进行可视化和定量分析。该软件不仅帮助研究者灵活搭建具备多样特征的复杂城市三维模型，更能方便研究者通过淹水模型的自动模拟观察城市空间形态的动态演变过程。在具体操作中，用户可以通过软件的二维模拟分析功能，实现城市空间结构“集中–分散”、“单中心-多中心”两种维度定量测度，并在此基础上，通过软件的三维模拟分析功能增强其复杂空间信息的呈现效果，刻画三维环境中的地形特征。总体而言，该软件为用户提供了一个有效的通用工具进行城市空间结构的可视化与定量分析，相比于传统二维分析方法，三维模型的嵌入无疑提供了更丰富的多维视角使得系统在模拟动态自然过程方面表现出色。

**1.2 编写目的**

对于城市规划研究人员、社会科学学者、政府管理部门及其他相关用户而言，设计“地形-漫水”城市复杂空间演化模拟分析系统的目的是提供一个高效、精准且直观的城市社会地形模拟与分析工具。在快速城市化和社会经济发展的背景下，城市空间结构呈现出日益复杂的特征，迫切需要借助先进的技术手段进行科学的空间分析与决策支持。本系统不仅考虑物理地形特征，还深度融合了社会地形因素，如人口分布、经济密集区域、基础设施布局及社会活动热点等，反映出社会活动与地形之间的复杂互动关系。例如，人口密集和经济活动繁荣的区域往往伴随着较高的社会地形，这些区域在空间演化模拟中具有重要的影响力。通过整合社会地形数据，系统能够更全面地模拟和分析不同阈值条件下城市空间结构的动态演变过程。

具体来说，系统通过构建复杂的三维城市社会地形模型，结合阈值模拟方法，实现对不同阈值条件下城市空间结构的动态演变过程的可视化和定量分析。系统能够自动处理和分析大量的地形及社会数据，确保模拟结果的准确性和一致性，显著提升分析效率。对于科研人员，系统减轻了繁重的数据处理负担，并通过丰富的二维和三维可视化工具，使研究结果更加直观和易于理解；对于政府管理人员，系统通过实时生成的模拟结果，帮助快速了解社会地形在不同阈值条件下的变化，优化城市规划和社会资源配置。

总体而言，“地形-漫水”城市复杂空间演化模拟分析系统在节省人力资源成本的同时，大幅提高了城市社会地形分析的质量和效率。系统不仅能够帮助用户深入观察和理解城市社会地形特征与空间结构动态之间的关系，还能及时、准确地满足各类用户在空间模拟、城市规划和政策制定等方面的需求。通过这一工具，用户能够更加科学地制定城市发展策略，提升城市的韧性和可持续发展能力。

**1.3 范围**

说明:

a. “地形-漫水”城市复杂空间演化模拟分析系统;

b. 该系统实现对城市社会地形数据的生成、方便赋值、迅速模拟，以及呈现模拟结果的单维可视化和多维可视化，帮助用户了解城市空间结构的动态演变。

c. “地形-漫水”城市复杂空间演化模拟分析系统的目标是为用户提供快速高效的服务，减少手工处理的繁琐与误差，及时准确地反映大规模城市社会地形数据在不同维度（如人口分布、经济密集度和基础设施布局）的模拟结果，从而提高城市空间结构分析的质量和效率。具体目标包括：

①快速导入和赋值社会地形数据

允许用户轻松导入各类城市社会地形数据，并通过直观的界面进行参数赋值，确保数据处理的高效性和便捷性。

②准确无误地进行复杂空间模拟

利用先进的模拟算法，精确模拟不同阈值条件下城市社会地形的动态演变，确保模拟结果的可靠性和一致性。

③快速、全面地提供单维及多维的可视化结果

通过丰富的二维和三维可视化工具，全面展示模拟结果，帮助用户深入理解城市空间结构的变化和发展趋势。

④支持动态分析与实时反馈

提供实时的模拟与分析功能，使用户能够即时查看不同参数设置下的模拟效果，快速调整和优化分析方案。

⑤提升决策支持与规划能力

为城市规划者和决策者提供科学、直观的分析结果，辅助制定更加合理和有效的城市发展策略，提升城市的韧性和可持续发展能力。

**1.4 定义**

数据导入与参数配置模组：主要负责城市社会地形数据的导入和模拟参数的设置。该页面提供多个滑块控件，允许用户快速设置点的数量、噪声比例、聚类数量、聚类标准差、最小距离等参数。通过直观的界面，用户可以方便地调整模拟参数，确保数据处理的高效性和准确性。此外，该页面还包含“Step1:Create 2D Plot”按钮，用户可以通过点击按钮生成二维模拟分析图形。

二维分析与可视化模组：主要负责对导入的数据进行二维模拟分析，并生成相应的可视化图形。用户可以通过点击“Step1:Create 2D Plot”按钮，生成Ripley的K函数和点数据的二维分布图。该页面集成了二维图表和相关统计分析工具，帮助用户直观理解城市社会地形的空间分布特征。同时，用户可以通过调整滑块实时更新分析参数，观察不同参数设置下的模拟结果变化。

三维模拟与动画展示模组：主要负责生成和展示城市的三维模拟结果，包括三维模型的构建、水面模拟及动态动画展示。用户可以通过设置水位比例、X/Y方向切片位置等参数，并点击“Step2:Create 3D Plot”和“Step3:Water-flooding Simulation”按钮，生成三维城市模型及其水面变化的动画。该页面集成了三维模型展示工具和动画播放功能，帮助用户深入观察和分析城市空间结构的动态演变过程。通过滑块调整，用户可以实时控制水位比例和切片位置，动态展示不同阈值条件下的城市社会地形变化。

**1.5 定义**

本系统为城市规划研究人员、社会科学学者、政府管理者等提供了一个完整的“地形-漫水”城市复杂空间演化模拟分析平台，专注于城市社会地形的动态模拟与分析。本系统旨在通过自动化的数据处理和模拟，能够迅速导入和处理大量城市社会地形数据，帮助用户高效、准确地模拟和分析不同阈值条件下城市空间结构的演变，提升城市规划和社会研究的效率。

系统通过融合物理地形和社会地形（如人口分布、经济密度等）数据，构建复杂的三维城市模型。用户可以方便地设置模拟参数，快速生成二维和三维的可视化结果，直观地观察城市空间结构在不同阈值条件下的动态变化。采用本系统，用户能够深入理解城市社会地形的演化过程，支持城市规划、灾害管理和社会经济研究，显著提升分析的科学性和系统性。

**1.6 用户特点**

用户具备一定的软件操作经验，能够快速上手并熟练使用本系统的各项功能，理解基本的模拟与分析工具。用户拥有城市规划、社会科学、地理信息系统（GIS）或相关领域的知识背景，能够理解和应用系统提供的社会地形数据和空间分析工具。

**2.3 一般约束**

操作系统：Windows 10/11

需要安装有Microsoft Excel或兼容软件以创建和查看Excel文件

至少512MB的RAM。

至少有100MB的可用硬盘空间

## **二、软件使用说明**
## **2.1控制台**
“以管理员身份运行” exe文件后会弹出软件的主控制台，其主要包括三个模块，每个模块都由参数调整滑块及运行按钮组成。模块1主要生成分布图、统计图等二维图像表征淹水模型的静态特征；模块二打造了特定设置下交互式的三维立体淹水模型；模块三的主要进行全过程动态淹水模拟，点击按钮即可自动开始。

①：该滑块设置生成的数据点数量。

②：该滑块调整数据中的随机噪声比例，模拟实际环境中的不确定性。

③：该滑块设置数据点的聚类数量。

④：该滑块设置每个聚类的空间分布和密度。

⑤：该滑块设置聚类中心之间的最小距离阈值，用于控制生成聚类时不同聚类中心之间的间隔。

Step1按钮：完成以上滑块的设置之后，点击该按钮展示二维演化模拟结果。

⑥：该滑块允许用户调整“水位”值，以模拟不同的社会地形条件。

⑦：该滑块控制三维模拟中的水平切片位置，用于观察和分析城市空间在特定水平位置的空间分布情况。

⑧：该滑块的功能是控制三维模拟中的垂直切片位置，用于观察和分析城市空间在特定垂直位置的空间分布情况。

Step2：当用户设置了所有相关参数（如点的数量、噪声比例、聚类数量等）并调整了相关滑块后，点击此按钮生成三维模拟图，并可视化城市空间的动态演化。

Step3：按钮的功能是启动“漫水模拟”过程，以动态演示社会地形在不同阈值（水位）下的变化。模拟过程中，系统实时更新社会地形的淹没范围、体积变化和表面面积等指标，并生成相关可视化图形，以帮助用户深入分析城市社会地形结构及其随阈值变化的动态演化特征。

