简介:这份HEC-RAS 6.7测试版用户手册中文翻译版,主要面向水利、水文与环境工程领域的工程技术人员、研究人员和高校师生,可用于河流、洪泛区、堤防、水库等系统的水力模拟与洪水风险评估。手册覆盖一维与二维水力计算、稳定流与非恒定流模拟、泥沙输移、水质分析、管道网络建模和溃坝分析,并系统讲解软件安装、用户界面、数据管理、几何建模、边界条件设置、模拟参数配置、结果查看与故障排除等操作环节,同时深入介绍自动校准、用户自定义规则、泵站与堤防建模以及GIS数据交换与模型比较工具等高级功能。资源包含1个PDF文件,压缩包总大小104.86MB,便于PC端与移动端离线查阅,适合结合软件实操按章节逐步学习。已有185人学习下载,对具有一定水力学和建模基础的专业人员而言,这是一份可用于日常建模参考与项目排错的完整中文技术资料。
1. 洪水分析为何绕不开 HEC-RAS:先看清 6.7beta4 中文手册能干什么
做洪水淹没分析、堤防评估、城市排水防涝和环境工程水影响评价的人,大概率绕不开 HEC-RAS(河流分析系统)。不管是给山区小流域算一条设计洪水水面线,还是模拟一段河道的溃坝过程,这个水利模型工具箱都属于第一梯队,而且免费、公开文档多。可惜官方手册厚得像本字典,英文表达又绕;这份 6.7beta4 中文用户手册,恰好把最用得上的部分按官方章节顺序翻成了中文。它不是零基础视频课的替代品,而是给你补底层原理、参数含义和排查思路的配套材料,适合已经具备水力学基础、正在用或准备用 HEC-RAS 建模的工程师、研究人员和高校师生。
2. 安装与项目文件体系:把 HEC-RAS 的数据管理摸清楚再动手
2.1 模块构成与用户界面:6.x 到底多了什么
HEC-RAS 的定位从来不是单一的一维恒定流计算器,而是一套河流分析系统。6.7 的模块边界比老版本更清晰:稳定流模拟、非稳定流模拟、泥沙输移、水质分析、管道网络测试、溃坝分析,再加上 6.x 引入的自动校准与用户自定义规则。做环境工程的人最值得先看水质模块,它能在水量计算结果之上叠加浓度输运,比如评估某个排污口对下游断面水质的影响;做防洪的人则重点看非稳定流和溃坝部分,这两块对边界条件和初始条件极度敏感,也是翻车重灾区。
用户界面分四块:主窗口里的项目浏览器负责管理项目文件;几何数据编辑器负责河网、断面、桥梁、涵洞;稳定流和非稳定流数据编辑器负责边界条件与计算选项;RAS Mapper 则内嵌了一套 GIS 显示环境,二维结果和淹没范围都在这里看。新手容易犯的错是把 RAS Mapper 当成后处理画图工具,几何完全在编辑器里手工画,坐标体系对不上,后期跟 GIS 数据交换时才意识到问题。
2.2 安装注意事项与版本坑位
安装本身不复杂,但有几个细节值得注意。6.7 目前还是 Beta,安装包安装时需要以管理员身份运行,否则写系统目录和示例文件容易失败。安装路径和后续工作路径尽量全用英文字符,不要带中文或特殊符号,这个坑在旧版本里就存在,6.7 对非英文字符路径的兼容性改善有限,遇到项目文件打不开时先怀疑路径而不是软件。
卸载程序在系统的“程序和功能”列表里能找到,Beta 版卸载一般比较干净,但备份工作目录要提前做。手册基于 2025 年 8 月的 6.7b4 导出稿翻译,属于测试版文档,部分功能命名和默认参数后续可能微调,对照新版时不要死磕旧截图。
2.3 项目文件类型与备份习惯
HEC-RAS 的项目体系是理解整个软件的关键。一次完整的计算由项目文件、几何文件、水流数据文件和计划文件组成,计划文件把几何和某一组水流数据组合起来,点 Compute 之后才生成输出文件。文件类型直接决定你该备份什么、恢复什么。
| 扩展名 | 作用 | 典型场景 |
|---|---|---|
| .prj | 项目文件,记录河网结构与各文件引用关系 | 双击打开整个项目 |
| .g01 | 几何文件,断面、桥梁、涵洞等数据 | 修改地形或断面后更新 |
| .f01 | 稳定流数据文件,流量与边界条件 | 设计洪水水面线 |
| .u01 | 非稳定流数据文件,过程线与闸门规则 | 溃坝、暴雨过程模拟 |
| .o01 | 输出文件与计算诊断信息 | 排查报错时查看 |
| .hdf | 二进制结果容器,二维结果与部分网格信息 | RAS Mapper 读取 |
项目浏览器里还能执行 Archive Project,把整套项目打包成单个归档文件,换电脑或交付审查时非常方便。我一般会在开始大方案前把整个项目文件夹打一个压缩包,因为某个几何文件被改坏后,想回到上一版只能靠这份后悔药。
3. 几何建模:从河网、断面到桥梁涵洞的层层把关
3.1 先画河网再切断面:横断面数据到底填什么
几何建模的起点是河流系统示意图。在几何数据编辑器里先画出河道中心线,再沿线布置横断面切割线;支流作为独立的河段接入,在汇合处设置路口节点。常见做法是先在 RAS Mapper 里加载高程栅格,沿河道画中心线和断面线,再把生成的几何数据导入编辑器,省去手工输入大量坐标的麻烦。
横断面数据是水力计算的基本单元,一个断面的信息包括:断面标识、到下游断面的流程长度、左右岸的位置、主槽和滩地的曼宁糙率、收缩膨胀系数、堤防位置,以及沿起点距分布的高程点列。手工输入时最容易出错的是左右岸站号顺序,断面高程点必须从河道左侧向右侧依次排列,且左右岸位置要与水流方向对应。如果方向反了,曼宁糙率会被错配到对岸,算出来的水面线左右岸趋势完全颠倒,这种问题很难一眼看出来,属于典型的玄学报错。断面间距上,我一般会在弯道、桥梁上下游、汇合口和坡度突变处把间距压到 50 到 100 米,顺直段放宽到 200 到 500 米,以能反映水面线变化为准。
3.2 桥梁与涵洞:水力计算方法不是越多越好
桥梁和涵洞建模都要在几何编辑器里先放置两个紧邻断面,一个上游一个下游,中间再定义桥或涵结构。桥梁水力计算方式分为低流量计算、压力流计算、溢洪道流量计算和组合流。低流量法基于能量方程,适合桥下水面低于桥梁梁底的情况;当水位顶到桥梁梁底或桥面时,压力流和溢洪道流量就开始起作用;一座桥在高水位下可能同时经历多种流态,这时要开启组合流选项。
踩得最多的坑是桥下有效过流面积被算小。桥墩、护坡、旧桥搭板都会挤占过流断面,如果只按桥面净宽输入桥墩位置,而没把桥墩实体尺寸和群桩阻水面积填全,桥前壅水会显著偏大。我一般会在输入桥墩后,先用几何编辑器里的过流面积检查图形看一遍桥下净面积,再对比相邻断面面积,发现突变异常就回头核对桥墩和断面数据。
3.3 横向结构与堤防:旁侧溢流和溃口模拟的入口
横向结构用于模拟水流从主河道侧向溢出的场景,比如漫滩行洪、分洪道、堤防漫溢。它本质上是一条贴着河道方向布置的侧向堰,可以设置顶部高程、宽度、溢流系数等。堤防建模在 6.7 中与横向结构紧密结合,结合非稳定流计算可以模拟洪水漫过堤顶后发生溃决的过程,溃口发展随时间变化逐步扩大,进而向下游传播洪水波。
用横向结构时要注意它与断面的位置关系,横向结构的走向必须贴合河道岸线,否则溢流方向判断会出错。很多人在几何编辑器里手动画线,画完又不与背景地形图叠加核对,结果溢流段落在半空中或坡脚以外,流量分配完全失真。建议在 RAS Mapper 里加载岸线与堤线图层后,沿着实际堤防走向布设横向结构。
4. 边界条件与模拟参数:稳定流、非稳定流和求解设置
4.1 边界条件类型:上下游各给什么数据
边界条件决定了模型怎么被“驱动”。上游边界通常给流量,非稳定流则给流量过程线;下游边界的选择更讲究,直接影响计算稳定性和结果合理性。稳定流和非稳定流支持的边界条件有差异,下面按最常见情况整理:
| 边界条件类型 | 稳定流 | 非稳定流 | 典型用途 |
|---|---|---|---|
| 流量 / 流量过程线 | 支持 | 支持 | 上游来水,设计洪水过程 |
| 已知水位 / 水位过程线 | 支持 | 支持 | 下游受干流顶托或潮汐影响 |
| 正常水深(给定摩阻坡降) | 支持 | 支持 | 下游边界外延较长时估算 |
| 水位流量关系曲线 | 支持 | 支持 | 下游有实测水位流量关系 |
| 临界水深 | 支持 | 不支持 | 陡槽末端、跌水处 |
有支流汇入时,每条支流的上游都要给边界条件,汇合后的干流下游只保留一个下游边界。多支流模型最忌讳漏边界,漏一条支流,计算时该支流流量为零,汇合段流量直接失真。
4.2 稳定流计算设置:多组流量一次算完
稳定流计算适合设计洪水水面线这类场景,核心操作是把多级流量一次性输入,比如同时计算 5 年一遇、20 年一遇、100 年一遇三组流量,一组流量对应一条水面线结果。流态选项分为亚临界、超临界和混合流态,默认用亚临界;山区陡坡河段可能出现临界流或超临界流,需要改用混合流态才能收敛。
能量方程的求解涉及收敛容差和最大迭代次数,遇到不收敛时,除了改迭代次数,更应该回头查断面数据和曼宁糙率。收缩膨胀系数一般取 0.1 到 0.3 的经验区间,桥位附近取大值,顺直均匀段取小值。每次算完,我习惯把结果里的水深、流速和佛汝德数扫一遍,佛汝德数接近 1 的断面说明流态临界,水面线容易跳变,这种断面要么加密间距,要么检查地形是否存在明显突变。
4.3 非稳定流参数:时间步长、湿干阈值和初始条件
非稳定流模拟溃坝、暴雨洪水演进和闸门调度,参数配置比稳定流复杂一个量级。时间步长直接决定计算稳定性和耗时,常见做法是先按总模拟时长的千分之一到百分之一粗设,比如模拟 48 小时先试 1 分钟步长,再看波形是否平滑,波动明显就逐步减半。输出间隔不用跟时间步长一致,结果文件会小很多。
求解器设置里,θ 权重因子控制时间加权格式的隐式程度,常见取 0.6 上下,偏大计算更稳定但数值耗散也大。湿干阈值控制网格从干转湿的判定,默认值在平原河网和山区河道表现不同,出现锯齿状水位时,朝阈值增大的方向调整往往能压掉高频振荡。初始条件更是重中之重,不要直接给一个常数水位,最好先用稳定流算一条初始水面线作为热启动,或者给一个与边界流量匹配的初始流量分布,否则计算前几小时容易出现水位振荡。
5. 高频报错与真实翻车:HEC-RAS 运行排查的五个坑位
5.1 稳定流计算不收敛
现象:计算在某个断面中止,提示能量方程无法收敛,或者反复迭代后水位误差仍超限。 原因:断面间能量损失设置异常,相邻断面距离过远、断面面积剧烈收缩、曼宁糙率偏小造成流速过大,都可能让迭代发散。 解决:先确认断面间距,过长则补插断面;再检查收缩膨胀系数是否取得太大;最后把流态从亚临界改成混合流态,给临界流区域一条出路。
5.2 非稳定流出现水位锯齿和负水深
现象:模拟结果里水位呈现锯齿状波动,或者局部断面水深变成负值,程序报“无效水深”退出。 原因:时间步长过大,使得水波在一个步长内穿过多个单元,Courant 数超限;初始水位场与流量场不匹配也会在最初几步造成干湿波动。 解决:缩小时间步长,检查下游边界水位是否低于河床最低点,改用稳定流热启动得到初始水面线,再调节湿干阈值让干湿交替区更稳定。
5.3 桥梁壅水高得离谱
现象:桥前水位比桥后高出数米,明显偏离经验判断。 原因:桥下有效过流面积输入错误,桥墩位置、尺寸与群桩阻水面积没填全,或者桥位两侧断面过窄,造成过流面积不足。 解决:在桥梁编辑器中核对桥墩几何和桥下净空,用面积检查图看桥下过流面积是否随水位平滑变化;低流量、压力流、溢洪道流量需要组合计算时确认组合流选项已开启。
5.4 断面左右岸颠倒或插值交叉
现象:计算结果左右岸滩地流速不对称,横断面图出现自相交,或者水面线与地形不匹配。 原因:断面切割线方向不统一,部分断面从右岸向左岸切,导致岸线标识错配;自动插值时相邻断面形态差异过大,插值出的断面出现畸形。 解决:在 RAS Mapper 中逐条检查断面线方向,统一调整后再重新提取数据;控制相邻断面的形态差,形状突变处不要依赖插值,手动补充真实地形断面。
5.5 文件打不开、中文乱码和路径问题
现象:双击项目文件提示找不到几何数据或水流数据,打开后结果窗口空白,或者全中文路径下 RAS Mapper 图层加载失败。 原因:项目文件记录了各数据文件的相对引用,整套文件被单独移动或重命名后引用断裂;中文路径在部分界面和图层读取环节存在兼容问题。 解决:项目目录整体移动后用项目浏览器里的文件引用修复功能重新关联;安装和工作路径统一改成英文字母与数字;复制交付时用 Archive Project 打包,避免单个文件散落。
| 现象 | 优先检查顺序 |
|---|---|
| 能量方程不收敛 | 断面间距 → 曼宁糙率 → 收缩膨胀系数 → 流态 |
| 负水深或锯齿波 | 时间步长 → 初始条件 → 湿干阈值 |
| 桥前水位异常偏高 | 桥下过流面积 → 桥墩几何 → 组合流选项 |
| 左右岸颠倒或断面交叉 | 断面线方向 → 断面形态差 → 插值间距 |
| 项目打不开或乱码 | 文件引用 → 路径字符 → 项目备份 |
6. 让 HEC-RAS 不只算单方案:校准、GIS 交换与批量后处理
6.1 自动校准与 GIS 数据交换的实用边界
6.x 的自动校准可以用实测水位或流量过程去率定曼宁系数,省去人工反复试算。我通常只在小段河道上用它,先把糙率限定在一个合理区间,再看校准结果是否越界;一旦最优点落在区间边缘,基本说明断面或边界有问题,这时候去调模型比继续校准靠谱。用户自定义规则适合表达“当某断面水位超过阈值时开启旁侧分流”这类逻辑,但它只在你把物理条件描述清楚后才可靠。
GIS 交换的标准流程是:在 RAS Mapper 中加载 DEM 高程栅格,沿河道绘制河网中线并布置横断面切割线,设置滩地范围和曼宁糙率图层,生成几何数据后导入几何编辑器。计算完成后,把淹没范围、水深、流速等结果导出为面图层和点图层,方便在 GIS 里继续做洪泛区制图和叠加分析。
6.2 并行计算与批量结果汇总技巧
6.7 手册里专门讨论了处理器核心调度问题,现代处理器往往混合性能核与能效核,默认调度不一定把计算线程放到性能核上。常见做法是在系统进程管理器中把 HEC-RAS 计算进程的处理器关联绑到性能核,二维非恒定流计算在这种情况下提升显著。多方案对比时,HEC-RAS 可以导出结果表格为 CSV,再用脚本批量合并不同重现期的峰值水位,比人工复制粘贴省力得多。
import pandas as pd from pathlib import Path base = Path("./plans") rows = [] for csv_path in sorted(base.glob("*/summary_export.csv")): plan = csv_path.parent.name df = pd.read_csv(csv_path) df["plan"] = plan rows.append(df) merged = pd.concat(rows, ignore_index=True) peak = merged[merged["Profile"].str.contains("100yr|20yr|5yr")] pivot = peak.pivot_table( index=["River", "River Sta"], columns="Profile", values="Water Surface", aggfunc="first" ) pivot.to_csv("peak_water_level_compare.csv", encoding="utf-8-sig")这段脚本遍历每个方案目录下的 summary_export.csv,按方案名打标签后合并,再用包含特定重现期标识的 Profile 行筛选峰值水位,最后透视为一张以断面为行、重现期为列的对比表。使用前注意把导出表里的列名和方案标识改成 HEC-RAS 实际输出格式,输出编码用 utf-8-sig 是为了给 Excel 打开时不乱码。从那以后我每次交多方案成果之前,都强制走一遍几何归档、边界复查、并行计算、结果透视对比这套流程,血泪教训换来的操作习惯,希望帮到你。
本文还有配套的精品资源,点击获取