HEC-RAS 从入门到精通
美国陆军工程兵团 · 官方开源软件

HEC-RAS 从入门到精通
河流水力学建模完整教程

以美国陆军工程兵团水文工程中心(HEC)官方文档与教程为蓝本,系统讲解一维恒定流、一维/二维非恒定流、泥沙输移与水质模拟,带你从零完成第一个可运行的河流模型。

1995首个版本发布
4大分析组件
100%免费开源
1D + 2D全维度水动力
01 · Overview

认识 HEC-RAS

HEC-RAS(Hydrologic Engineering Center – River Analysis System)是美国陆军工程兵团水文工程中心开发的河流分析系统,是全球应用最广的开源免费水力学建模软件之一。

HEC-RAS 允许你执行一维恒定流、一维与二维非恒定流水力学计算、泥沙输移/动床模拟、水温与水质模拟。它是一个集成系统:图形界面(GUI)、独立的水力分析计算内核、数据存储与管理、图形与报告输出共同组成一个整体,四大分析组件共享同一套几何数据表示和计算例程。

软件由美国陆军工程兵团(US Army Corps of Engineers)水文工程中心(HEC,隶属于水资源研究所 IWR)在加州戴维斯开发,完全免费,可从官方网站下载,无 License 限制。自 1995 年 1.0 版发布以来,它逐步从单一的一维恒定流计算工具,发展为覆盖 1D/2D 非恒定流、溃坝分析、泥沙、水质乃至泥石流模拟的综合性水动力学平台,也是 FEMA 洪泛区制图、水利工程设计、防洪调度研究中最常被引用的标准工具。

版本沿革
1995

HEC-RAS 1.0 发布

7 月发布首个版本,具备一维恒定流(steady flow)水面线计算能力,取代了此前的 HEC-2。

1997

2.x 引入非恒定流

加入一维非恒定流模拟(求解器改编自 UNET 模型),可模拟洪水波的传播。

2008

4.0 泥沙与水质

加入准非恒定流泥沙输移/动床计算与水质模拟组件,功能覆盖显著扩展。

2016

5.0 二维时代

正式加入二维非恒定流求解器与 RAS Mapper 空间数据环境,支持 1D/2D 耦合建模与淹没制图。

2020

6.0 全面增强

加入空间降水/入渗、2D 内桥梁水力学、2D 泥沙、非牛顿流体(泥石流)、新的显式浅水求解器等。

2023–24

6.4 / 6.6 迭代

6.4(2023-06)加入 1D/2D 侵占(encroachment)分析、流量优化;6.6(2024-09)加入 HEC-RAS 2025 网格导入、粗糙度标定区等。

2025+

HEC-RAS 2025 新一代平台

HEC 正在开发全新架构的 HEC-RAS 2025(Beta),重构界面与网格系统、引入 GPU 求解器与实时渲染;传统 6.x 系列与 7.0 继续并行维护。

典型应用场景

洪泛区管理与洪水保险研究

计算不同频率洪水的水面线,划定行洪区与洪泛区边界,支持 FEMA 洪水保险研究(Flood Insurance Study)中的洪泛区侵占(floodway encroachment)分析。

恒定流为主

溃坝与堤防溃决分析

模拟大坝溃决、堤防漫顶与溃口发展,生成下游洪水演进过程线与淹没范围,支撑应急预案与风险图编制。

非恒定流 / 2D

河道整治与桥梁设计

评估桥梁、涵洞、堰等水工建筑物对水位的影响,进行河道糙率、束窄、清淤等设计方案比选与敏感性分析。

恒定流 / 非恒定流

泥沙与河道演变研究

模拟长时间尺度上的冲刷与淤积、水库淤积、河道疏浚影响、河床粗化(armoring),评估取水与输沙工程效果。

泥沙输移

城市雨洪与排水模拟

与水文模型(如 HEC-HMS)耦合,模拟城市河道、管网出口、蓄滞洪区的洪水演进过程,评估内涝风险。

1D/2D 耦合

水温与水质模拟

模拟河流水温沿程变化与营养盐、溶解氧等水质组分的迁移转化,评估排污口与取水工程影响。

水质分析
02 · Capabilities

四大分析组件与特色能力

HEC-RAS 的核心是四个河流分析组件,外加一个空间数据处理环境 RAS Mapper。所有组件共享同一套几何数据与计算例程。

恒定流 · 水面线计算

计算恒定渐变流的水面线,可处理完整河网、树枝状水系或单一河段;支持亚临界、超临界与混合流态。基本算法求解一维能量方程,摩阻损失用曼宁公式,收缩/扩张损失用流速水头变化乘系数;急变流(水跃、桥梁、汇流口)改用动量方程。

子/超/混合临界流

非恒定流 · 1D/2D 水动力

模拟一维、二维或一维+二维耦合的非恒定流,覆盖完整开放河道网络、洪泛区与冲积扇。支持溃坝分析、堤防溃决与漫顶、泵站、通航闸运行、有压管道、自动率定、用户自定义规则等。1D 求解器改编自 UNET,以亚临界为主;2D 提供多种浅水方程求解器。

洪水演进 / 溃坝

泥沙输移 · 动床计算

模拟一维与二维的泥沙输移/动床冲刷淤积(准非恒定流或全非恒定流),按粒径分级计算输沙能力,可模拟水力分选与河床粗化。支持全河网、河道疏浚、堤防与侵占方案、多种输沙公式,以及 SIAM 泥沙影响分析和 BSTEM 岸坡稳定性。

冲刷 / 淤积 / 粗化

水质与水温模拟

进行详细的河流水温分析(完整热平衡)和有限水质组分的迁移转化模拟:藻类、溶解氧(DO)、碳质生化需氧量(CBOD)、溶解态正磷酸盐与有机磷、溶解态氨氮/亚硝氮/硝氮与有机氮,采用一维对流-扩散方程(QUICKEST-ULTIMATE 格式)。

水温 / 营养盐 / DO
RAS Mapper 空间环境
RAS Mapper 不是单独的"第五组件",而是空间数据工作台。它用于:建立水平坐标系统、创建 HEC-RAS 地形模型(Terrain)、布置几何数据模型并提取地形数据、生成 2D 计算网格、以地图/绘图/表格形式可视化结果,还能从 USGS 与 GRiD 服务在线下载地形数据。
主要模块与产出对比
四大组件速览
组件核心输入核心输出典型应用
恒定流几何 + 各断面流量 + 下游边界条件各方案(Profile)水面线、流速、断面水力要素表洪水水面线、行洪区、桥梁壅水
非恒定流几何 + 上下游水文过程线/水位过程线 + 初始条件随时间变化的水位、流量、淹没范围(可做动画)洪水演进、溃坝、调度运行
泥沙输移几何 + 准非恒定/非恒定水流 + 床沙级配 + 泥沙边界冲淤厚度、床沙级配变化、输沙率随时间变化水库淤积、河床演变、疏浚方案
水质/水温几何 + 水流 + 初始/边界浓度 + 气象(温度)水温与各水质组分时空分布热污染、富营养化、排污影响
学习路径建议:先掌握 1D 恒定流(官方教程实战 · 01)建立"河网—断面—流量—方案"的完整心智模型,再进入 1D 非恒定流(实战 · 02),最后学习 2D 建模(实战 · 03)与 RAS Mapper 制图(实战 · 04)。泥沙与水质等进阶专题需要以前面的水动力结果为基础。
03 · Installation

下载、安装与界面初识

HEC-RAS 免费开源,官方下载地址与全量文档均在 HEC 官网;安装流程与 Windows 常规软件一致。

下载与系统要求
https://www.hec.usace.army.mil/software/hec-ras/
官方建议的安装环境(HEC-RAS 6.x / 7.x)
操作系统仅 64 位 Windows(6.0 及以上支持 Windows 7/8/8.1/10/11 64 位;7.x 官网标注 Windows 10/11 64 位)。安装前请更新全部系统补丁。6.1 起提供 Linux 计算内核,7.0.1 安装包内含 Linux 编译版计算引擎(配合 WSL 使用)。
内存最低 8 GB(大模型建议 16 GB 或以上)。2D 网格与地形数据非常吃内存。
磁盘安装包约 171 MB(7.0.1);建议为项目与地形数据预留数十 GB 空间。
其他建议将项目与数据放在非 OneDrive 等云同步目录下,大型模型在云同步中极易损坏或备份缓慢。
安装步骤
  1. 下载安装包

    进入官网下载页,选择最新稳定版安装包(Setup Package)。若用于生产研究,优先选择最新正式版(如 6.6 / 7.0.x);如需体验新界面可下载 HEC-RAS 2025 Beta。

  2. 运行安装程序

    解压后运行安装程序,按向导完成安装。HEC-RAS 会同时安装主程序与计算内核(computational engine)。安装目录建议避开用户配置文件路径(如 C:\Users),以获得更好的兼容性与杀毒软件兼容性。

  3. 首次启动

    首次启动会出现设置界面,可调整默认项目目录、单位制等。确认默认项目目录不在企业托管的 OneDrive 目录下。

  4. 验证安装

    启动后通过 Help | About 查看版本号;用随附示例工程或新建空项目测试保存与计算是否正常。

主界面快速认识
HEC-RAS 主窗口功能分布示意
File Edit Run View Options GIS Tools Help 项目 几何 水流数据 模拟计算 RAS Mapper 结果查看 项目浏览器 / 河网示意图工作区 下游 上游 断面 信息栏
工具栏从左到右依次为:项目(新建/打开/保存工程)→ 几何数据编辑 → 恒定流/非恒定流/泥沙/水质数据编辑 → 各组件计算 → RAS Mapper 地图环境 → 结果(断面、纵剖面、水位过程线、3D 视图等)。
04 · Key Concepts

建模前必须理解的核心概念

HEC-RAS 的术语体系贯穿所有组件。先建立"几何(Geometry)— 水流(Flow)— 方案(Plan)"三段式数据模型,再掌握河网与断面要素。

三段式数据模型

几何数据 Geometry

描述河道系统的物理形状:河网结构、断面坐标与高程、桥梁涵洞等建筑物、蓄水区、2D 流场网格、糙率等。文件扩展名 .g01。

水流数据 Flow

描述水的作用:恒定流的各方案流量、非恒定流的水文过程线与边界条件、泥沙级配与输沙边界、水质初始浓度等。

方案 Plan

把"某套几何 + 某套水流"组合起来运行一次的配置,含计算选项(流态、求解器、时间步长等)。每次计算对应一个 Plan,结果可多方案对比。

河网与断面要素
河网示意:River / Reach / 断面 / 汇流节点示意
上游端(最先绘制点) XS 1 XS 2 XS 3 XS 4 XS 5 下游端 汇流节点 Junction 河名 River:一条水系(如 Merced River) 河段 Reach:某条河内的子段(如 Yosemite Valley),有唯一名称 断面 XS:垂直于流向的横截面,用河道桩号 River Station 定位 ← 流向:上游 → 下游
绘制河段中心线时,先画上游点、后画下游点,双击结束。汇流点(Junction)自动连接各支流,并在节点处用动量方程计算能量损失。
一维断面要素:河道、滩地与岸滩位置示意
左岸滩地 Left Overbank 主槽 Channel(两 Bank Station 之间) 右岸滩地 Right Overbank 左岸位置 右岸位置 水面线 WS(各 Profile) 每个断面需输入:断面线坐标、左右岸位置、主槽/滩地曼宁 n 值、上下游相邻断面距离(Reach Lengths)
HEC-RAS 把断面分为主槽与左右滩地三个子断面分别计算流量分配;岸滩位置(Bank Stations)与河道桩号(River Station)共同定义几何。无效流动区(Ineffective Flow Area)等概念在洪水研究中经常用到。
边界条件类型(恒定流)
恒定流分析常用边界条件
类型含义适用位置
正常水深 Normal Depth用能量坡度(通常取河道纵坡)计算下游均匀流水深下游边界(最常用、最简单)
临界水深 Critical Depth按临界水深确定边界水位上/下游边界(陡坡、控制断面)
已知水位 Known WS直接给定断面水位(如实测水位)上/下游边界
水位-流量关系 Rating Curve用 Q–H 关系曲线(如堰、水文站率定曲线)定义边界下游边界
关于正常水深坡度的选择:官方教程中的问答提示——边界处应取河道实际纵坡(可用 RAS Mapper 测量工具量取)。边界条件只会影响其上游一小段,但选错坡度会导致边界附近水位明显偏差,因此下游断面通常要延伸出研究区足够远。
05 · Workflow

一次建模的完整流程

无论 1D 还是 2D,HEC-RAS 建模都遵循"建项目 → 建几何 → 输入水流 → 组方案 → 计算 → 看结果 → 校准"的闭环。流程图数据为示意,展示标准建模路径。

HEC-RAS 标准建模工作流流程示意
流程走向:新建项目 → RAS Mapper 设置投影并准备地形 → 创建几何(中心线/断面/网格/建筑物)→ 输入水流与边界 → 创建方案 → 计算 → 结果查看与淹没制图 → 对照实测数据校准 → 回到几何/水流迭代细化。校准不满足即循环迭代。
返回教程目录
Practical Tutorials

官方教程实战

照 HEC 官方分步教程动手做,每个教程都配官方示例数据集与步骤截图:先做 1D 恒定流建立基础,再进入非恒定流与 2D。

01 · Tutorial 1 · 1D Steady Flow

官方教程一:1D 恒定流建模(Merced 河)

本节改编自 HEC 官方 Guides & Tutorials 的《Steady Flow Modeling with HEC-RAS》,案例为美国加州约塞米蒂(Yosemite)的 Merced River 河段:以实测地形为基础,从零创建 1D 模型、输入 6 个流量方案、运行计算,并用地物覆盖数据与实测高水位标记进行模型细化与校准。

本教程能回答的问题:水会流向哪里、洪泛区范围多大?河道流速多大?哪里流动发生急变?是什么在控制水的流向、是否存在明显阻水物?——先用"粗糙模型"回答这些问题,再逐步细化。
官方示例数据集:Steady Flow Modeling with HEC-RAS.zip约塞米蒂 Merced River 教程的完整工程数据(GIS_Data 投影与河流 shapefile、Terrain 地形、NLCD 地物覆盖、Channel_Polygon 等)。官方原包直链,需联网下载。
下载数据包
阶段 A · 项目与地形准备
  1. 创建新项目并设置投影

    启动 HEC-RAS,选择 File | New Project…,进入工作目录,填写 Title 与 File Name 后保存。

    启动 RAS Mapper,选择 Project | Set Projection,加载提供的投影文件(如 River.prj)。投影定义了整个项目所有空间数据的坐标系统,后续地形、几何、结果全部以它为准。

    把河流 shapefile(river.shp)拖入 RAS Mapper 地图窗口,右键图层选择 Zoom to Layer 定位研究区。

    设置投影(RAS Mapper Options)官方截图
    设置投影(RAS Mapper Options)
    在 Project | Set Projection 中加载 River.prj 投影文件,定义整个项目的坐标系统。来源:HEC 官方《Steady Flow Modeling with HEC-RAS》
  2. 下载地形数据(可选在线获取)

    选择 Project | Download Data | USGS Terrain,数据范围选 Current View,点击 Query Products 查询 USGS 服务;在数据筛选中勾选 Original(原始分辨率)并 Apply;用图形选择工具选中覆盖河谷洪泛区的瓦片,点 Add Selected 加入下载列表,再点 Start Download。无网络时可直接使用教程附带的 Terrain\USGS_Data 地形数据。

    下载 USGS 地形菜单官方截图
    下载 USGS 地形菜单 选择地形瓦片
    Project 菜单下的 Download Data | USGS Terrain 入口。来源:HEC 官方《Steady Flow Modeling with HEC-RAS》
  3. 创建地形模型(Terrain)

    选择 Project | Create New RAS Terrain,点 Add Files 选中下载的所有地形文件(Ctrl+A 全选);勾选 Merge Inputs to Single Raster 合并为单一栅格;点 Create 开始处理。处理完成后关闭窗口并打开 Terrain 图层。

    为什么先建地形?地形(Terrain)是 1D 断面提取高程、2D 网格生成与淹没制图的共同底图。它把多幅 DEM 合并、重投影、统一精度为一份 .hdf 地形文件。
    创建地形(New Terrain Layer)官方截图
    创建地形(New Terrain Layer) 地形建成后的样子与边界位置
    勾选 Merge Inputs to Single Raster 把多幅瓦片合并为单一栅格,点 Create 生成 Terrain.hdf。来源:HEC 官方《Steady Flow Modeling with HEC-RAS》
