EPANET开发指南带标签版本.pdf

EPANETH程序员工具箱 原著：Lewis A. Rossman （俄亥俄州辛辛那提市美国环境保护局研究和开发办公室 国家风险管理研究实验室供水和水资源分部，45268 ） 翻译：李树平 （上海市同济大学环境科学与工程学院，200092 ） 2011年9月21 日 Toolkith.rtf EPANETH程序员工具箱 第1页，共73页 EPANETH程序员工具箱 EPANETH是一个分析配水系统水力和水质特性的程序。EPANETH程序员工具箱是一个函数动 态链接库 (DLL)，允许开发人员为了特定需求，定制EPANETH计算引擎。函数可以包含在C/ C++, Delphi Pascal, Visual Basic，或者任何其它语言编写的32位Windows应用程序中， 可以在Windows DLL中调用函数。工具箱DLL文件命名为EPANET2H.DLL，与EPANETH一 起发布。工具箱包含了头文件，函数定义文件和.lib文件，以简化将它与C/C++, Delphi和 Visual Basic代码衔接的任务。 EPANET及其程序员工具箱由美国环境保护署国家风险管理研究实验室供水和水资源分部开发；汉化后命名为 EPANETH及其程序员工具箱，该汉化工作由同济大学环境科学与工程学院完成。 1．工具箱概览 程序员工具箱是EPANETH模拟软件包的扩展。EPANETH执行有压管网水力和水质特性的延时 模拟。管网可以包含管道、节点（管道连接节点）、水泵、阀门、贮水池或者水箱。EPANETH 跟踪每一管道的流量、每一节点的压力、每一水池的水位，以及多时段模拟过程中整个管网的 化学成分浓度。除了化学成分，也可以模拟水龄和源头跟踪。 工具箱提供了一系列函数，允许程序员定制应用EPANETH的水力和水质计算引擎。利用工具 箱之前，应熟悉EPANETH表示管网的方式，以及执行模拟需要的设计和运行信息。该信息可 以从EPANETH的在线帮助文件或者EPANETH用户手册获得。 为了分析配水系统的工具箱函数，其典型应用如下： 1. 使用ENopen函数打开工具箱系统，同时打开EPANETH输入文件。 2. 使用ENsetxxx系列函数，改变和选择系统特性。 3. 利用ENsolveH函数执行完整的水力模拟(它自动将结果保存到水力文件) ；或者利用 ENopen - ENinitH - ENrunH - ENnextH - ENcloseH系列函数，逐步进行水力模拟； 利用ENgetxxx系列函数访问计算结果。 4. 利用ENsolveQ执行完整的水质分析(它自动将水力和水质结果保存到输出文件)；或者使用 ENopenQ - ENinitQ - ENrunQ - ENnextQ (或者ENstepQ) - ENcloseQ系列函数， 逐步进行水质模拟；利用ENgetxxx系列函数访问结果。 5. 为了执行额外的分析，返回步骤2，或者利用ENreport函数，将格式化报告写入到报告文 件。 6. 调用ENclose函数，关闭所有文件，并释放系统内存。 利用这些函数的特定例子见示例应用主题。 Toolkith.rtf EPANETH程序员工具箱 第2页，共73页 2．数据流程图 EPANETH工具箱利用ANSI标准C语言书写，对于输入 过程、水力分析、水质分析、稀疏矩阵/线性方程分析和