示例 ​

HydroPilot 已经有几类比较典型的示例配置。这一页的作用，是帮你判断该从哪一类起步。

推荐起点 ​

• test_daily.yaml：最简单的 SWAT 2012 率定入口
• test_monthly.yaml：月尺度 SWAT 2012 工作流
• 如果你的工程本身就是 SWAT+，优先从 SWAT+ 模板和相关 guide 起步
• test_xaj.yaml：基于 CSV 的 XAJ 工作流
• test_daily_general.yaml：需要完整 version: general 配置时的起点

这些示例主要用于说明配置思路和验证运行链路。真正用于率定前，还是需要结合你的工程做调整。

我该从哪一类示例开始？ ​

可以直接按下面的情况判断：

按模型看起点 ​

SWAT 2012 ​

• 日尺度率定
• 月尺度率定
• 复杂多目标配置
• 时段切片和派生序列

这一组里最常见的入口是 test_daily.yaml 和 test_monthly.yaml。如果你后面要继续扩展敏感性分析、率定或多目标配置，可以再看 test_monthly_complex.yaml 与 test_monthly_series.yaml。

SWAT+ ​

• SWAT+ 模板支持
• 基于 calibration.cal 的参数写入
• 流量提取工作流

这组内容主要适合想先跑通 SWAT+ 模板、参数写入和输出提取链路的人。

更准确地说，SWAT+ 现在已经是一条明确支持的模型路径，也有配套 guide；只是相比 SWAT 2012，它目前更偏“按模型能力组织”，而不是“按现成示例文件堆起来”。

XAJ ​

• 基于 CSV 的参数写入
• 基于 CSV 的结果读取
• 基于 RIVID 的过滤

XAJ 这一组说明 HydroPilot 并不局限于类似 SWAT 的定宽文本工程，也能支持基于 CSV 的模型流程，而且这条线通常更适合直接扩展成完整业务案例。

General 模式示例 ​

如果你想直接看到完整的运行时 schema，应该先看 version: general 的示例。这些配置会把 reader、writer 和文件映射全部显式展开，适合需要完全控制底层行为的场景。

推荐阅读顺序 ​

如果你是第一次接触这部分内容，通常按下面的顺序最省事：

1. 先读对应模型的案例页
2. 再看本页中对应的示例家族
3. 用 hydropilot-validate 校验本地配置
4. 用 hydropilot-test 做一次冒烟测试
5. 只有在运行链路跑通之后，再转向 Python 接口或 UQPyL 集成

快速命令 ​

最常见的起步命令是：

hydropilot-validate path/to/config.yaml
hydropilot-test path/to/config.yaml

确认前面没问题之后，再进入：

hydropilot-run path/to/run.yaml

如果需要重复评估，再转向 SimModel 或 UQPyLAdapter。

如何更好地使用示例 ​

把示例迁移到真实工程前，通常至少要做下面这些调整：

1. 修改 basic.projectPath
2. 更新 basic.command
3. 替换观测文件
4. 重新检查参数范围
5. 对照真实工程确认时间步长、时段和输出结构

对应模型页面 ​

• SWAT 2012
• SWAT+
• XAJ