阶段 B · 创建 1D 几何
  1. 新建几何并绘制河中心线

    选择 Project | Create New Geometry,命名 Base。选中几何图层点 Edit 进入编辑。将 River shapefile 的河流中心线复制粘贴到 River 图层(也可用 shapefile 导入器或手工绘制)。

    用编辑工具右键河流线,选择 Rename River Reach,将河段命名为 Merced River / Yosemite Valley。

    重命名河段(Provide River and Reach Name)官方截图
    重命名河段(Provide River and Reach Name)
    River Name 填 Merced River,Reach Name 填 Yosemite Valley。来源:HEC 官方《Steady Flow Modeling with HEC-RAS》
  2. 布置断面(Cross Sections)

    选择 Cross Sections 图层,沿河道布置断面,注意断面应垂直于流向、充分覆盖洪泛区、在地形与流态变化处加密。布置完成后 Stop Editing 并关闭 RAS Mapper。

    打开主界面的 几何示意图(Geometric Schematic),打开刚创建的几何文件 Base,确认断面与中心线正确后 Stop Editing 保存。

  3. 输入曼宁 n 值

    选择 Tables | Manning's n or k values(横向变化),先统一把全部 n 值设为 0.04 作为初值。

    再打开 Tables | Reach Lengths 查看左/主槽/右三段河段长度。

    官方教程思考题:为什么 Left、Channel、Right 三段长度相同?因为当前还没布置流径线(Flowpaths)——HEC-RAS 默认按几何中心线距离近似三段长度相等。若要精确区分主槽与滩地的实际流动路径,需要在 RAS Mapper 中创建 Flowpaths 图层(见阶段 D)。
阶段 C · 输入水流数据并运行
  1. 输入恒定流数据

    打开 Steady Flow Data Editor:输入 6 个方案(Profiles),流量分别为 100、500、1000、2000、5000、10000 cfs(立方英尺/秒)。

    选择 Options | Edit Profile Names 为每个流量命名(如 100cfs、500cfs、1k、2k、5k、10k,最多 16 字符)。

    在下游边界处选择 Normal Depth 边界条件。思考:坡度应取多少?影响大吗?——取河道实际纵坡,边界只影响其上游一段。

    保存恒定流数据,命名 Steady Flows。

    编辑方案名称(Edit Profile Names)官方截图
    编辑方案名称(Edit Profile Names)
    为 6 个流量方案命名:100cfs、500cfs、1k、2k、5k、10k(最多 16 字符)。来源:HEC 官方《Steady Flow Modeling with HEC-RAS》
  2. 创建方案并计算

    打开 Steady Flow Analysis 窗口:Plan 命名 Base,几何选 Base,水流文件选 Steady Flows,保存方案。

    点击 Compute 运行计算。完成后在 RAS Mapper 查看淹没结果,用 XS Plot 绘制单个断面。

    创建方案(Steady Flow Analysis)官方截图
    创建方案(Steady Flow Analysis)
    Plan 命名为 Base,几何选 Base、水流文件选 Steady Flows。来源:HEC 官方《Steady Flow Modeling with HEC-RAS》
阶段 D · 基础运行后处理
  1. 利用基础运行设置岸滩位置(Bank Stations)

    先观察各断面(XS Plot)判断哪个流量方案的水面刚好在岸滩附近(如本案例选 100cfs 或 500cfs)。打开 Geometric Data Editor,选择 Tools | Channel Bank Station Locations,选择你判断的 Profile,再选择岸滩位置的插入方式(建议"在水面处插入站点/高程")。HEC-RAS 会按该水位的岸边位置自动调整所有断面的 Bank Stations。

    设置岸滩位置插入方式官方截图
    设置岸滩位置插入方式
    官方推荐选择"Insert station/elevation at the water surface"(在水面处插入站点/高程)。来源:HEC 官方《Steady Flow Modeling with HEC-RAS》
  2. 建立流径线 Flowpaths(可选)

    在 RAS Mapper 中编辑 Base 几何,选择 Flowpaths 图层,在左右滩地各创建一条流径线,用于精确计算主槽与滩地的实际流动距离。完成后 Stop Editing。

  3. 重新运行并评估结果

    重新 Compute Base 方案,对比设置岸滩前后水面线的变化。

    为何要保留旧几何?细化前先把 Base 几何另存为副本(RAS Mapper 中右键几何 → Save Geometry As,命名 Refined)。你永远不知道什么时候要回退对比——但一定会需要对比前后方案的进步。
阶段 E · 模型细化:空间变化糙率
  1. 创建土地覆盖(Land Cover)图层

    选择 Project | Create New RAS Layer | Land Cover Layer,导入 2019 NLCD 栅格(NLCD_2019.tif),按 NLCD 分类建立 RAS 分类表,点 Create 生成 LandCover 图层。HEC-RAS 会弹出图层关联对话框,把 LandCover 关联到几何的 Manning's n 属性上。

    创建土地覆盖图层(Create a New Land Cover Layer)官方截图
    创建土地覆盖图层(Create a New Land Cover Layer) 图层关联对话框
    导入 NLCD_2019.tif,按 NLCD 分类建立 RAS 分类表后点 Create。来源:HEC 官方《Steady Flow Modeling with HEC-RAS》
  2. 为各地类设置曼宁 n 值

    右键 LandCover 图层选择 Edit Land Cover Data Table,在分类参数表中为每种地类填入曼宁 n 值。官方教程给出的示例值:

    NLCD 地类 → 曼宁 n 值(官方教程示例)
    ID地类名称Manning's n备注
    11Open Water(水面)0.035水面糙率小
    21Developed, Open Space(开发空地)0.04
    22Developed, Low Intensity(低密度开发)0.08
    23Developed, Medium Intensity(中密度开发)0.12
    24Developed, High Intensity(高密度开发)0.16不透水/建筑
    31Barren Land(裸地)0.026
    41Deciduous Forest(落叶林)0.15
    42Evergreen Forest(常绿林)0.12
    43Mixed Forest(混交林)0.14
    52Shrub-Scrub(灌木)0.12
    71Grassland-Herbaceous(草地)0.04
    官方教程的 Classification Parameters 窗口官方截图
    官方教程的 Classification Parameters 窗口
    在 ID/Name 分类表上为每种地类填入 Manning's n;截图即官方教程给出的示例值。来源:HEC 官方《Steady Flow Modeling with HEC-RAS》

    表中数值仅用于跟随官方教程练习;实际项目应根据植被、河道条件与文献经验选取并做敏感性分析。

  3. 更新断面糙率并运行细化方案

    在 RAS Mapper 中编辑 Refined 几何:选中 Cross Sections 图层 → Update Cross Sections | Manning's n Values,把地类 n 值写入全部 104 个断面。打开 Layer Plot Option | Manning's n Values 可检查是否生效。Stop Editing 保存。

    在 Steady Flow Analysis 中用 File | Save Plan As 创建新方案 RefinedXS(几何选 Refined XS),Compute 运行。

    更新断面属性(Update Cross Sections 右键菜单)官方截图
    更新断面属性(Update Cross Sections 右键菜单)
    右键 Cross Sections 图层 → Update Cross Sections | Manning's n Values,把地类糙率写入全部断面。来源:HEC 官方《Steady Flow Modeling with HEC-RAS》
  4. 对比两个方案的结果

    方法一(Profile Plot):打开纵剖面图,Options | Plans 同时勾选 Base 与 RefinedXS 两个方案对比。官方案例结论:细化方案的水面线总体略高(因空间变化糙率更贴近实际)。

    方法二(RAS Mapper):右键河流中心线 Save as Profile Line 保存为剖面线;打开两个方案的 WSE(水面高程)图层并开启动画,在 Profile Lines 标签页右键河流线 → Mapping Results | Profile | Fast | WSE 生成沿程水面线对比。

    官方教程的纵剖面对比图(Profile Plot)官方截图
    官方教程的纵剖面对比图(Profile Plot)
    同时勾选 Base 与 RefinedXS 两个方案:细化方案(RefinedXS)的水面线总体略高于 Base——空间变化糙率更贴近实际。来源:HEC 官方《Steady Flow Modeling with HEC-RAS》
阶段 F · 用实测数据校准模型
  1. 加入实测高水位(Observed WS)

    打开 Steady Flow Data Editor → Options | Observed WS,选择河道桩号 2.88(约在桥位附近),点 Add an Obs. WS Location,为 10000cfs 方案输入实测水位 3966 ft。保存并重新运行。

    添加实测水位位置(Add an Obs. WS Location)官方截图
    添加实测水位位置(Add an Obs. WS Location)
    River Sta. 2.88(约在桥位附近),为 10000cfs 方案输入 3966 ft。来源:HEC 官方《Steady Flow Modeling with HEC-RAS》
    官方案例结论:对比 XS Plot 可见,模拟水面比实测高水位约低 2 英尺。可能原因有三类:几何不准确、边界条件不合理、曼宁 n 值不正确——逐一复查。改善糙率通常最有希望。
    官方案例:模拟水面比实测低约 2 英尺(XS Plot)官方截图
    官方案例:模拟水面比实测低约 2 英尺(XS Plot)
    红色 OWS 10k 为实测高水位点,蓝色 WS 10k 为模拟水面——两者相差约 2 英尺,说明模型仍需改进。来源:HEC 官方《Steady Flow Modeling with HEC-RAS》
  2. 改进曼宁数据:叠加主槽多边形

    选择 LandCover 的 Classification Polygons 图层 → Start Editing → 右键 Import Features from Shapefile,导入 Channel_Polygon.shp(主槽范围);右键新导入的主槽多边形 → Edit Classification Value,新增分类 Channel 并设 Manning's n = 0.04。Stop Editing 保存。

    重新 Update Cross Sections | Manning's n Values,重跑并对比结果。官方案例结论:结果有所改善,但仍不理想——研究区还存在未建模的高地(实际应起堤防作用)和一座未入模的桥梁,这些都会抬高水位。

    为主槽新增分类并设糙率(Classifications)官方截图
    为主槽新增分类并设糙率(Classifications)
    新增 Channel 分类,Manning's n 设为 0.04,用于改进主槽糙率。来源:HEC 官方《Steady Flow Modeling with HEC-RAS》
  3. 敏感性分析(Bonus)

    回答两个问题:① 模型对下游边界条件有多敏感?② 增大/减小曼宁 n 值会如何改变水面线?——用对照方案定量回答,理解模型对各参数的响应是校准的基础。

1D 恒定流教程 · 纵剖面结果示意示意图数据
示意曲线(非真实计算结果):Ground 为河道纵坡地面线,WS 10k(Base)与 WS 10k(RefinedXS)为 10000 cfs 方案水面线;细化后糙率更贴近实际,水面线整体略高。真实项目中请以 HEC-RAS 输出的 Profile Plot 为准。
02 · Tutorial 2 · 1D Unsteady Flow

官方教程二:1D 非恒定流建模

非恒定流模拟"流量和水位随时间变化":给一个入流过程线,看洪水波如何演进。本节按官方 User's Manual 第 7 章《Performing a 1D Unsteady Flow Analysis》与 Guides 中 Combined 1D/2D 路径,从恒定流模型升级开始,一步步填边界、初始条件、水力表与计算选项,直到跑通并排查不稳定。

本教程能回答的问题:洪峰什么时候到下游?水位涨到多高、淹到哪里?闸坝调度或溃坝后过程如何?——先有稳的 1D 几何,再按阶段 B–E 填过程线与初值。
和恒定流的关系:几何共用(.g01);恒定流数据 .f01,非恒定流数据 .u01,新方案常为 .p02。官方惯例:先用恒定流理解主槽/滩地/洪泛区,再在同一套几何上做非恒定流。
官方案例与数据包入口非恒定流步骤对应官方《Creating a Combined 1D/2D Model》——示例工程与数据包挂在该指南页文末附件,请到官方页下载(本节不重复托管)。也可先下载下方恒定流包作几何底稿,再按本节新建 .u01 过程线;2D 包内含 DSS 流量过程线可作录入参考。
打开官方指南页
可复用:Steady Flow Modeling with HEC-RAS.zipMerced 河 1D 几何与地形全套,可作非恒定流的几何打底(阶段 A)。
下载恒定流包
可复用:Creating a Simple 2D Model.zipBald Eagle Creek 工程数据,内含 GIS/地形与 DSS 流量过程线,可参考阶段 B 的 DSS 读入方式。
下载 2D 示例包
阶段 A · 模型升级准备
  1. 确认恒定流模型可用

    按「官方教程一」把几何(中心线、断面、滩地)和一两个恒定流量级跑稳:低流量确认主槽与岸滩,高流量确认断面是否盖住洪泛区。

    在 Profile Plot / RAS Mapper 看一眼水面是否合理;几何若有明显错误,先改几何,不要直接上非恒定流。

  2. 延伸下游河段并量取纵坡

    把研究河段向下游延伸足够长(让边界影响远离关注区)。在 RAS Mapper 用 Measure Tool 沿河量一段纵坡,记下数值,下一步做 Normal Depth 下游边界要用。

    官方提示:下游边界最简做法是 Normal Depth + 该纵坡。

  3. 创建非恒定流数据文件

    主界面选择 Edit | Unsteady Flow Data…,命名保存(如 Unsteady,对应 .u01)。编辑器里你会用到这些页签/按钮:

    • Boundary Conditions — 逐河段边界类型与过程线
    • Initial Conditions — 初始流量/水位
    • Options — 观测数据、水温等

    先别填数,浏览一遍界面,确认 River/Reach 列表与几何一致。

