swmm输出out文件格式-宁-20180530

Out文件格式

一：

下面的基本信息出现在out文件的开头：

·识别号码恒定为516114522

·引擎的版本号（当前为51000，版本不同可能不同）

·流量单位的代码编号，其中0＝CFS，1＝GPM，2＝MGD，3＝CMS，4＝LPS，5＝LPD。

·项目中的子流域数量

·项目中的节点数报告

·项目中的管道（管段）数量报告

·项目中污染物的数量。

这些值在文件中都是4字节整数格式。

二：

在上述的out文件开头记录部分之后，会记录包含SWMM 5输入文件（也就是inp

文件）中定义的每个子流域、节点、管道和污染物的ID名称。污染物浓度代码也包含在文件的这一部分中。

每个ID名称由写入输出文件（out文件）的两个记录组成：

·名称中的字符数（以4字节整数表示）就是告诉你名字有几个字符

·包含名称的字符串（每个字符为1字节）。

首先记录每个报告的（如果输入文件中要求不是全部都进行报告，那么结果文件就只包含要求报告的哪些）子流域的名字，然后为每个报告的节点，然后为每个报告的管道（管道），最后为每个污染物。在每个对象类别中，名称的出现顺序与输入文件中出现的顺序是相同的。计算结果的记录也是保持相同的顺序。

在污染物名称的列表之后，以4字节整数格式记录每个污染物的浓度单位的代码号。这些代码是：0毫克/升，1为Ug/L，2为计数/L。总而言之，这部分文件的总体布局是：

·子流域ID名称

·节点ID名称

·管道ID名称

污染物名称

污染物浓度单位代码

在文件的关闭记录（文件末尾）部分会记录当前这部分从哪个字节开始的，以及下一部分从哪个字节开始的。

三：输出文件-对象属性

SWMM 5引擎生成的二进制输出文件的对象属性部分包含与每个对象（而不是整个属性集）相关联的输入属性的有限集合。本节的格式如下：

项目 类型 描述

保存的子流域属性个数 INT4 目前等于1

保存的每个子流域属性的代码编号 INT4 子流域面积，目前为1

每个子流域的每个属性的值 Real4 各子流域的集水面积（AC或HA）

存的节点属性数 INT4 目前等于3

保存的节点属性的数量 INT4 目前等于：0（节点类型代码），2（节点颠倒仰角），以及3（节点最大深度）

每个节点的每个属性的值 Real4 节点类型代码、底部标高（FT或m）和每个节点的最大深度（ft或m）

保存的管道（管道）属性数 INT4 目前等于5

保存每个管道属性的代码编号 INT4 目前等于：0（管道类型代码），4（上游标高偏移），4（下游标高偏移），3（管道最大深度），以及5（管道长度）

每个管道的每个属性的值 Real4 管道类型代码，以及每个管道的上游标高偏移（FT或M），下游标高偏移（FT或M），最大深度（FT或M），和长度（FT或M）

笔记：

1。INT4＝4字节整数，Real4＝4字节浮点

2。节点类型代码为：

0＝普通节点，也就是检查井

1 =排口

2 =调蓄池

3＝分流器

三。管道类型代码为：

0 =管道

1＝泵

2=孔口

3＝堰

4 =出口

4。每个属性的单位（美国或公制）与流量的单位系统一致。

四：输出文件-报告变量

SWMM 5二进制输出文件的报告变量部分包含报告的每个变量的编号和代码。在本节中均使用4字节整数记录，如下：

·子流域变量的数量（目前为8 +污染物数量）。

·每个子流域变量的代码：

0雨量（I/HR或毫米/小时）；

1雪深（英寸或毫米），

2蒸发损失（日/日或毫米/天）；

3渗透损失（I/HR或MM/HR）；

4径流速率（流量单位），

5地下水流出速率（流量单位），

6地下水水位升降（FT或M），

7不饱和区含水量（分数）

8第一种污染物的径流浓度，

…

7＋N为第N种污染物的产流中浓度

·节点变量的代码（目前为6 +污染物数量）

·每个节点变量的代码编号：

0在底部高程（FT或M）以上的水深，

