matlab+swmm

### MATLAB与SWMM集成概述

为了在MATLAB环境中集成并使用Storm Water Management Model (SWMM)，可以采用几种不同的策略来实现这一目标。一种常见的方式是通过命令行接口调用SWMM执行文件，并利用MATLAB读取和处理SWMM产生的输出数据[^1]。

另一种更高级的方法涉及创建动态链接库(DLL)形式的SWMM引擎，允许MATLAB直接与其交互而不必启动独立的应用程序实例。这种方法提供了更好的性能以及更加灵活的数据交换方式。

具体来说，在MATLAB中可以通过以下步骤完成SWMM模型的设置、运行及结果分析：

#### 1. SWMM DLL 的安装与配置

首先需要下载官方发布的SWMM源码包，并编译成适用于Windows平台下的DLL版本。接着将此DLL放置于MATLAB的工作目录下以便后续加载使用。

% 加载SWMM库到MATLAB环境
loadlibrary('swmm5.dll', 'swmm5.h');

#### 2. 初始化SWMM会话

初始化一个新的SWMM仿真会话之前，应该先关闭任何现存未结束的会话以防止冲突发生。之后便可通过`start()`函数开启新的计算过程。

if isloaded('swmm5')
    unloadlibrary swmm5;
end
loadlibrary('swmm5.dll','swmm5.h');

% 打开输入文件并开始新项目
inputFile = fullfile(matlabroot,'toolbox','example.inp'); % 输入INP路径
calllib('swmm5','project_start', inputFile);

#### 3. 运行模拟

一旦成功建立了有效的SWMM工程对象，则可以直接调用相应API来进行完整的水力/水质模拟运算操作。完成后记得释放资源确保下次能够正常工作。

% 启动模拟流程
calllib('swmm5','run_step');

while calllib('swmm5','get_status') ~= 0
    pause(0.1); % 防止CPU占用过高
end

% 结束当前模拟任务
calllib('swmm5','finish');

#### 4. 数据提取与可视化

最后一步是从已完成的模拟案例里获取所需的结果信息用于进一步的研究目的。这通常涉及到访问特定节点或链路的状态变量值，并将其转换为易于理解的形式展示出来，比如图表等形式。

% 获取指定时间步长内的流量变化情况作为例子
timeSeriesData = zeros(numSteps, 1);

for i=1:numSteps
    timeSeriesData(i) = calllib('swmm5','get_link_result', linkIndex, resultType);
end

figure();
plot(timeSeriesData);
title('Flow Rate Over Time');
xlabel('Time Step');
ylabel('Flow Rate (CFS)');