阶段 B · 边界条件与入流过程线
  1. 设置上游流量过程线(Flow Hydrograph)

    在 Boundary Conditions 页,点选最上游(及各支流)位置,边界类型选 Flow Hydrograph。

    过程线数据来源三选一:

    • 手工录入:在表格中填日期时间 + 流量。
    • HEC-DSS:点 DSS 图标,选路径(如 /FLOW/01JAN2020/1HOUR//TYPE-PER-AVER/)。
    • HEC-HMS 导出的 DSS 文件直接引用。

    录入后点 Plot Data 看形状:应"基流起涨 → 洪峰 → 退水",时段至少覆盖约 2 倍洪水历时。

    非恒定流边界条件表官方截图
    非恒定流边界条件表
    在边界条件表中为每个 River/Reach 指定类型与数据。来源:HEC 官方 2D 教程(同一 Unsteady Flow Data 编辑器)
  2. 从 HEC-DSS 导入过程线

    点边界行上的 DSS 按钮,Open HEC-DSS File 选择文件,在 Pathname 浏览器中选中流量序列,确认时间窗口与单位(m³/s 或 cfs,与工程一致)。

    勾选/填写 Multiplier(整体缩放)与 Min Flow(最小流量下限,避免 0 流量导致数值问题)——这是官方推荐的两个便捷项。

    DSS 流量过程线选择官方截图
    HEC-DSS 过程线选择
    从 HEC-DSS 路径中选取流量/水位过程线。来源:HEC 官方 2D 教程
  3. 设置下游边界条件

    点最下游位置,按已有资料选:

    • Normal Depth — 填阶段 A 量取的能量坡度,最常用。
    • Stage Hydrograph — 有实测水位或潮位时。
    • Rating Curve — 有稳定水位流量关系时。

    若还要模拟"上游水位+流量混合边界"(感潮等),可用官方的 Upstream Stage and Flow Hydrograph(流量以 -901 作切换约定,详见手册)。

  4. 添加内部侧向入流(可选)

    在内部断面用 Add Boundary Condition Location 加入:

    • Lateral Inflow — 支流/区间一条过程线。
    • Uniform Lateral Inflow — 沿整段均匀分配。

    再点 Plot Data 检查各条过程线是否对齐同一时间基。

阶段 C · 初始条件与断面水力表
  1. 设置初始条件(Initial Conditions)

    切到 Initial Conditions 页。官方常用三种:

    • 给最上游初始流量(常等于过程线起涨前基流),程序做一次恒定流推算各断面初值。
    • Restart File — 用上次运行输出续算(长系列分段跑、或稳定性差时先跑稳再接)。
    • 蓄水区/连接处留空时按默认处理;也可用堰上水位等信息辅助初始化。
    怎么填:过程线从低基流起涨时,初始流量就填该基流;并留出预热段(过程线开头多加一段平稳低流量),让模型自己稳下来。
  2. 设置断面水力表参数(Hydraulic Table Parameters)

    打开 Geometric Data Editor,点工具栏 Hydraulic Table Parameters(或 Options | Hydraulic Table Computation Parameters):

    • Starting Elevation:把各断面渠底高程(invert)复制过去。
    • Increment:加一个增量,官方默认示例 0.5 ft(约 0.15 m)。
    • Number of Points:点数要盖住全过程最高水位;可看右侧竖向切片预览。

    保存几何。若跳过这步,非恒定流一开算就容易报缺表/插值失败。

    从恒定流升级时,这是官方点名的最高频遗漏。改断面或改流量级后,记得重新生成/检查水力表覆盖范围。
阶段 D · 方案与计算设置
  1. 创建非恒定流方案(Unsteady Flow Analysis)

    菜单 Run | Unsteady Flow Analysis…(或主界面 Unsteady Flow Analysis 按钮):

    • Plan Title 如 Unsteady-Base,短名 UBase
    • 几何选阶段 A 的几何,水流数据选 Unsteady

    在 Programs to Run 中保持 Geometric Preprocessor → Unsteady Flow Simulation → Post-Processor 勾选(默认齐全)。

  2. 设定模拟时间窗与计算步长

    填 Simulation Time Window 起止日期时间(要包住整个过程线,含起涨前基流与退水)。

    Computational Time Step 先取 1–5 分钟 试算;2D 或急变段往往要更小。

    $$C_n = \frac{V\,\Delta t}{\Delta x} \le 1$$
    Courant 条件:一个时间步内水流推进不宜超过一个断面间距。先短窗试算,再定长模拟步长。
  3. 设置计算选项与公差(Computation Options)

    点 Computation Options and Tolerances…,常见开关:

    • Advanced Time Step Control:按 Courant 自动调步长,省去手工试算。
    • Theta:默认 1.0 最稳;0.6 更精但更挑模型。
    • Time Slices:2D 要更小步时用,1D 基步长不变、2D 域再切片。
    • Lateral Structure Flow Stability Factor:侧向结构流量跳时可临时调到 2–3,稳后再回 1。
    • Output Interval:结果输出间隔(过程线分辨率 vs 文件体积)。

    保存 Plan。

阶段 E · 运行与稳定性排查
  1. 短时间窗试算并运行全过程

    点 Compute。建议先把结束时间收到洪峰后不久,确认能跑通、日志干净,再改回完整窗口重跑。

    运行中看 Unsteady Flow Log:是否频繁减步长、是否出现 Volume Accounting 告警。

  2. 查看过程线与淹没结果

    结果常用四件:

    • Stage / Flow Hydrograph Plot — 指定断面的水位、流量过程。
    • Unsteady Flow Spatial Plot / Time Series — 沿程与时间对比。
    • RAS Mapper — 最大淹没、动画、指定时刻水深。
    • Profile Plot — 某时刻水面线(调试振荡很有用)。
  3. 排查计算不稳定问题

    手册《Finding and Fixing Model Stability Problems》建议顺序:

    • 一开算就不稳(NaN / 迭代打满)→ 先查初始条件与边界是否一致、水力表是否覆盖。
    • 汇流口持续振荡 → 多为陡支流 + 主河低初值;检查交汇几何,必要时对 junction 改用水面能量平衡求解。
    • 减小时间步后结果大变 → 原步长过大,用更小步重跑。
    • Volume Accounting 误差大 → 查堰流淹没指数、时间步、高地/堤防是否真正挡水。
    • 糙率/结构系数敏感 → 每次只改一类参数,另存 Plan 做敏感性对比。
    官方还提供 Automated Calibration of Manning's n(高级特性)与逐步校准清单:观测水位/流量 → 几何 → 糙率 → 蓄量 → 结构系数。详见手册第 7 章 Calibration。
  4. 后续进阶方向

    本模型跑稳后,官方文档里常见的下一步:

    • 1D/2D 耦合:滩区加 2D Flow Area(Guides《Creating a Combined 1D/2D Model》)。
    • 溃坝/溃口:Inline Structure Breach / Lateral Structure(堤防)Breach。
    • 调度规则:闸门规则集(Rule Sets)控制非恒定出流。
03 · Tutorial 3 · 2D Modeling

官方教程三:2D 建模入门

2D 建模把洪泛区离散为计算网格,在每个网格单元上求解浅水方程,能真实刻画漫滩水流、回流、堤防绕流等二维现象。官方 2D 教程包括《Creating a Simple 2D Model》与《Mesh Generation and Refinement》等。

官方示例数据集:Creating a Simple 2D Model.zip宾州 Bald Eagle Creek(Lock Haven 附近)教程的完整工程数据:多个地形(BEC_10ft.tif、DEM.tif)、GIS_Data 与 DSS 流量过程线等。官方原包直链,需联网下载。
下载数据包
研究区:Bald Eagle Creek 及支流官方截图
研究区:Bald Eagle Creek 及支流 地形建成后的样子与边界位置
官方 2D 教程研究区(宾州 Lock Haven 附近):从 Sayers Dam 下游到与 West Branch Susquehanna River 汇流口,含 Marsh、Beech、Fishing 三条支流入流。来源:HEC 官方《Creating a Simple 2D Model》
阶段 A · 网格三要素与流场规划

单元中心 Cell Center

每个网格单元的计算中心,水面高程在此求解。单元中心不一定是几何形心。

单元面 Cell Faces

单元之间的边界面,流量跨面交换。面必须沿堤防、路堤等线性阻水物对齐,否则水流会"泄漏"。

面端点 Face Points

单元面端点(FP),外边界上的 FP 用于连接 1D 元素、边界条件线与 2D 流场。

2D 计算网格示意示意
河道方向(加密区) 洪泛区单元(粗网格) 2D Flow Area 边界 Breakline(堤防线) 网格生成要点 DX/DY:单元间距 Breakline:强制面沿 Refinement Region:局部加密 每个单元中心一个计算点
2D 工作流:画 2D Flow Area 多边形 → 在 2D Flow Area Editor 设置 DX/DY 点距 → Generate Computation Points 生成网格 → 检查计算点(每个单元只能有一个点,错误点显示为红色)→ 用 Breaklines 与 Refinement Regions 细化。
阶段 B · 网格生成与检查
  1. 生成计算网格

    在 Edit 2D Area Properties 中输入 DX/DY 点距(官方简单模型示例用 500;官方《Mesh Generation and Refinement》教程用 200 起步、熟悉后再细化到 100),点 Generate Computation Points 生成非结构化网格;设置默认 Manning's n(如 0.04)。关闭编辑器,打开 Computation Points 图层检查网格边界,每个单元只能有一个计算点,出错用编辑工具增删移动点修正。Stop Editing 保存几何。

    2D Flow Area Editor官方截图
    2D Flow Area Editor 网格错误与修正对比
    DX/DY 点距 500 ft(官方简单模型示例)、Generate Computation Points 生成 2222 个单元、默认 Manning's n = 0.04;右图为单元/计算点错误(红色)与修正。来源:HEC 官方《Creating a Simple 2D Model》与《Mesh Generation and Refinement》
  2. 计算水力表并检查单元属性

    右键 2D Flow Areas 图层 → Compute 2D Flow Areas Hydraulic Tables,为网格计算水力特性表(左下角有处理进度)。选中该图层(选中后变为洋红色),用鼠标点选 Cell 或 Cell Face,右键 Plot Property Table 即可查看单元的属性表——检查单元高程、面积、与周边面的连接是否合理。

  3. 复制几何做网格细化对比

    右键几何 → Save Geometry As 复制出一份(如 Initial Mesh → Refined Mesh),编辑副本并把 2D Area 重命名(如 2DArea_2)以区分;在 2D Flow Area Editor 中把点距改小(官方示例 200 → 100 ft)并重新 Generate Computation Points(会提示删除旧点)。对比粗细两套网格的水力结果,判断细化是否改变结论。

阶段 C · 边界条件与计算设置
  1. 绘制边界条件线(BC Lines)

    在 RAS Mapper 中编辑几何,选择 Boundary Condition Lines 图层,在入流、支流、出流位置各画一条边界线(迎向下游时从左到右绘制),并命名。边界线必须画在网格外部。回到主界面打开几何示意图核对。

    边界条件线(Boundary Condition Lines)官方截图
    边界条件线(Boundary Condition Lines)
    在入流(Sayers Dam)、三条支流与下游位置各画一条边界线,标注为 Inflow、Marsh Creek、Beech Creek、Fishing Creek、Downstream。来源:HEC 官方《Creating a Simple 2D Model》
  2. 输入非恒定流边界并运行

    在 Unsteady Flow Data Editor 中为边界线指定边界条件:上游/支流用 Flow Hydrograph(官方示例从 Simple2DModel_Flows.dss 读取),下游用 Normal Depth(Slope = 0.001)。创建非恒定流方案,设置模拟时间窗与时间步长,Compute 运行。

    非恒定流数据编辑器的边界条件表官方截图
    非恒定流数据编辑器的边界条件表 DSS 流量过程线选择
    上游与支流用 Flow Hydrograph,下游用 Normal Depth(Slope = 0.001);流量过程线从 Simple2DModel_Flows.dss 读取。来源:HEC 官方《Creating a Simple 2D Model》
2D 边界线常用边界条件类型
Flow Hydrograph 流量过程线最常用的入流边界:流量随时间变化,可来自实测、水文模型或 DSS。
Stage Hydrograph 水位过程线水位随时间变化,用于感潮河口、有实测水位的出流边界。
Normal Depth 正常水深给定能量坡度,快速设定出流边界(官方简单模型下游用 Slope = 0.001)。
Precipitation 降雨对 2D 域施加降雨(可含入渗),用于城市内涝、分布式降雨场景。
Zero Depth / Outlet自由出流 / 出流口边界,用于出水口与排水场景。
2D 时间步长:2D 单元通常比 1D 断面间距小得多,因此需要更小的时间步长(官方提示:2D 单元小时应减小时间步)。先设短时间窗试算、保证满足 Courant 条件;若 2D 域需要比 1D 更小的步长,用 Time Slices 选项让 2D 域内部按更小步长细分。
阶段 D · 网格细化与求解器选型
  1. 网格细化:Refinement Regions

    用 Refinement Regions 在关键区(主槽、地形突变、建筑物周边)局部加密:复制几何 → 新建 Refinement Region 多边形并设单元间距 → 右键 Enforce Region 强制执行。策略:只对 10–20% 的关键区域加密——全流域单元减半会让单元数增加约 4 倍、计算时间增长约 4 倍。

  2. Breaklines:强制面沿高地

    单元面(Cell Faces)控制单元间的流量交换,必须沿堤防、路堤、高地等线性阻水物对齐,否则水流会"泄漏"。选择 Breaklines 图层沿高地画线,右键 Enforce Breakline 强制执行。

    官方要点:只点 Enforce Breakline 只会在当前已有计算点上生效;正确流程是打开 2D Flow Area Editor,勾选 Generate Computation Points with Enforce Breaklines / Refinement Regions 重新生成计算点,程序会按设定间距重新布点并强制 Breakline 生效。
求解器
2D 求解器选型
扩散波 Diffusion Wave(SWE-EM)忽略对流加速度的简化浅水方程,稳定性好、允许较大时间步,适合大多数漫滩与城市洪涝场景;对动量效应显著的场景(弯道、急流)精度受限。
完整浅水方程 SWE(Full Saint-Venant)完整求解动量守恒,适合需要精确刻画回流、弯道环流、桥墩绕流的场景;对时间步长更敏感。
显式浅水求解器(6.0 新增)动量守恒更好的显式求解器,需要更小时间步长、运行更久,用于对动量精度要求最高的场景。
阶段 E · 结果检查与常见问题
  1. 查看结果图层与动画

    运行后在 RAS Mapper 中勾选 WSE / Depth / Velocity 结果图层查看淹没范围,用动画控制条(Max 按钮)查看最大淹没;Profile Lines 可沿任意剖面提取水面线,Reference Polygon 统计区域水量。完整的制图流程见 官方教程实战 · 04 RAS Mapper。

  2. 常见 2D 错误排查

    计算点错误:每个单元只能有一个计算点,生成后务必打开 Computation Points 图层检查,红色错误点用增删移动修正。

    水流沿线性阻水物"泄漏":单元面未与堤防/路堤对齐——用 Breaklines 强制对齐(见阶段 D)。

    Terrain 空洞:DEM 有 NoData 时地形出现空洞,会影响单元高程提取——先补洞再建地形。

    边界线画在网格内部或方向错误:BC Lines 必须画在网格外部,且按迎流方向从左到右绘制。

04 · RAS Mapper

RAS Mapper 与淹没制图

RAS Mapper 是 HEC-RAS 内置的 GIS 环境:准备地形、绘制河网与断面、生成 2D 网格、映射并动画化计算结果,是 1D/2D 建模与洪水制图的统一工作台。本节按 HEC 官方教程《Developing 1D Geometric Data with RAS Mapper》与《RAS Mapper User's Manual》整理,从界面认识讲到端到端淹没制图。

阶段 A · 认识界面与图层体系
  1. 启动 RAS Mapper

    在主界面通过 GIS Tools | RAS Mapper 菜单,或直接点击工具栏上的 RAS Mapper 按钮启动。RAS Mapper 是独立窗口,顶部为菜单与工具栏(选择、平移、缩放、识别),左侧为图层面板,中间为地图窗口,底部为状态与工具标签页。

    主界面入口(GIS Tools | RAS Mapper)官方截图
    HEC-RAS 主界面与 RAS Mapper 入口
    GIS Tools 菜单与工具栏上的 RAS Mapper 按钮。来源:HEC《RAS Mapper User's Manual》
  2. 认识主界面布局

    左侧 Layers 面板把所有数据按组组织:Geometries(几何)、Results(结果)、Terrains(地形)与 Map Layers(底图/参考)等;右上角显示当前选中图层与渲染模式(如 Max 最大淹没);右下角为水深/高程比例尺;底部 Messages / Views / Profile Lines / Active Features / Layer Values 标签分别提供消息、视图管理、剖面线、交互查询与图层值读取。

    RAS Mapper 界面(显示 Depth 水深图层)官方截图
    RAS Mapper 界面与图层列表面板
    图层按组管理,结果按方案(Plan Short ID)分组显示。来源:HEC《RAS Mapper User's Manual》
  3. 图层体系

    RAS Mapper 的图层按用途分为五组:模拟结果按 Plan Short ID 分组且自包含(事件条件 + 几何 + 结果图)。

    RAS Mapper 主要图层
    图层用途
    Features河流中心线、剖面线、参考点/线/多边形(用于聚合统计区域结果)
    Geometries几何数据:River、Cross Sections、Storage、2D Flow Areas、Bridges、Inline/Lateral Structures、Pump Stations 等
    Event Conditions水流数据、边界条件位置
    Results计算结果图层:水面高程 WSE、水深 Depth、流速 Velocity 等,可做动画播放
    Map Layers地形 Terrain、土地覆盖 Land Cover、入渗、土壤、栅格计算器(RASter Calculator)等
阶段 B · 地形与投影准备
  1. 新建项目并设置投影

    选择 File | New Project…,进入工作目录,填写 Title 与 File Name 后保存(官方示例命名 GeometryDevelopment.prj)。

    打开 RAS Mapper,选择 Tools | Set Projection for Project(旧版本位于 Project 菜单),浏览到 GISData 文件夹选择 projection.prj 并确定。投影定义了整个项目所有空间数据(地形、几何、结果)的坐标系统,必须在导入任何空间数据前设置,否则后续图层会错位。

    新建项目(New Project)官方截图
    新建项目对话框
    填写 Title 与 File Name(自动带 .prj 后缀),选择项目文件夹。来源:HEC 官方《Developing 1D Geometric Data with RAS Mapper》
    设置投影(RAS Mapper Options)官方截图
    RAS Mapper Options 投影设置
    加载 projection.prj 后,Definition 区显示完整 PROJCS 坐标系定义。来源:HEC 官方《Developing 1D Geometric Data with RAS Mapper》
  2. 下载地形数据(可选在线获取)

    选择 Project | Download Data | USGS Terrain(或 GRID Terrain),数据范围选 Current View,点击 Query Products 查询 USGS 服务;在数据筛选中勾选 Original(原始分辨率)并 Apply;用图形选择工具选中覆盖河谷洪泛区的瓦片,点 Add Selected 加入下载列表,再点 Start Download。无网络时可直接使用教程附带的 Terrain 文件夹中的地形文件。

  3. 创建地形模型(Terrain)

    选择 Project | Create New RAS Terrain,点 + 添加地形文件(官方示例为 5 个 .flt 瓦片,也可选 .tif/DEM);把 Rounding (Precision) 设为 1/32;按需勾选 Create Stitches(缝合)与 Merge Inputs to Single Raster(合并为单一栅格);点 Create 生成 Terrain.hdf。

    为什么先建地形?地形是所有几何与结果的共同底图:1D 断面提取高程、2D 网格提取单元高程、淹没制图比较水位都依赖它。它把多幅 DEM 合并、重投影、统一精度为一份 .hdf 文件。
    创建地形(New Terrain Layer)官方截图
    New Terrain Layer 对话框
    添加 5 个地形瓦片,Rounding 1/32、勾选 Merge Inputs to Single Raster 后点 Create。来源:HEC 官方《Developing 1D Geometric Data with RAS Mapper》
  4. 检查地形显示

    创建完成后双击 Terrain 图层打开 Layer Properties,按需开启:Update Legend with View(图例随视野更新)、Plot Contour(显示等高线并可调间隔)、Plot Surface(显示地表)、Plot raster file outlines / names(栅格文件边界与名称)。借此检查地形覆盖范围是否完整、是否存在 NoData 空洞——空洞会影响后续断面/网格的高程提取,发现后应补充数据或先做修补再建地形。

阶段 C · 创建几何与图层关联
  1. 新建几何并绘制河网

    在 RAS Mapper 中右键 Geometries 节点,选择 Add New Geometry 并命名(官方示例 Existing);选中几何后点铅笔图标进入编辑。

    点击 Rivers 节点开始绘制河网:河流/河段从上游画到下游(正流向),左键单击加点、双击结束一条线;右键可重新定位地图中心,Shift 拖拽平移、滚轮缩放。画完一条河段会弹出 Provide River and Reach Name 命名窗口(官方示例:Baxter River / Main)。支流画到主流上时,程序会提示创建 junction——依次确认拆分主流、为下游河段命名(如 Main-Lower)、命名 junction 即可。河段名默认显示在河段起点。

    官方教程研究区河网(Baxter 河与 Tule 支流)官方截图
    Baxter 河与 Tule 支流河网
    两支流在 Junction 汇合,主流分 Upper / Lower 两段。来源:HEC 官方《Developing 1D Geometric Data with RAS Mapper》
  2. 布置断面(Cross Sections)

    选择 Tools | Options 可把 XS River Stations 单位改为 Miles(可选)。点击 Cross Sections 节点,沿每条河段布置断面(官方示例每条河段约一打断面),以合理表达 1D 河槽-洪泛区水流。断面必须面向下游从左到右绘制!

    每条断面绘制后自动获得 River Station(按中心线距离计算,默认英尺)。画完点击工具栏的 Plot 按钮可弹出 RASMapper Plot 查看高程剖面:绿线为从地形提取的断面(Terrain),红色为当前断面(Profile),圆点为岸滩点(Bank Points)——新增断面时两者一致;再画下一条,剖面图会自动更新。

  3. 编辑断面与从地形更新

    选中断层面,双击断面进入编辑,拖动端点可加宽断面、改变其跨越洪泛区的方式;观察剖面图变化。注意:已存在的断面被视为"已有断面",程序不会自动用地形覆盖其数据(防止误覆盖人工编辑)。需要重新贴合地形时,右键断面选择 Update Cross Section | Elevation Profile from Terrain,再 Plot 核对剖面与地形线是否一致。

  4. Auto Update Geometry 与图层关联

    编辑状态下右键几何图层选择 Auto Update Geometry,点 Check All Properties 勾选全部属性(River Stations、Bank Stations、Reach Lengths、Elevations – Channel / Overbanks、Ineffective Areas、Blocked Obstructions、Manning's n Values 等)。此后在 RAS Mapper 中移动断面、改动中心线,保存时这些属性会自动从地形与几何重新计算。

    再用 Project | Manage Geometry Associations(或 RAS Geometry Properties 里的 Manage Associations)把 Terrain、Land Cover 等图层关联到几何——这是断面提取高程、按土地覆盖提取糙率的前提。

阶段 D · 结果映射与动画
  1. 添加结果图层

    运行方案后,RAS Mapper 的 Results 组会按 Plan Short ID 列出方案。右键方案节点选择 Add Results Map(或右键 Results 组添加):选择 Map Type(WSE 水面高程、Depth 水深、Velocity 流速等)、Unsteady Profile(非恒定流的某个时刻 / Max / Min)与 Map Output Mode(动态或存储),点 Add Map 生成结果图层。

  2. 动画与最大值查看

    勾选结果图层后,用地图窗口顶部的动画控制条播放/步进非恒定流各时刻;点 Max 按钮切换到最大淹没(Depth (Max)、Velocity (Max) 等),快速定位最不利时刻。

    动态图实时渲染,适合交互浏览;需要批量处理或加速大模型显示时,可右键 Results 组打开 Manage Results Maps 对话框,选中图层点 Compute/Update Stored Maps 预计算存储图(状态变为 Map files up to date),可一次处理多个方案,并支持复制、删除结果图。

  3. 剖面与区域统计

    底部 Profile Lines 标签页可沿任意剖面线提取水面线与河床纵剖面,用于对比沿程水位;Active Features 允许点击单元/断面交互查询属性;Layer Values 显示鼠标位置图层值。添加 Reference Point / Line / Polygon 后可聚合区域内单元结果,计算总水量、平均流速、净冲淤等(对水库蓄量、淹没体积分析很有用)。

阶段 E · 端到端淹没制图与导出
  1. 准备地形

    Project | Create New RAS Terrain:导入 DEM/栅格(可多幅合并),生成 .hdf 地形文件,并用 Tools | Set Projection for Project 设置坐标系统。

  2. 布置几何并关联图层

    创建几何(河网、断面、2D 网格)后,在 Manage Layer Associations 中把 Terrain 与 Land Cover 关联到对应几何,2D 网格会从地形提取单元高程、断面按土地覆盖取糙率。

  3. 运行计算

    在主界面运行恒定流或非恒定流方案,结果自动写入 RAS Mapper 的 Results 图层。

  4. 映射与动画

    勾选 WSE / Depth / Velocity 图层查看淹没范围;选中 Results 组图层,用动画控制条的 Max 按钮显示最大淹没;Profile Lines 标签页可沿任意剖面线提取水面线。

  5. 参考区域统计

    添加 Reference Polygon 后可聚合区域内单元结果,计算总水量、平均流速、净冲淤等(对水库蓄量、淹没体积分析很有用)。

  6. 导出与发布

    右键结果图层可 Export 为 Shapefile / GeoTIFF 等格式,供 GIS 软件继续处理;File | Export Map Image 导出当前视图图片用于报告;需要网页/地图服务展示时可导出 Google Earth KML/KMZ。

    RASter Calculator(栅格计算器,Map Layers 下)可对栅格图层做代数运算:例如 Cut/Fill 挖填方分析、两个方案的淹没深度差(100 年 vs 50 年)、淹没范围布尔提取等,是方案对比与工程分析的有力工具。

在线数据下载:RAS Mapper 可直接从 USGS Terrain 与 GRiD Terrain 服务查询并下载高程瓦片,无需离开软件即可获取建模地形。
05 · Tutorial 5 · Hydraulic Structures

官方教程五:结构物建模(桥梁 / 涵洞 / 堰闸)

桥梁、涵洞、堰闸、堤防是洪水计算里最常见的"卡脖子"断面。本节按 HEC-RAS User's Manual 第 5 章《Bridges and Culverts / Inline Structures / Lateral Structures》的操作顺序:先布好结构物前后的断面,再打开 Bridge/Culvert、Inline、Lateral 编辑器逐项填高程与系数,最后用恒定流/非恒定流算过流与壅水。

本教程能回答的问题:桥前壅水多高?会不会封桥(压力流)?涵洞过流能力够不够?闸门开启后水位怎么变?分洪后下游洪峰削多少?
官方损失三段式:结构物水头损失 = 进口收缩 + 桥/涵内(含墩台、摩擦、压力流/堰流) + 出口扩散。收缩/扩散系数一般加在结构物前后的断面上(Bridge/Culvert 编辑器可改),不要只在桥址一个断面上硬凑。
阶段 A · 断面布置与损失系数
  1. 布置结构物上下游断面

    打开 Geometric Data Editor,沿河布设断面时保证:

    • 结构物上游至少 1–2 个断面,用于量测壅水与进口损失。
    • 结构物下游同样留出断面;官方明确:不要把断面紧贴桥面/涵洞出口(例如只离 1 ft),否则扩散段解析不开。
    • 路堤、锥坡、河槽变化处断面要够密。

    断面应垂直于流向、覆盖整个路堤与洪泛区。

  2. 设置收缩与膨胀系数

    在断面表中设置 Contraction / Expansion(恒定流与非恒定流同一套几何):

    • 渐变段:收缩约 0.1、膨胀约 0.3 量级起步
      Geometric Data Window(几何数据总窗)官方截图
      Geometric Data Window
      断面、桥涵、堰闸等几何数据的统一入口。 来源:HEC-RAS User's Manual(官方手册插图)
      。
    • 桥墩密集、进口突变:收缩可取更大;以实测壅水或设计资料校核。

    结构物编辑器里还能针对桥/涵单独调整损失,避免与断面系数重复计入。

  3. 打开 Bridge/Culvert 编辑器

    点工具栏 Bridge/Culvert 按钮(或 Edit | Bridge & Culvert Data…)。空白工程会先提示输入 River / Reach / Station(结构物中心桩号,落在两断面之间)。

    左侧树里将看到:Bridge Deck、Pier、Culvert、Bridge/Culvert Options、View 等节点——后面几步按此填写。

    Bridge/Culvert Data Editor官方截图
    Bridge/Culvert Data Editor
    工具栏 Bridge/Culvert 打开后的总编辑器:左侧结构树,右侧为各页数据表。 来源:HEC-RAS User's Manual(官方手册插图)

阶段 B · 桥梁建模(Bridge)
  1. 录入桥面数据(Bridge Deck)

    选中桥节点下的 Bridge Deck,逐行填(典型字段):

    • Upstream / Downstream Station — 桩号(桥面上、下游缘)
      Bridge Deck 叠在上下边界断面上(官方示例)官方截图
      Bridge Deck 与边界断面
      桥面高程要落在上下游断面之间;Low/High Chord 决定孔流、压力流与漫顶堰流。 来源:HEC-RAS User's Manual(官方手册插图)
      。
    • Low Chord — 桥面底缘高程(决定何时进入压力流/堰流)。
    • High Chord — 桥面顶缘高程(漫顶堰流)。
    • Width / 面积、斜率 — 路面宽度、上下游边坡(US/DS Slope)。
    桥前壅水 扩散段 Bridge Deck(Low/High Chord) Piers 墩台 上游断面(勿贴桥面)
    桥梁纵剖面示意(教学用):Low Chord 以下为孔流;水位漫过桥面走堰流;能坡压过 Low Chord 可能出现压力流。
  2. 录入墩台数据(Pier)

    在 Pier 页填墩型(圆端/矩形等)、墩宽、墩数、墩台起止高程。墩台会占去过水面积,与桥面共同决定有效过流宽。

    多孔桥:按实际墩位分列;特大桥可配合 Multiple Bridge Openings。

    Pier Data Editor(墩台)官方截图
    Pier Data Editor
    墩型、墩宽、起止高程占去过水面积。 来源:HEC-RAS User's Manual(官方手册插图)

  3. 认识三类过流(Low / Weir / Pressure)

    • 低流 Low flow — 孔口内明渠/水跃,能量方程 + 收缩膨胀。
    • 堰流 Weir flow — 水位上桥面/路堤,用堰公式并按淹没度折减。
    • 压力流 Pressure flow — 能坡高于 Low Chord,按孔口/闸孔公式;与低流结果比较取控制。

    高水也可能"压力流 + 漫顶堰流"同时出现(pressure and weir)。

  4. 设置 Bridge/Culvert Options

    打开 Bridge and Culvert Options:按需调整损失计算、水跃、是否允许压力流等开关(版本略有差异,以当前界面为准)。

    用 Bridge View / XY Plot 看桥前壅水、孔内流态是否合理;不对先改 Deck/墩/系数,不要只调糙率。

    Bridge Modeling Approach(建模途径选项)官方截图
    Bridge Modeling Approach Editor
    选择桥梁计算途径(如 WSPRO/能量方程等,随版本略有差异)。 来源:HEC-RAS User's Manual(官方手册插图)

阶段 C · 涵洞建模(Culvert)
  1. 添加涵洞并选择断面型式

    同一 Bridge/Culvert 站点下选 Culvert → Add Culvert。型式支持圆管、箱涵、拱、管涵、低高度箱涵等(官方基于 FHWA《Hydraulic Design of Highway Culverts》进口控制 + 出口能量平衡)。

    填:断面尺寸、长度、糙率 n、进口/出口高程、翼墙/进口型式(控制进口损失)。

    Culvert Data Editor官方截图
    Culvert Data Editor
    选圆管/箱涵/拱等型式,填尺寸、长度、n 与进出口高程。 来源:HEC-RAS User's Manual(官方手册插图)

  2. 设置多孔桥涵(Multiple Openings)

    可对同一站点放 多个 Culvert / Bridge Opening。官方支持 Multiple Bridge and/or Culvert Openings:分别定义各孔,再一起求水面。

    填完用 View 检查进口是否淹没、出口是否贴近下游断面(过近会虚增损失)。

    含示例涵洞的 Bridge/Culvert 编辑器官方截图
    含涵洞的 Bridge/Culvert 编辑器
    同一站点可放桥+涵、多孔涵。 来源:HEC-RAS User's Manual(官方手册插图)

阶段 D · 堰闸与坝(Inline Structure)
  1. 创建 Inline Structure

    工具栏 Inline Structure:在河段上点击结构物中心位置(桩号落在断面之间),输入 River/Reach/Station。

    打开 Inline Structure Data:添加 Weir(堰)、Gate(闸门,含平板/弧形等)、Spillway(溢洪道)等组件。

    Inline Structure Data Editor官方截图
    Inline Structure Data Editor
    河中堰坝闸的总编辑器:Weir / Gate / Spillway 分页。 来源:HEC-RAS User's Manual(官方手册插图)

  2. 录入堰闸与流量系数

    • Weir:堰顶高程、堰宽/长度、堰流系数 Cd、侧收/淹没修正
      Gate / Weir 编辑器(示例)官方截图
      闸门编辑器
      闸底坎、开度、流量曲线;堰顶与堰流系数在 Weir 页。 来源:HEC-RAS User's Manual(官方手册插图)
      。
    • Gate:闸底坎高程、闸门宽、开度过程(恒定流给固定开度;非恒定流可给开度时间序列或规则)。
    • Spillway:溢流面/设计水位–流量关系。

    非恒定流可用 Rule Sets 做闸门调度(按上游水位/流量自动开度)。

  3. 设置坝体溃口(可选)

    堰顶以上可算漫顶;若做溃坝,可在 Inline Structure 上设置 Breach(溃口底高、宽度、边坡、溃决历时),详见手册 "Dam (Inline Structure) Breach"。

    先用恒定流核对各特征水位过流能力,再上非恒定流溃决过程。

    Dam Breach Editor(溃口)官方截图
    Dam Breach Editor
    溃口底高、宽度、边坡、溃决历时等。 来源:HEC-RAS User's Manual(官方手册插图)

阶段 E · 侧向结构(Lateral Structure)
  1. 创建 Lateral Structure

    点 Lateral Structure,从河道一侧沿堤线/分洪堰绘制;一端连主河,另一端可接 Storage Area 或 2D 区。

    方向影响正负流量符号——按官方:顺着约定的正流向绘制,反向流会记为负。

    Lateral Weir / Gated Spillway / Culvert Editor官方截图
    侧向结构编辑器
    堤顶/堰顶剖面 + 闸、涵、分洪曲线。 来源:HEC-RAS User's Manual(官方手册插图)

  2. 录入堤顶与结构数据

    填沿线堤顶高程剖面(station–elevation);若带闸/涵,用 Lateral 上的 Weir / Gate / Culvert 组件。

    漫溢后可启用 Breach(堤防溃决)或 Diversion Rating Curve(分洪能力曲线)。

  3. 连接蓄洪区(Storage Area)(可选)

    用 Storage Area 工具画容积区,填水位–容积关系;用 SA/2D Area Conn 连接涵/堰/闸。水泵可用 Pump Station 连接两个蓄水区或河段。

    堤防 + 蓄洪区示意(官方示例)官方截图
    堤防与蓄洪区
    Lateral Structure 一端接主河,一端接 Storage Area。 来源:HEC-RAS User's Manual(官方手册插图)

阶段 F · 运行评估与桥梁冲刷
  1. 用恒定流验算过流能力

    按设计流量跑恒定流,看桥前壅水、孔内流态、堰闸泄量是否在合理范围;与设计流量–水位关系对比。

    再切非恒定流(见「官方教程二」)看过程线与最大淹没。

  2. 计算桥梁冲刷(可选)

    官方手册第 11 章 Computing Scour at Bridges:在桥上录墩台与河床质,算一般冲刷+局部冲刷。2D 另有 Bridge Scour 分析(可导出 FHWA Hydraulic Toolbox)。

    Scour at Bridges 计算窗口官方截图
    桥梁冲刷计算窗口
    录入墩台与河床质后计算一般冲刷+局部冲刷。 来源:HEC-RAS User's Manual(官方手册插图)

  3. 结构物常见问题

    • 断面贴桥面 → 扩散解析差、水头损失虚大;把下游断面挪远。
    • Low/High Chord 填反 → 流态全错(未上桥就算压力流)。
    • 系数重复 → 断面收缩膨胀与桥涵损失都很大 → 检查是否双计。
    • 压力流/堰流跳变 → 时间步或迭代问题,非恒定流可开 Advanced Time Step,或微调 Low Chord/糙率。
    • 涵洞出口贴断面 → 同桥,出口扩散要有距离。

官方手册入口:User's Manual(Ch.5 Bridges/Culverts/Inline/Lateral · Ch.11 Bridge Scour)· Guides & Tutorials

06 · Tutorial 6 · Dam & Levee Breach

官方教程六:溃坝与溃堤分析

溃坝/溃堤是 HEC-RAS 非恒定流的经典应用:在坝(Inline Structure)或堤(Lateral Structure)上定义溃口,让程序在演进过程中逐步下切、拓宽,算出溃决洪水波与淹没。本节按官方 User's Manual 第 7 章「Performing a Dam or Levee Breach Analysis」与第 14 章详细讨论,从几何打底到两种溃口方法、进展曲线、参数计算器,一步步填到能跑能读。

本教程能回答的问题:溃口何时形成、张多宽、切多深?下游洪峰何时到、淹到哪?抢险堵口(Breach Repair)有没有用?——先把坝/堤几何建稳,再在 Plan 数据里开溃口,可反复改参数而不重跑几何预处理。
溃口数据存在 Plan 里:官方特意把 Breach 存成方案(Plan)数据——你可以同一套几何试不同溃口位置/尺寸,而不必重跑 Geometric Preprocessor。入口:Inline Structure 编辑器上的 Breach (Plan Data) 按钮,或 Unsteady Flow Simulation 窗口 Options | Dam (Inline Weir) Breach / Levee (Lateral Structure) Breach。
阶段 A · 坝/堤几何准备
  1. 准备非恒定流模型

    按「官方教程二」把非恒定流跑稳:有入流过程线、初始条件、合理时间步。溃决是在演进过程中"打开"的缺口,底模不稳则溃决结果不可信。

    库区可用河道宽断面或 Storage Area 表示;下游应延伸到关注区以外。

  2. 创建坝体(Inline Structure)

    工具栏 Inline Structure 在坝轴线位置点击,填 River/Reach/Station。在 Inline Structure Data 中至少定义 Weir(坝顶/溢流面)高程与宽度,必要时加 Gate/Spillway。

    溃决前,坝应能按设计挡水/溢流——先用恒定流核对坝前水位。

    Inline Structure 示例坝官方截图
    Inline Structure 示例坝
    溃口将作用在这个 Inline Structure(堰体)上。来源:HEC-RAS User's Manual Fig.14-5
  3. 创建堤防(Lateral Structure)

    点 Lateral Structure 沿堤线绘制,填堤顶高程剖面;另一端可接 Storage Area(背水侧涝区)或 2D 区。

    Lateral Structure 堤防数据示例官方截图
    堤防 Lateral Structure 数据
    堤顶高程剖面 + 漫溢/溃口将定义在该结构上。来源:HEC-RAS User's Manual Fig.14-18
阶段 B · 打开溃口编辑器
  1. 打开 Dam Breach Editor

    两种入口任选:

    • Inline Structure 编辑器 → 点 Breach (Plan Data)
    • Unsteady Flow Simulation(Plan)→ Options | Dam (Inline Weir) Breach…

    在编辑器顶部左侧勾选 Breach This Structure——只有勾上才会溃;不勾可保留参数暂不启用。

    下拉选择要溃的 Inline Structure;多坝可逐个定义。

    Dam Breach Editor官方截图
    Dam Breach Editor
    总编辑器:启用勾选、方法选择、尺寸/时间/触发等页签。来源:HEC-RAS User's Manual Fig.7-58
  2. 选择溃口方法

    • User Entered Data — 你直接给最终溃口尺寸、形成历时、进展曲线。工程上最常用、最好控。
    • Simplified Physical — 给"流速–下切率 / 流速–展宽率"关系,程序按实时流速动态发展溃口(更"物理",参数更难率定)。

    新版本还可能提供 Physical(DLBreach)等,以当前界面下拉为准。

阶段 C · 用户输入溃口参数
  1. 设置最终溃口尺寸

    官方字段(梯形溃口):

    • Final Bottom Elevation — 溃口刷深后的底高程(最终形态)。
    • Final Bottom Width — 最终底宽。
    • Left / Right Side Slope — 边坡 H:V(如填 2 表示水平 2 : 垂直 1;两侧都 0 = 矩形)。
    • Breach Weir Coefficient — 溃口处堰流系数(漫顶溃决或堰顶溃口常用)。
    Dam Breach Data Editor(含示例坝)官方截图
    溃口数据编辑器示例
    在示例坝上填入最终溃口底高、底宽、边坡等。来源:HEC-RAS User's Manual Fig.14-6
  2. 设置溃口形成时间与触发条件

    关键时间参数:

    • Breach Initiation Time(或由触发推算)— 溃口开始时刻。
    • Full Formation Time — 从开始到达到最终尺寸的历时。

    触发方式常见:

    • 指定时刻 — 直接给开始时间。
    • 水位阈值 — 坝前/堤前水位达到某高程后开始。
    • WS Elev + Duration — 水位超过阈值并持续一段时间才触发(更符合"泡软了才溃")。
  3. 设置溃口进展曲线(可选)

    默认:从开始到 Full Formation Time 线性发展。要非线性时切到 Breach Progression 页签:

    • 填 Time Fraction(0–1)与 Breach Fraction(0–1)点列。
    • 可选 Vertical/Horizontal Growth Ratio:竖向下切与水平展宽的比例(如 0.5 表示竖向速率是水平的一半)。
    User Specified Breach Progression官方截图
    用户指定溃口进展曲线
    Time Fraction–Breach Fraction 曲线控制溃口发展形态。来源:HEC-RAS User's Manual Fig.7-59
    Nonlinear Breach Progression 示例官方截图
    非线性溃口进展
    非线性进展与竖/水平发展比。来源:HEC-RAS User's Manual Fig.14-7
  4. 设置溃口回填(Breach Repair)(可选)

    切到 Breach Repair 页签:可在模拟中途让溃口回填,表示抢险抢堵或修复。

    适合做"若某时刻开始堵口,下游洪峰会怎样"的情景对比。

    Breach Repair 页签官方截图
    溃口回填修复
    模拟过程中回填溃口。来源:HEC-RAS User's Manual Fig.14-8
  5. 用 Parameter Calculator 估算初值

    切到 Parameter Calculator:输入坝体物理信息(坝高、库容、材料等,以界面为准),用回归公式估算:

    • 溃口底宽 · 边坡 · 形成历时

    把结果抄回 User Entered Data 作起点,再按风险分析假定做情景包络(偏保守、偏不利)。

    Breach Parameter Calculator官方截图
    溃口参数计算器
    回归方程估算溃口尺寸与历时。来源:HEC-RAS User's Manual Fig.14-11
阶段 D · 简化物理法(Simplified Physical)
  1. 设置 Simplified Physical 参数

    方法下拉选 Simplified Physical 后,界面字段会变:

    • 底宽上限 / 底高程下限:不是"最终尺寸",而是限值——实际发展由侵蚀关系与水力决定,不会超过你设的界。
    • Starting Notch Width(漫顶)或 Initial Piping Diameter(管涌)— 初始缺口/初始管径。
    Simplified Physical 溃口选项官方截图
    简化物理法溃口
    改为限值型参数 + 侵蚀关系。来源:HEC-RAS User's Manual Fig.7-60
  2. 录入流速与侵蚀率关系

    在 Simplified Physical 页签填两组曲线:

    • Velocity vs Downcutting Erosion Rate — 流速–下切速率
    • Velocity vs Widening Erosion Rate — 流速–展宽速率

    没有实测时可用文献/经验土侵蚀参数;该法对关系曲线敏感,务必做敏感性。

    流速–侵蚀率输入官方截图
    流速与侵蚀率关系
    按时间步根据实时流速发展溃口。来源:HEC-RAS User's Manual Fig.7-61
阶段 E · 堤防与连接溃口
  1. 打开 Levee Breach 编辑器

    Plan 窗口 Options | Levee (Lateral Structure) Breach…,或 Lateral Structure 编辑器中的 Breach 入口。字段与坝溃口一致(尺寸、历时、进展、修复)。

    Levee Breaching Editor官方截图
    堤防溃决编辑器
    与 Dam Breach 同类参数,作用在 Lateral Structure 上。来源:HEC-RAS User's Manual Fig.7-62
    堤防溃口完整编辑器(官方示例)官方截图
    堤防溃口编辑器
    含触发、进展等页签的完整界面。来源:HEC-RAS User's Manual Fig.14-19
  2. 设置 SA/2D 连接溃口(可选)

    蓄洪区连接(SA/2D Area Connection,可含堰、闸、涵)也能设溃口:在连接编辑器上点 Breach (plan data)。参数与坝/堤相同。

阶段 F · 运行与结果分析
  1. 短时间窗试算

    先跑含触发前后的短时段,用 Profile Plot / 过程线看:

    • 触发时刻是否合理(水位是否达到阈值)。
    • 溃口是否从初始缺口发展到最终尺寸。
    • 库水位是否在溃后快速下降。

    再跑完整演进与淹没。

  2. 查看溃决过程线与淹没结果

    • Breach Hydrograph — 溃口下泄流量过程。
    • 坝前/库区水位 — 溃后库容释放。
    • 下游各断面洪峰与到时 — 淹没与预警时间。
    • RAS Mapper 最大淹没 / 动画 — 风险图。
  3. 稳定性与情景对比

    • 溃口发展过猛时先减小计算时间步,或开 Advanced Time Step Control。
    • 至少做一组情景包络:偏快形成 vs 偏慢形成;宽/窄溃口;有/无 Repair。
    • User Entered 与 Simplified Physical 各跑一遍对比量级。
    • 改溃口参数只动 Plan,不必重跑几何预处理。
    溃口参数不确定性很大,结果应用作风险比较与应急推演,而非单一"真值预报"。参数来源(回归公式、历史溃坝、专家假定)要写进报告。

官方手册入口:User's Manual(Ch.7 Dam/Levee Breach · Ch.14 详细讨论与回归参数)· Guides & Tutorials

07 · Tutorial 7 · Combined 1D/2D

官方教程七:1D/2D 耦合建模

河道用 1D 高效算水面,滩地/城区/涝区用 2D 刻画流向与淹没——这是工程上最常见的"组合拳"。本节按官方 User's Manual 第 5 章 2D Flow Area / SA-2D Connection 与 Guides《Creating a Combined 1D/2D Model》的路径:先定分工,再画 2D 边界与网格、做连接与边界,最后在非恒定流里耦合求解。

本教程能回答的问题:主槽过流多少、滩地漫过去多少?堤决后涝区怎么淹?城区道路挡水后积水往哪走?——1D 管"槽",2D 管"面",连接管"交换"。
官方建模惯例:先做稳的 1D 模型理解水系(低水找主槽、高水找洪泛区),再把需要二维流向的区域做成 2D Flow Area。连接方式常见三种:① 1D 断面直接盖住滩地(简单漫滩);② Lateral Structure(堤/堰/溢流);③ SA/2D Area Connection(蓄水区与 2D 之间涵/堰/闸)。耦合计算在 Unsteady Flow 中完成。
阶段 A · 模型分工与几何准备
  1. 划分 1D 与 2D 计算范围

    • 1D:深窄河谷、流向单一的主槽、已有可靠断面的河段。
    • 2D:滩地宽阔、堤内涝区、城区道路阻水、回流/分流明显处。
    • Storage Area:只需"一个水位"的湖库/涝区,比 2D 省机时。

    在纸上或 GIS 里划好 1D 中心线、2D 多边形、堤线与连接位置,再动手建模。

  2. 完成 1D 几何(中心线与断面)

    按「官方教程一」布好主槽断面;滩地若并入 1D 断面,断面要够宽;若滩地改 2D,断面可只保留主槽+近岸。

    断面上可加 Levee(堤顶)与 Ineffective Flow(无效过水区)做初步漫滩控制。

    断面 Levee 选项官方截图
    断面堤顶选项
    1D 断面上的堤顶:不到该高程不向滩地分水(简化漫滩)。来源:HEC-RAS User's Manual Fig.5-5
    无效过水区(Ineffective)官方截图
    无效过水区
    回流/死水区设无效,避免虚假过流。来源:HEC-RAS User's Manual Fig.5-3
  3. 打开 Geometric Data 编辑器

    几何编辑器工具栏中你会用到:2D Flow Area、Break Lines、Generate Mesh、SA/2D Area Conn、Storage Area、Lateral Structure、BC Lines。

    左侧 2D Flow Area 编辑器用于改单元尺寸、显示/选择区域。

阶段 B · 2D 计算域与网格
  1. 绘制 2D 区边界(Perimeter)

    点 2D Flow Area 工具:在滩地/涝区/城区单击加点,双击结束,输入名称(如 Floodplain)。

    边界应盖住可能淹没的范围,但不必无限放大(单元数×时间)。

    绘制 2D Flow Area 边界官方截图
    绘制 2D 边界
    沿 2D 区外缘加点,双击结束并命名。来源:HEC-RAS User's Manual
  2. 添加 Breakline

    点 Break Lines,沿堤顶、路基、深槽绘制线,命名。Breakline 强制单元边(face)贴合地物,防止水"穿堤"。

    • 堤/路:沿脊线画。
    • 主槽深切:可沿深泓加密。
    • 与 1D 河道相邻处:边界线与 1D 位置对齐。
    网格与 Breakline(堤内涝区示例)官方截图
    2D 网格示例
    堤防保护区内 2D 网格:Breakline 让堤线成为单元边界。来源:HEC-RAS User's Manual Fig.5-44
    地物附近网格加密官方截图
    网格局部加密
    道路/堤防等处加密,单元边贴地物。来源:HEC-RAS User's Manual
  3. 生成计算网格(Generate Mesh)

    在 2D Flow Area 编辑器中设 Cell Spacing(目标单元尺寸),点 Generate Mesh。

    • 单元尺寸经验:约 DEM 分辨率的 2–5 倍起步;不小于 DEM。
    • 主槽/建筑周边用更小尺寸或局部 Refinement。
    2D Flow Area Mesh Generation Editor官方截图
    网格生成编辑器
    设置单元尺寸并生成网格。来源:HEC-RAS User's Manual Fig.5-42
  4. 认识网格要素(Cell / Face / Face Point)

    2D 网格术语:Cell Center / Face / Face Point官方截图
    2D 网格术语
    Cell Center 算水位水深;Face 过流量;Face Point 是角点。来源:HEC-RAS User's Manual Fig.5-46

    在 Mesh 编辑器里检查:有无畸形单元、漏缝、堤线是否被"锯齿"切断。有问题改 Breakline 后重新 Generate。

阶段 C · 1D 与 2D 连接
  1. 连接方式一:断面漫滩

    1D 断面范围盖过滩地,靠水面横向比降分水。适合河道与滩地一体、不需要精细二维流态的河段。注意断面间距与滩地阻力。

  2. 连接方式二:侧向结构(Lateral Structure)

    沿堤/路画 Lateral Structure,填堤顶剖面;漫溢或溃决后向 2D 区(或 Storage Area)分水。可带闸、涵。

    一端连 1D 河段,另一端指向 2D/蓄水区(按软件版本的连接规则放置)。

  3. 连接方式三:SA/2D Area Connection

    点 SA/2D Area Conn,在蓄水区与 2D 区(或两个 2D 区)之间画连接线:顺着正流向从左到右绘制,双击结束并命名——方向决定正负流量符号。

    SA/2D Area Connection Editor官方截图
    SA/2D 连接编辑器
    连接线上可组合 Weir / Culvert / Gate。来源:HEC-RAS User's Manual Fig.5-48
    连接上的 Weir/Embankment官方截图
    连接堰/堤
    堰顶高程与宽度决定何时过水。来源:HEC-RAS User's Manual Fig.5-49

    中心线与属性表:

    Hydraulic Structure Centerline Data Table官方截图
    水力结构中心线表
    沿线桩号–高程等。来源:HEC-RAS User's Manual Fig.5-51
  4. 设置 2D 区边界条件(BC Lines)

    点 SA/2D Area BC Lines,沿 2D 区外缘需要给边界处画线,命名后在 Unsteady Flow Data 中给类型:

    • Flow Hydrograph / Stage Hydrograph / Rating Curve

    与 1D 相邻的边通常不设外部边界,靠耦合交换。

阶段 D · 边界条件与计算设置
  1. 输入 1D 与 2D 边界数据

    1D 上游/下游按「官方教程二」;2D 的 BC Line 会出现在同一编辑器里,逐条给过程线。

    Initial Conditions:1D 给初始流量;2D 区可给初始水位/干湿状态(按界面选项)。

  2. 设置 2D Flow Options

    Plan → Computation Options and Tolerances… → 2D Flow Options:

    • Equation Set:扩散波(快)或完整浅水方程 SWE(泥沙/复杂流态必用 SWE)。
    • Warmup:先湿润网格再正式算。
    • Time Slices / 2D 时间步:2D 往往要更小步长。
    • 求解器、紊动等按「2D 建模入门」与泥沙章的建议。
  3. 设置时间步长

    1D/2D 同时算时,先短窗试算。2D 单元小则时间步要小;可用 Advanced Time Step Control。振荡多发生在连接线、堤顶、窄通道——优先查网格与连接几何。

阶段 E · 运行与结果检查
  1. 运行并查看交换流量

    • RAS Mapper:2D 水深/流速/水位 + 1D 纵剖面。
    • 连接线/堤上的流量过程(检查交换是否合理)。
    • 对比纯 1D 方案:滩地淹没范围、洪峰是否因二维路径改变。
  2. 常见问题

    • 水穿堤 → Breakline 没贴堤脊或网格太粗;重新生成网格。
    • 连接线不过水 → 方向画反、堰顶高程太高、两区域没真正搭接。
    • 2D 边界溢出 → BC 位置/类型不当,或 2D 范围不够。
    • 极慢/不稳 → 单元过多或步长过大;先局部加密而不是全域细化。
    • 与 1D 水位对不上 → 断面范围、无效区、糙率分工(主槽 vs 滩地)要分开校。
    耦合模型参数更多:先保证 1D 与 2D 各自合理,再调连接。一次只动一类参数,用 Plan 对比。

官方入口:Creating a Combined 1D/2D Model · User's Manual(Ch.5 2D Flow Area / SA-2D Conn)

08 · Tutorial 8 · Calibration & Sensitivity

官方教程八:模型率定与敏感性分析

模型能算只是起点,要能用必须经得起实测检验。本节按官方 User's Manual 第 7 章《Calibration of Unsteady Flow Models / Model Sensitivity》的顺序:先整编率定资料,再按"恒定流定 n → 非恒定流调过程线 → 分项微调 → 敏感性包络"推进,最后形成可审查的率定报告。

本教程能回答的问题:糙率取多少才"对"?洪水过程线差在峰、量还是时间?哪些参数最影响结果?——率定是"用观测约束参数",不是"把曲线凑好看"。
官方五步法(Unsteady):① 恒定流多流量级率定 n 至率定曲线/高水位;② 选完整涨落事件做非恒定流;③ 调断面蓄量(无效区)与侧向堰,使流量过程线在时间、洪峰、水量、形态上接近;④ 调曼宁 n 使水位过程线接近;⑤ 用 Discharge–Roughness 等手段做低水到高水的细调。
阶段 A · 准备率定资料
  1. 整编实测水文资料

    按官方《Observed Hydrologic Data》清单收集并做质量检查:

    • 水位(Stage):最可靠,一般可达 ±1 ft 量级;查水位计卡滞、记录仪零漂、水尺基面错误、地面沉降。
    • 流量(Flow):多由水位–流量关系推求,误差通常更大;注明测流方式与不确定度。
    • 高水位痕迹(High Water Marks):洪水调查点,作空间校核。

    在 HEC-RAS 中可用 Observed Data 录入,供过程线叠绘。

  2. 选定率定事件与评价指标

    事件应覆盖低水 → 洪峰 → 退水全过程。事先约定评价指标,例如:

    • 洪峰相对误差 · 峰现时间差 · 水量相对误差 · 水位均方根误差(RMSE)

    建议同时保留 1 场率定、1 场验证(不参与调参)。

  3. 建立基准方案(Base Plan)

    冻结一版几何与边界,命名 Cal-Base。此后每改一类参数另存新 Plan,形成可回溯的方案树。

    Unsteady Flow Computations Window官方截图
    非恒定流计算窗口
    率定反复运行的入口:方案、输出间隔与计算设置。来源:HEC-RAS User's Manual
阶段 B · 恒定流率定 n 与水位流量关系
  1. 多流量级恒定流试算

    官方步骤 1:尽可能用恒定流跑一组流量(低、中、高),对照水尺率定曲线与已知高水位。

    1D 恒定流工具:Profile Plot、Rating Curve、RAS Mapper 中的 Observed WS。

    实测高水位与模拟对比官方截图
    实测高水位位置
    沿程高水位痕迹是空间校核的硬约束。来源:HEC 官方 Steady Flow 教程
  2. 分区调整曼宁 n(主槽 / 左右滩)

    在几何数据 Tables | Manning's n 按断面分区调整:

    • 主槽 n:控制低水–中水。
    • 滩地 n:控制高水;对输沙与高水位都极敏感,取值要与植被/阻力一致。

    可用 Flow Roughness Factors(随流量变化的糙率系数)表达"低水糙、高水相对光"等现象。

    Manning's n 编辑表官方截图
    曼宁 n 编辑表
    分区 n 表:主槽与滩地分开率定。来源:HEC-RAS User's Manual
    糙率随水位/流量变化示意官方截图
    糙率与水位关系
    河床形态与阻力随流量变化,可用 Flow Roughness Factors 描述。来源:HEC-RAS User's Manual
  3. 对照检查河床形态与河相关系

    n 不是唯一自由参数:深潭–浅滩、床面形态(沙波等)都影响阻力。官方用河床形态图说明"同一河流不同流量下阻力并非常数"。

    冲积河流床面形态转换官方截图
    床面形态
    床面形态随流量转换,糙率随之变化。来源:HEC-RAS User's Manual
阶段 C · 非恒定流:过程线四要素
  1. 运行率定事件并叠绘观测

    官方步骤 2:跑完整涨落事件。在 Stage/Flow Hydrograph Plot 叠绘实测与计算:

    • 水位过程线 · 流量过程线 · 洪峰与峰现时间 · 水量
    计算与实测高水位对比官方截图
    高水位对比
    沿程对比一目了然:偏高/偏低集中在哪一段。来源:HEC-RAS User's Manual
  2. 先调蓄量与侧向交换,修流量过程线

    官方步骤 3:在改 n 之前,先使流量过程线在时间、峰、量、形态上接近:

    • 断面 Ineffective / 存蓄:影响槽蓄与坦化。
    • Lateral Structure / 侧向入流:影响分流与汇入时间。
    • 区间入流是否重复计或漏计。
  3. 再调曼宁 n,修水位过程线

    官方步骤 4:流量大体正确后,用 n 对齐水位:

    • 整体偏高/偏低:先查基面与断面,再大范围微调 n。
    • 仅某河段偏差:局部河段 n 或断面间距/几何。
    • 峰现时间差:优先查槽蓄与传播,而不是死磕 n。
  4. 低水到高水分段细调

    官方步骤 5:用 Discharge–Roughness(Flow Roughness Factors)等做分流量级细调;每次只改一类参数,保存对比 Plan。

    结构物参数(堰流系数、收缩膨胀)单独一轮,避免与 n 双计。

阶段 D · 敏感性分析
  1. 列出敏感参数清单

    官方《Model Sensitivity》建议围绕:

    • 曼宁 n(主槽/滩地)· 时间步长 · 初始条件 · 边界过程线缩放 · 断面间距/蓄量 · 结构系数
  2. 单因素扰动方案树

    以 Cal-Base 为根,每次只动一个参数 ± 合理幅度(如 n ±20%、时间步 ×2 / ÷2),另存 Plan 批量跑:

    • Cal-Base / Cal-nHigh / Cal-nLow / Cal-DtSmall …

    对比输出:洪峰、峰现时间、最高水位、淹没面积的变幅。

  3. 整理敏感性表与结论

    形成两列结论:

    • 敏感:必须重点率定与论证的参数。
    • 不敏感:可保持文献/默认值,节省工作量。

    报告中给出"率定残差 + 参数合理区间 + 验证事件表现"。

阶段 E · 工具、自动率定与常见误区
  1. 使用 HEC-RAS 率定辅助工具

    • Observed Data 叠绘与残差。
    • Profile Plot 沿程高水位对比。
    • 输出变量表(水位、流量、体积)导出做统计。
    • 高级特性:Automated Calibration of Manning's n(按河段率定 Flow–Roughness Factors;须先有合理基准 n)。
  2. 常见误区

    • 只调 n、不查断面与基面。
    • 用同一场洪水率定又验证,无独立验证场次。
    • 为凑峰现时间把 n 调到物理不合理。
    • 忽略观测误差(尤其流量)。
    • 一次改多个参数,无法归因。
    官方提醒:率定要与物理意义一致。n 应落在对应河相/地物的合理范围;调整顺序上,几何与边界问题优先于糙率。
  3. 输出率定与敏感性报告要点

    • 资料来源与质量说明
    • 率定事件、指标与残差表/图
    • 参数终值与取值范围(含依据)
    • 验证事件表现
    • 敏感性排序与建议监测/补测项

官方手册入口:User's Manual(Ch.7 Calibration / Sensitivity · Ch.14 Automated Calibration)· Hydraulic Reference Manual

返回教程目录
Advanced Topics

进阶专题

面向建模进阶的专题模块:泥沙输移与水质模拟,更多专题持续扩充中。

01 · Tutorial · Sediment Transport

官方教程进阶:泥沙输移与动床模拟

本节照 HEC 官方泥沙文档的界面路径一步步做:先有一套能算稳的水动力模型,再打开 Sediment Data 定义级配与床层、选输沙公式、设准非恒定流与温度,最后跑动床并读冲淤结果。案例思路对齐官方 1D Sediment Modeling Tutorial 与 2D 泥沙经验页。

本教程能回答的问题:河床会冲深还是淤高?粗颗粒会不会在床面富集(粗化)?水库会淤多少?——先把水动力跑稳,再打开动床,按下面各阶段逐步填数据。
官方示例数据:Data / Solution Files(1D Sediment Tutorial).zip官方 1D 泥沙教程页提供完整数据包与解法包,可对照本节步骤跟做。
打开官方教程页
阶段 A · 水动力模型准备
  1. 确认水动力模型可用

    打开已有工程(或先按「官方教程一」建好 Merced 一类 1D 模型),运行恒定流或非恒定流,确认水面线、流速合理、无大量 negative depth / 无法收敛。

    在 RAS Mapper 或 Profile Plot 里看一眼水面是否贴合地形;滩地曼宁 n 先不要盲目调大(泥沙对 n 极敏感,见阶段 E)。

    为什么先跑水动力?输沙能力对剪力、能坡非常敏感。水面线不对,后面冲淤只会错得更远。官方 2D 泥沙页也强调:先 warmup 湿润并稳定水面,再加泥沙。
  2. 打开 Sediment Data 编辑器

    在主界面选择 Edit | Sediment Data…(或几何编辑器中的泥沙数据入口),新建/打开泥沙数据文件,按项目命名保存(如 Sediment)。

    先浏览左侧树上的 Grain Classes(粒径分组)、Bed(床层)、Options 菜单位置——后面几步都在这里填。

    Sediment Data Editor 总界面官方截图
    Sediment Data Editor 总界面
    进入后先认界面:粒径分组、床层与 Options 菜单都在这个编辑器里。 来源:HEC 官方文档
  3. 认识准非恒定流时间步

    官方将准非恒定流拆成三层,后面在 Quasi-Unsteady Flow 编辑器里会分别填:

    • Duration 流量档时长:该档内流量近似不变(日流量常取 24 h)。
    • Computational Increment 计算增量:水力+泥沙主时间步,必须 ≤ Duration;床面变化剧烈时不要设太大。
    • Bed Mixing Time Step:增量内再细分,只做级配记账(分选/粗化)。
    怎么填:日尺度多年演变:Duration=24 h,Computational Increment 先取 1–6 h 做敏感性;Bed Mixing 用默认即可。洪水过程冲淤:改用 Fully Unsteady。
阶段 B · 定义粒径分组与初始床沙
  1. 添加粒径分组(Grain Classes)

    在 Sediment Data 中选择 Grain Classes,点 Add 新增分组。河床质取样常拆成 3–6 组,例如:

    0.1 mm(细砂)· 0.5 mm(中砂)· 2 mm(砾)· 8 mm(卵石)

    为每组填写代表粒径;若做分选/粗化,组数不要只设一组全沙。

    定义粒径分组(Grain Classes)官方截图
    粒径分组定义界面
    点 Add 新增分组,填写代表粒径;建议 3–6 组以覆盖砂–卵石。 来源:HEC 官方文档
  2. 设置粒径组百分比

    在级配表中填写各组 百分比,合计 100%。上游来沙与床面级配尽量都按同一套分组给出。

    取样优先:用河床质筛分曲线落到这几组上。没有实测时,可从相邻河段资料或经验级配起步,但率定时必须回头核对。
    粒径组属性与百分比官方截图
    粒径组属性与重量百分比
    各组百分比合计 100%;与河床质筛分曲线对应。 来源:HEC 官方文档
  3. 初始化床层

    选择 Bed / 初始床沙组成,把表层(active/surface layer)配成与河床质一致的级配;需要模拟粗化时再配置下层基质。

    设置初始床面高程来源:通常直接用几何断面河床点;固定床诊断(Capacity Only)也要填级配,用来按粒径拆分输沙能力。

阶段 C · 输沙公式与床层参数
  1. 选择输沙公式(Transport Methods)

    选择 Options | Transport Methods…。按河床组成选起点公式:

    Transport Methods 对话框官方截图
    输沙方法选择对话框
    在 Options → Transport Methods 中选主公式并检查适用粒径。 来源:HEC 官方文档
    • Engelund-Hansen — 沙质、全沙,常用起点。
    • Meyer-Peter Müller — 卵石/砾石推移质。
    • Yang — 流功率型,沙–砾石适用面较宽。
    • Parker — 卵石河床,常与隐藏暴露一起用。

    不确定时:沙河先 EH,砾石河先 MPM 或 Parker;后面用实测冲淤/输沙率对比再定主公式。

  2. 配置 Bed Mixing 参数

    选择 Options | Bed Mixing Options…:

    勾选 Hiding and Exposure,方法优先 Wu,系数用默认值起步(细颗粒更易被"藏",总输沙会下降、模型更稳)。

    设置 Active Layer 厚度:沙床不要用"1×d90"默认过薄值,加一个最小厚度(约 0.1–0.3 m)或放大 d90 倍数,否则容易振荡。

    Bed Mixing Options(隐藏暴露与活动层)官方截图
    Bed Mixing Options 对话框
    勾选 Hiding and Exposure(Wu 起步),并检查 Active Layer 厚度(沙床加最小厚度)。 来源:HEC 官方 2D Sediment Parameters 文档
  3. 设置 2D Options(可选)

    2D 动床必须使用完整 Shallow Water Equations(SWE),不能用扩散波。在 Plan 的 Unsteady Flow Analysis → Options → Computation Options and Tolerances → 2D Flow Options 里把 Equation Set 设为 SWE。

    2D 泥沙相关选项(示例)官方截图
    2D 泥沙选项对话框
    Equation Set 必须为 SWE;暖机步在 2D Flow Options 中设置。 来源:HEC 官方文档

    再回到 Sediment Data → Options → 2D Computational Options:求解器可用 FGMRES-SOR 试算,终算再换 PARADISO;紊动选 Conservative 默认。

    必做 Warmup:在 2D Flow Options → Number of Warmup Time Steps 填入暖机步数(可为 0=用模拟步长),让网格先湿润、水面平衡,再开始计泥沙。
阶段 D · 准非恒定流与边界
  1. 创建准非恒定流数据

    打开 Quasi-Unsteady Flow Editor(非恒定流数据中的准非恒定流类型)。按日或更细分辨率输入流量序列,形成一系列流量档(Duration)。

    在编辑器中设置 Computational Increment(≤ Duration)与 Bed Mixing 相关步长;保存为独立的准非恒定流水流文件。

    Quasi-Unsteady / 混合流相关编辑器(示意)官方截图
    准非恒定流相关编辑器
    在此组织流量档与计算增量;温度在下一步单独设置。 来源:HEC 官方文档

  2. 输入温度时间序列

    在 Quasi-Unsteady Flow 编辑器底部点击 Set Temperature…,打开温度序列编辑器,填写水温(°C 或 °F,与工程单位一致)。

    没有长系列时按官方三种做法选一:

    • 常数温度:Duration 填很长(如 240000 h),粗颗粒体系可先这么做并做敏感性。
    • 年高低温插值:只填每年最高/最低温度,其余留空,点 Interpolate Missing Values。
    • 月平均:每月填一个平均温度,Duration=730.48 h,再复制多年。
    准非恒定流温度序列编辑器官方截图
    准非恒定流温度序列编辑器
    沉速与部分输沙公式依赖粘度→水温,细颗粒体系更敏感。来源:HEC 官方 Quasi-Unsteady Temperature 文档
    温度序列编辑器对话框官方截图
    温度序列编辑器对话框
    不规则时间序列:常数长历时 / 高低温插值 / 月平均重复。来源:HEC 官方文档
  3. 设置上游来沙边界

    在泥沙/准非恒定流边界条件中,给上游断面设置来沙:

    • 给定输沙率过程线:有实测或推求的输沙率时用这个。
    • 平衡来沙(Equilibrium / Capacity-based):按边界水力与床沙自动取输沙能力,需保证上游"虚拟断面"级配合理。

    全非恒定流:温度在 Unsteady Flow Editor → Options | Water Temperature (for Unsteady Sediment) 中设置;不设则按 55 °F。

    泥沙边界条件设置(示意)官方截图
    泥沙边界条件
    上游选给定输沙率或平衡来沙;边界位置要落在主槽过水处。 来源:HEC 官方文档

  4. 在方案中设置泥沙计算选项

    打开 Unsteady Flow Analysis(Plan):几何选含泥沙的几何,水流选准非恒定流文件。

    选择 Options | Sediment Computation Options and Tolerances…:设泥沙时间相关倍增器(先 <10,并做敏感性)、层厚(初始可取 1–2 m 量级更稳)。

    Plan 保存为有意义的名字,如 Sed-Base。

    Sediment Computation Options(示意)官方截图
    泥沙计算选项
    倍增器先 <10 做敏感性;层厚可取 1–2 m 量级更稳。 来源:HEC 官方文档

阶段 E · 运行与结果分析
  1. 运行泥沙计算

    在 Plan 窗口点击 Compute(或 Run 中的 Sediment / Unsteady 计算)。长系列可先缩短时段试跑,确认不崩溃再跑全序列。

    若中途崩溃:先减小 Computational Increment,检查温度序列是否缺口,再看边界是否猛冲猛淤。

  2. 查看河床高程与冲淤量

    打开结果中的 Bed Change / Bed Elevation 图层或断面时间序列,对照:

    • 沿程冲刷/淤积位置是否符合直觉(弯道、束窄、回水段)。
    • 分粒径输沙率与表层级配是否出现明显粗化。
  3. 排查边界冲淤问题

    若模型上、下边界附近出现夸张冲深或淤积,按官方《Common Errors in 2D Sediment Models》顺序排查:

    • 来沙能力与来沙量/级配是否匹配(边界"饿"或"撑")。
    • 平衡来沙边界是否放在反映主槽过水的位置(不要铺满整个数值河槽)。
    • 上游能坡是否过陡形成射流 → 勾选 Tail Water check,让尾水修正边界坡降。
    边界处剧烈冲淤示例官方截图
    模型边界剧烈冲淤
    边界虚假冲刷会连带回淤,看起来像"上游淤了一大片"。来源:HEC 官方 Common Errors in 2D Sediment Models
  4. 复核滩地曼宁 n 值

    水力对滩地 n 不敏感,但输沙对应力极敏感:综合起来输沙可近似随 n 的三次方增长。滩地 n 从 0.06 调到 0.12,水位几乎不动,输沙却可能差一个数量级。

    回到几何数据 Tables | Manning's n,把滩地 n 按植被/阻力重新估计,而不是按"水位不好看"去加糙。

    Manning n 表(横向变化)官方截图
    曼宁 n 值表
    滩地 n 对输沙极其敏感,需按植被/阻力估计。图示为 1D 教程中的 Manning's n 表界面。来源:HEC 官方《Steady Flow Modeling with HEC-RAS》
  5. 固定床诊断(Capacity Only)(可选)

    要评估"加构筑物后能力是否变大"时,可用固定床简化:

    在 Sediment Data 中把 Simulation Components 设为 Capacity Only(或 Concentration Only),另存泥沙数据与 Plan,运行后在 Mapper 中展开 Sediment Transport → Total-load Transport Capacity 图层对比方案。

    Capacity Only 模式设置官方截图
    Capacity Only 计算模式
    固定床 Capacity Only:只算输沙能力场,仍需级配数据。来源:HEC 官方 Fixed-bed 2D Sediment 文档
    Capacity Only 输沙能力结果官方截图
    输沙能力结果图
    用颜色看能力高低,对比工程前后。来源:HEC 官方 Fixed-bed 2D Sediment 文档
阶段 F · 二维泥沙检查清单
  1. 按优先级核对二维泥沙参数

    官方建议顺序(详见 2D Sediment Transport 文档):

    • Tier 0:SWE 方程 + 水力 warmup。
    • Tier 1:Hiding(Wu)· Adaptation Length≈1–2×平均网格尺寸 · 求解器 · 紊动 Conservative · 沙床活动层厚度。
    • Tier 2:泥沙计算倍增器(<10)· 底坡系数 0.1–0.5 · 层厚。
    • Tier 3:Subgrid 等,模型稳定后再开。
  2. 进阶:岸坡稳定性与泥石流

    岸坡:用 BSTEM(趾部冲刷 + 崩塌)基于动床结果评估;方案快速对比可用 SIAM。

    高含沙/泥石流:改用非牛顿流体库(屈服应力、塑性粘度;泥石流再加摩擦),沿沟加密网格,上游给流量+浓度过程线,看堆积范围与厚度。

官方入口:1D Sediment Transport · 2D Sediment Transport · Mud and Debris Flow

02 · Tutorial · Water Quality & Temperature

官方教程进阶:水温与水质组分模拟

本节照 HEC 水质/水温模块的操作顺序一步步做:先有水流场和气象强迫,再在 Water Quality 菜单里建组分集、从库里勾选组分、填边界浓度与反应速率,最后率定水温与 DO/氮磷。方法对齐官方 WTSM / NSM / GCSM 文档。

本教程能回答的问题:夏季水温会不会太高?DO 会不会掉?氨氮/磷是降解还是累积?——先按阶段 A–D 填数据,再用观测率定。
阶段 A · 水动力与气象数据
  1. 确认水动力模型可用

    运行一维/二维水动力,检查流量分配、回水与滞水区。水质组分只在已算好的流场上做输运与反应,流场不对则浓度场无意义。

  2. 准备气象数据

    整理逐时(推荐)气象序列,至少包括:

    • 短波太阳辐射 · 气压 · 气温 · 湿度 · 风速 · 云量

    风速要能换算到水面以上 2 m 高度。气温和辐射日变化大,月平均通常不够。

    热平衡在算什么?表层净热通量 \(q_{net}=\beta q_{sw}+q_{atm}-q_b-q_h-q_l-q_{sed}\),再通过水体热容改水温。植被河岸可加遮荫/挡风/保温系数。
    多层水柱热交换源汇示意官方截图
    多层水柱热交换源汇示意图
    本图解释「气象强迫如何进入热平衡」——与本步准备的辐射/气温/风速数据一一对应。短波、长波、潜热、感热与沉积物–水体热交换。来源:HEC 官方 Water Temperature Simulation Module
  3. 打开 Water Quality 数据

    在主界面选择 Edit | Water Quality Data…(或 Plan/边界数据中的 Water Quality 入口),新建水质数据文件并保存。

    你将用到三套组分库:Temperature(水温/泥沙温度)、NSM(营养盐–藻类–DO–CBOD)、GCSM(一般组分:示踪、微生物等)。

阶段 B · 创建水质组分集
  1. 新建 WQ Constituent Set

    打开 WQ Constituent Set Editor,选择 File / 菜单 → Create New WQ Constituent Set,命名(如 WQ_Base)。

    可建多套组分集做情景对比;切换前点 Apply 保存,避免丢参考值。

    WQ Constituent Set Editor 示例官方截图
    水质组分集编辑器
    组分集编辑器:列表里是已启用组分与参考值。来源:HEC 官方 WQ Constituent Set Editor 文档
  2. 从库中选择组分

    点 Edit Set 打开 WQ Constituent Selector。在 Library 下拉中选择库,勾选需要的组分后点 Apply:

    • Temperature:勾 Water Temperature(需要时再加 Sediment Temperature)。
    • NSM:按目标勾 Dissolved Oxygen、Ammonium、Nitrate、Inorganic Phosphorous、Phytoplankton 等。
    • GCSM:保守示踪、大肠杆菌、一般颗粒等,可多套、各带独立速率。

    点 Clear Selections 可清空当前库的勾选;完成后点 OK 回到编辑器。

    WQ Constituent Selector · Temperature 库官方截图
    组分选择器温度库
    Temperature 库:Water Temperature / Sediment Temperature。来源:HEC 官方 WQ Constituent Selector
    WQ Constituent Selector · NSM1 库官方截图
    组分选择器 NSM1 库
    NSM 营养盐库常见组分:DO、NH₄、NO₃、无机磷、浮游植物。来源:HEC 官方 WQ Constituent Selector
  3. 输入参考值与初始浓度

    回到 WQ Constituent Set Editor 表格,为各组分填写 Reference / 初始浓度(mg/L 或文档规定单位)。GCSM 组分还要填速率参数(见阶段 C)。

阶段 C · 边界浓度与反应速率
  1. 设置边界浓度

    在边界条件编辑器中,为各组分指定 浓度过程线(与流量过程线同步)。点源排口用旁侧入流,在排口附近保证网格/断面分辨率足够。

    先用 保守示踪(GCSM 近保守)跑一遍,看输运时间尺度是否合理,再上反应组分。

    边界组分数据源选项官方截图
    Boundary Constituent Set Editor 数据源
    浓度过程线可来自常数、DSS 或环境值;与流量过程线时间对齐。 来源:HEC 官方文档

  2. 输入反应速率与温度系数

    按 20 °C 率定值填写 \(k(20)\) 与温度系数 \(\theta\)(常见 1.01–1.10),运行时自动换算 \(k(T_w)=k(20)\,\theta^{T_w-20}\)。

    GCSM 一般组分典型源汇:零级/一级衰减、沉降 \(v_s\)、底泥释放 \(k_{sed}\)。NSM 则涉及藻类生长/呼吸、CBOD 耗氧、硝化、复氧等——优先用文献或本站监测约束,不要全靠默认值。

    和泥沙一起算时:悬沙影响光消光→水温与藻类;温度序列与时间步要与泥沙分析保持同一套,避免两套强迫。
  3. 设置植被修正系数(可选)

    若河道有浓密岸林,可在水温模块中设 遮荫系数、挡风系数、长波保温系数(0=无植被影响,1=完全遮蔽/挡风)。可按季节变化。

阶段 D · 运行与率定
  1. 创建方案并计算

    在 Unsteady Flow Analysis 中选择对应几何/水流,指定 WQ Constituent Set,保存 Plan(如 WQ-Base)后点 Compute。

    先跑短时段确认稳定,再跑率定期。

  2. 查看水温与水质结果

    在结果绘图中依次检查:

    • 水温沿程/逐日:是否贴近观测(日最低/最高)。
    • DO:是否出现不合理耗氧谷;与水温、CBOD 对照。
    • NH₄ / NO₃ / PO₄:点源下游是否按预期衰减或累积。
  3. 模型率定

    官方与工程实践的稳妥顺序:

    ① 输运(保守示踪/流场)→ ② 水温(辐射与蒸发强迫)→ ③ DO(复氧与耗氧)→ ④ 营养盐与藻类。

    一次只动一类参数;每改一组速率就保存新的 Plan/组分集,方便回退对比。

官方入口:User's Manual · Documentation Home · Guides & Tutorials

返回教程目录
References

学习参考

理论基础、常见问题排查与官方学习资源——查理论、查报错、找官方入口,随查随用。

01 · Theory

必须知道的理论基础

理解 HEC-RAS 的计算原理,才能正确地布置模型、解释结果、判断异常。以下为官方 Hydraulic Reference Manual 的核心内容摘编。

主题 01 · 水力学基础:三大方程体系

HEC-RAS 的一维水动力计算基于水力学三大方程:连续性方程(质量守恒)、能量方程(伯努利方程的工程扩展)与动量方程(牛顿第二定律)。三者适用于不同场景——渐变流用能量方程,急变流(水跃、桥梁、汇流节点)用动量方程,连续性方程则贯穿始终。

$$Q = A_1 V_1 = A_2 V_2 \qquad F = \rho Q\,(V_2 - V_1)$$
左:恒定流连续性方程,Q 为流量,A 为过水断面面积,V 为断面平均流速;右:动量方程,F 为水流对结构物/控制体的合力,ρ 为水的密度。HEC-RAS 在能量方程不适用处自动切换动量方程。
主题 02 · 恒定流:能量方程(标准步进法)

恒定渐变流的基本计算基于一维能量方程:断面 2 的总水头等于断面 1 的总水头减去两断面间的能量损失:

$$Z_2 + Y_2 + \frac{\alpha_2 V_2^2}{2g} = Z_1 + Y_1 + \frac{\alpha_1 V_1^2}{2g} + h_e$$
其中 Z 为渠底高程,Y 为水深,α 为流速分布系数(动能修正系数),V 为断面平均流速,g 为重力加速度,he 为断面间能量损失。

能量损失由两部分组成:摩阻损失 hf(用曼宁公式计算)与收缩/扩张损失 hc(等于流速水头变化乘以收缩/扩张系数 C):

$$h_e = h_f + h_c, \qquad h_c = C\left|\frac{\alpha_2 V_2^2}{2g} - \frac{\alpha_1 V_1^2}{2g}\right|$$
hf = 两断面间加权平均摩阻坡度 × 断面间距;收缩(converging)与扩张(expanding)系数 C 的取值(如收缩 0.1、扩张 0.3)可在几何数据中设置。

在急变流场景——混合流态(水跃)、桥梁水力、汇流节点——能量方程不适用,改用动量方程求解。

主题 03 · 曼宁公式与糙率选择
$$V = \frac{1}{n} R^{2/3} S_f^{1/2} \quad \text{(SI 单位)}\qquad V = \frac{1.49}{n} R^{2/3} S_f^{1/2} \quad \text{(US 单位)}$$
n 为曼宁糙率系数,R 为水力半径,Sf 为摩阻坡度。HEC-RAS 用它计算断面各子断面(主槽/左右滩地)的流量分配与摩阻损失。

n 值是模型中最敏感的参数之一,参考范围(数值见官方《Hydraulic Reference Manual》):

常见曼宁糙率 n 参考范围
表面类型n 值范围说明
人工顺直渠道(混凝土)0.012 – 0.017光滑、规则,变化小
人工渠道(土质/砌石)0.020 – 0.035视植被与糙度而定
天然河道(清洁)0.030 – 0.050一般山区/平原河流主槽
天然河道(弯曲/多石/杂草)0.050 – 0.080深潭、倒树、大块石
洪泛区(草地/农田)0.035 – 0.070滩地低植被
洪泛区(灌木/树林)0.080 – 0.150高植被阻水显著
主题 04 · 流态判断:弗劳德数与比能

弗劳德数(Froude number)是判断明渠流态的核心无量纲数:Fr < 1 为亚临界(缓流),扰动向上游传播、水流受下游控制;Fr = 1 为临界流;Fr > 1 为超临界(急流),水流受上游控制。HEC-RAS 恒定流计算据此自动选择计算方向。

$$Fr = \frac{V}{\sqrt{g\,y}} \qquad y_c = \sqrt[3]{\frac{q^2}{g}} \qquad E = y + \frac{Q^2}{2g A^2}$$
左:弗劳德数(y 为水深,矩形断面取平均水深);中:矩形断面临界水深 yc(q = Q/b 为单宽流量);右:比能 E = 水深 + 流速水头。临界流时比能最小,水面线计算中的"临界深度控制"即基于此。
主题 05 · 水面线分类(M / S / C / H / A 型)

明渠渐变流水面线按床坡类型(缓坡 M、陡坡 S、临界坡 C、水平 H、逆坡 A)与水深相对正常水深 yn、临界水深 yc 的区域组合分类,共 12 类(如 M1/M2/M3、S1/S2/S3 等)。判断水面线类型可帮助验证计算结果是否物理合理:

常见水面线类型与特征
类型特征与工程含义
M1(回水曲线)缓坡上 y>yn>yc,上游受下游堰坝、水库、干流顶托形成的壅水曲线,向上游渐进趋于正常水深
M2(降水曲线)缓坡上 yn>y>yc,下游跌落(如陡坎、入汇大河),水面线向下游降低
M3(水跃前段)缓坡上 y<yc<yn,急流进入缓流段时先跌后跃
S2陡坡上 yc>y>yn,急流降水曲线
S3陡坡上 y<yn<yc,水跃下游的急流段
H2 / A2 / A3水平坡/逆坡上的降水与壅水曲线,常见于坝下消能段与逆向坡度河段
主题 06 · 动量方程的应用:水跃与桥梁

能量方程假定能量守恒(含损失项),在急变流区域不成立——水跃、桥梁/涵洞上下游、闸堰、汇流节点等场景 HEC-RAS 使用动量方程。水跃的共轭水深关系是判断跃前跃后水位的经典公式:

$$\frac{y_2}{y_1} = \frac{1}{2}\left(\sqrt{1 + 8\,Fr_1^2} - 1\right)$$
y1、Fr1 为跃前水深与弗劳德数,y2 为跃后共轭水深。当 Fr1 > 1 且下游水深介于 y1 与 y2 之间时发生水跃。
主题 07 · 非恒定流:一维圣维南方程组

1D 非恒定流求解器(改编自 UNET)数值求解一维圣维南方程组。连续方程:

$$\frac{\partial A}{\partial t} + \frac{\partial Q}{\partial x} = q_l$$
A 为过水面积,Q 为流量,ql 为单位长度侧向入流。

动量方程:

$$\frac{\partial Q}{\partial t} + \frac{\partial (Q V)}{\partial x} + gA\left(\frac{\partial z}{\partial x} + S_f\right) = 0$$
z 为水面高程,Sf 为摩阻坡度。方程组由程序按有限差分格式离散求解,因此对时间步长与断面布置有稳定性要求。
主题 08 · 数值格式:Preissmann 四点隐式与 Theta 权重

HEC-RAS 一维非恒定流求解器在时空网格上采用Preissmann 四点隐式格式离散圣维南方程组:每个计算时段内,未知量同时以当前时刻与下一时刻的加权平均参与求解,从而允许较大的时间步长而不失稳。时间权重 θ 决定格式性质:

$$\frac{f^{n+1}_i - f^n_i}{\Delta t} = \theta\left(\frac{\partial f}{\partial t}\right)^{n+1} + (1-\theta)\left(\frac{\partial f}{\partial t}\right)^{n}$$
θ = 1.0 为全隐式(无条件稳定、数值耗散较大);θ = 0.5 为 Crank-Nicolson(精度最高但易振荡);HEC-RAS 默认 0.6,为稳定与精度折中。官方稳定性调试时可调整该权重。
主题 09 · 数值稳定性:Courant 条件与时间步

显式数值格式要求信息传播在一个时间步内不越过一个空间步长,即 Courant 条件;隐式格式理论上无条件稳定,但为控制数值耗散与振荡,仍建议满足 Courant 数接近 1:

$$C_n = \frac{V\,\Delta t}{\Delta x} \le 1 \qquad c = \sqrt{\frac{gA}{B}} \approx \sqrt{g\,y}$$
Cn 为 Courant 数(V 流速、Δt 时间步、Δx 空间步);右式为长波波速 c(B 为水面宽度)。经验上 1D 洪水波时间步取 1–5 分钟、2D 单元更小需更短步长;断面/单元越密、流速越快,时间步越要减小。
主题 10 · 二维浅水方程

2D 求解器在非结构化网格上求解二维浅水方程(连续性 + x/y 方向动量,含底坡、摩阻、涡粘、风应力等项),扩散波求解器则忽略对流加速度项以换取更好的稳定性与更大时间步。连续性方程:

$$\frac{\partial H}{\partial t} + \frac{\partial (h u)}{\partial x} + \frac{\partial (h v)}{\partial y} = 0$$
H 为水面高程,h 为水深,u、v 为 x、y 方向流速。

x 方向动量方程(示意,完整含风应力与科氏力项):

$$\frac{\partial u}{\partial t} + u\frac{\partial u}{\partial x} + v\frac{\partial u}{\partial y} = -g\frac{\partial H}{\partial x} + \nu_t\left(\frac{\partial^2 u}{\partial x^2} + \frac{\partial^2 u}{\partial y^2}\right) - g S_{fx}$$
νt 为涡粘系数(湍流扩散项),Sfx 为 x 方向摩阻坡度(曼宁公式给出)。完整公式(含风应力、科氏力)见官方《Hydraulic Reference Manual》与《2D User's Manual》。
主题 11 · 扩散波近似与有限体积

扩散波忽略圣维南方程组中的惯性项(对流加速度与当地加速度),保留压力项与摩阻项,稳定、可大步长,是 HEC-RAS 2D 默认求解器(SWE-EM)的理论基础,适合大多数漫滩与城市洪涝:

$$\frac{\partial h}{\partial t} = \frac{\partial}{\partial x}\left(D \frac{\partial h}{\partial x}\right), \qquad D \approx \frac{h^{5/3}}{n^2\,|\partial H / \partial x|}$$
D 为扩散系数(示意形式),h 为水深,n 为曼宁糙率。忽略惯性项后方程退化为抛物型,数值上更稳定。

2D 求解器采用有限体积法:在每一个网格单元(cell)上积分守恒形式的方程,通过单元面(face)计算相邻单元间的流量通量——这正是实战章节中"单元中心 / 单元面 / 面端点"三个概念的数值理论来源;单元面必须沿堤防等线性阻水物对齐,否则通量会"泄漏"。

主题 12 · 泥沙输移基础:Exner 方程与输沙率

动床模拟把河床变形与水流输沙耦合起来:河床高程变化由输沙量沿程梯度决定(Exner 方程),而输沙率由水动力条件(剪应力)与床沙粒径决定。HEC-RAS 泥沙模块支持多种输沙率公式(Meyer-Peter Müller 推移质、Engelund-Hansen 全沙、Toffaleti 等),按粒径分级计算。

$$\frac{\partial z_b}{\partial t} = -\frac{1}{1-\lambda_p}\frac{\partial q_b}{\partial x} \qquad \tau_* = \frac{\tau_0}{(\rho_s - \rho)\,g\,d}$$
左:Exner 方程,zb 为河床高程,λp 为床沙孔隙率,qb 为单位宽度输沙率——输沙量沿程增加(∂qb/∂x > 0)则冲刷(河床降低);右:Shields 无量纲剪应力(希尔兹数),τ0 为床面剪应力,ρs 为泥沙密度,d 为粒径——用于判断起动条件。
主题 13 · 水质模拟基础:对流扩散方程

水质组分(温度、溶解氧、藻类、营养盐、CBOD 等)在水体中的迁移由对流与扩散/弥散控制,并叠加反应源汇项。HEC-RAS 一维水质输运采用 QUICKEST-ULTIMATE 格式求解:

$$\frac{\partial C}{\partial t} + u\frac{\partial C}{\partial x} = D_x \frac{\partial^2 C}{\partial x^2} + \sum S$$
C 为组分浓度,u 为流速,Dx 为纵向弥散系数,ΣS 为源汇项(复氧、耗氧、光合/呼吸、水温热交换等)。水温还叠加完整热平衡方程(太阳短波辐射、大气长波、蒸发、对流等)。
02 · Troubleshooting

常见问题与经验技巧

官方手册专设《Troubleshooting With HEC-RAS》章节;以下为教程与工程实践中最高频的问题清单。

Q1模型计算不稳定/发散(振荡、NaN)怎么办?

非恒定流:① 减小计算时间步长(先试 1–5 分钟);② 增加预热期,以低基流启动;③ 检查几何是否有突变断面、负河段长度、重叠断面;④ 过程线过陡时开启 Critical Boundary Condition 或对过程线做平滑;⑤ 使用 Min Flow 保证最低流量;⑥ 检查初始条件是否与边界一致(先用恒定流初始化)。

恒定流:① 检查断面间距是否过大导致水面线剧烈变化;② 检查是否有"无效流动区"未被定义;③ 检查流态设置(亚临界/超临界/混合)是否与实际一致;④ 检查边界条件坡度是否合理。

Q2断面需要多少个?怎么布置?

没有固定数量,原则是:沿程地形与流态变化处加密。在桥梁、涵洞、堰上下游、汇流口、坡度突变处必须加密断面;尽量保证相邻断面间的过流能力过渡平缓,避免流量分配剧烈跳变。低流量断面用于确认主槽与岸滩,高流量断面用于确认洪泛区范围。

Q3Normal Depth 边界的坡度怎么取?

取边界断面附近的河道实际纵坡(床底坡度)。可用 RAS Mapper 的测量工具沿河段量取,或用地形数据计算。选错坡度会使边界附近水位明显偏高或偏低,因此下游断面一般要延伸到研究区下游足够远,让边界条件的影响衰减。

Q42D 网格单元取多大合适?

经验参考:单元尺寸取 DEM 分辨率的 2–5 倍;单元不能小于 DEM 分辨率(更小不会更准,只会更慢)。大面积平缓区用大单元,主槽、堤防、建筑物周边用 Refinement Regions 局部加密。单元数翻倍会带来约 4 倍的单元量与计算时间,因此优先局部加密。

Q5DEM 有 NoData 空洞怎么办?

建模前先用 GIS 工具填补水流路径上的 NoData(水体区域常见)。2D 网格生成与计算在 NoData 单元上会产生数值不稳定甚至报错。RAS Mapper 创建地形后应目视检查研究区是否有空洞。

Q6计算水位与实测水位差很多?

按官方教程的三板斧排查:几何是否准确(断面、建筑物、高地/堤防是否入模)、边界条件是否合理(坡度、水位/流量关系)、曼宁 n 值是否正确。多数情况下先做糙率敏感性分析,再结合实测高水位(Observed WS)逐步校准。

Q7计算时间步长怎么选?

官方指南:先设一个较短的模拟时间窗,运行后用计算日志评估一个时间步(比如观察解是否收敛、Courant 条件)。2D 扩散波求解器允许较大步长(数分钟),显式浅水求解器需要更小步长(秒级)。经验上从 1–5 分钟起步,按稳定性与精度要求调整。

Q81D 和 2D 怎么选?

河道单一、水流近似一维(如深窄河谷)时 1D 高效且足够;河道出槽漫滩、城区复杂下垫面、需要刻画二维流向(回流、绕流、漫滩路径)时用 2D 或 1D/2D 耦合——河道用 1D(效率),滩区/城区用 2D(精度)。官方提供了专门的《Creating an Combined 1D/2D Model》指南。

03 · Resources

官方学习资源

HEC 官网提供免费、完整且持续更新的文档、教程与培训材料——本文所有内容均可在以下资源中找到权威原文。

软件下载页免费下载安装包与 Release Notes,含 6.x、7.0.x 与 HEC-RAS 2025 Beta。hec.usace.army.mil/software/hec-ras/ 文档首页 Documentation Home用户手册、技术参考、应用指南、Release Notes 的总入口,软件内 Help 菜单也指向这里。hec.usace.army.mil/software/hec-ras/documentation.aspx Guides & Tutorials 指南与教程本教程的主要来源:1D 恒定流、1D/2D 非恒定流、泥沙、泥石流、管网等分步教程 + 示例数据集。hec.usace.army.mil/confluence/rasdocs/hgt/latest User's Manual 用户手册从安装、入门到各组件详解与排错,最完整的操作手册。confluence/rasdocs/rasum/latest Hydraulic Reference Manual 技术参考能量/动量方程、曼宁公式、圣维南方程组、数值方法的完整推导与参数选取指南。confluence/rasdocs/ras1dtechref/latest Training 培训视频官方讲座与网络研讨会的视频录像,以及培训班讲义材料。hec.usace.army.mil/software/hec-ras/training.aspx
给中文用户的建议:官方文档目前以英文为主。建议先用本教程建立操作框架,再回到官方原文核对术语与参数细节;将单位制(英制/公制)习惯与官方保持一致(如流量 cfs 或 m³/s),可减少大量单位换算错误。