1液压头（FT或M），

2储存容量+积水（FT3或M3），

3侧向流入（流量单位），

4总流入（横向+上游）（流动单位），

5造成内涝洪水的那部分从管道内丢失的流量，也就是溢流的量（流量单位），

6第一种污染物浓度，

…

5＋n为第n中污染物浓度。

·管道变量的代码（目前为5 +污染物数量）

·每个管道变量的代码编号：

0流量（流量单位），

1流量深度，也就是水深（FT或M），

2水的流速（ft/s或m/s）；

3流量（FT3或M3）

4有管道的区域的分数或设置为无管道

5第一种污染物浓度，

…

4＋n为第n中污染物浓度。

·全系统变量的数量（当前为14）

·每个系统变量的代码编号：

0空气温度（DEF或DEC），

1雨量（I/HR或毫米/小时）；

2雪深（英寸或毫米），

3用于蒸发+渗透损失率（I/HR或MM/HR）；

4径流流量（流量单位），

5干天气流入（流动单位），

6地下水流入量（流动单位），

7用于RDII流入（流量单位），

8用于用户提供的直接流入（流量单位），

9总侧向流入（变量4和8的总和）（流量单位）；

10对于洪水（流量单位）失去的流动，

11通过流出口（流量单位）的流量，

12储存水量（FT3或M3），

13实际蒸发速率（每天/天或毫米/天）

14潜在蒸发率（PET）（日/日或毫米/日）

五：报告间隔

SWMM 5二进制输出文件的报告间隔部分仅由两个记录组成：

·模拟的开始日期和时间，表示为8个字节的双精度数字，表示从19年12月30日上午12点开始的小数日数。

·以秒为单位的报告周期之间的时间间隔，表示为4字节整数。

六、

SWMM 5二进制输出文件的计算结果部分是在模拟的每个报告周期记录每个子集水区、节点、管道和系统报告变量的计算值。每个报告变量的数量和类型记录在文件的报告变量那部分。从第一个周期（模拟时间0的初始条件不出现在文件中）开始，将以下信息写入每个报告周期的二进制文件：

·报告期的日期和时间，表示为8字节的双精度数字，表示自12/30/19以来的小数日数；

·每个子流域的每个子流域变量的值，为4字节浮点数，

·每个节点的每个节点变量的值，为4字节浮点数

·每个链接的每个链接变量的值，为4字节浮点数

·每个系统变量的值，为4字节浮点。

请注意，这些数据的布局如下：

日期/时间值

第一个流域的变量1、变量2等

…

最后一个变量的变量1、变量2等

第一节点的变量1、变量2等

…

最后一个节点的变量1、变量2等

用于第一个管道的变量1、变量2等

…

最后一个链接的变量1、变量2等

第一个系统变量，…，最后一个系统范围变量。

每个对象每个变量记录的顺序与out文件报告变量那部分中列出的顺序一致。每个子集线器、节点和链接出现的顺序遵循它们出现在文件的对象ID名称部分中的顺序，并且它们与SWMM 5输入文件中出现的顺序相同。注意，根据项目输入文件的（inp）[报告]部分中指定的选项，可以只报告所有子集卡、节点和链接的子集。（就是如果输入的inp文件中，共有100个汇水区，但只要求报告其中20个，那么结果文件中也就只有这20个的结果。）

每个报告周期重复该数据集合。报告周期的实际数目可以从文件的关闭记录部分读取。（比如模拟2个小时，5min报告一次，那么上面的数据集合就会重复2*60/5 这么多次）

七：关闭记录

下列记录被写入SWMM 5二进制结果文件中，这些数据出现在文件的计算结果部分：

·文件的对象ID名部分开始的字节位置（4字节整数）

·文件对象属性部分开始的字节位置（4字节整数）

·文件的计算结果部分开始的字节位置（4字节整数）

·文件的计算结果部分（4字节整数）中包含的报告周期总数

·仿真的错误代码状态，其中0表示没有错误（4字节整数）

·恒定的标识号，516114522，作为文件中的第一个记录出现（4字节整数）。

注意，字节位置表示为相对文件开始时（也就是字节位置为0）的偏移量。