用 GPU 把全球 848 万段河道、15.6 万个流域渲染成一部 4K 动画:从中国出发,逐条点亮 37 条大河(河口 → 上游染色,附面积、长度、流量、人口等数据),再点亮全世界所有流域,最后巡游各大洲、在地图上浮现流域名字。
A GPU-rendered 4K animation of the world's river basins, built from HydroSHEDS / HydroRIVERS. Every line is a real river; every color is a drainage basin.
| 河流点亮(长江) | 带流域名的全图 |
|---|---|
![]() |
![]() |
- 数据驱动:河网与流域拓扑来自 WWF HydroSHEDS 的 HydroRIVERS,流域统计来自 RiverATLAS,流域中文名由 Natural Earth 自动匹配。
- GPU 实时渲染:moderngl(OpenGL 4.3)一次性载入 4800 万个顶点,着色器按时间决定每段河道的颜色,镜头可任意缩放平移;4K 60fps 全片约 10 分钟渲染完。
- 运镜:van Wijk 平滑缩放平移(远距离先拉远再推近)、Catmull-Rom 样条巡游。
- 钉在地图上的流域名:按流域在屏幕上的大小决定显示与否,互不重叠、平滑淡入淡出,名字出现时对应流域闪亮。
- 配置化:镜头路线、河流列表、节奏、文字、配色、背景音乐编排全部写在
scenes.yaml,不用改代码。
- Python 3.13,用 uv 管理依赖
- 支持 OpenGL 4.3 的显卡(Windows / Linux 的 NVIDIA、AMD、Intel 近年显卡均可)。macOS 最高只支持 OpenGL 4.1,暂不支持。
- NVIDIA 显卡会自动使用 NVENC 硬件编码,其它显卡使用 CPU(libx264)编码
- 中文字体:Windows 用微软雅黑,macOS / Linux 自动尝试苹方 / Noto Sans CJK,也可在
scenes.yaml里指定 - 磁盘约 4 GB(原始数据 + 预处理结果),内存 16 GB 左右
git clone https://github.com/Sfong-sudo/hydrorivers-vision.git
cd hydrorivers-vision
uv sync # 安装依赖
uv run python download.py # 下载 HydroRIVERS(约 520 MB)和 Natural Earth 河流数据
uv run python prep.py # 预处理:投影、排序、建上下游拓扑 → data/rivers.npz(约 1.5 分钟)
uv run python render.py --preview # 720p 预览视频 → out/preview.mp4
uv run python render.py # 4K 60fps 成片 → out/rivers_4k.mp4其它常用命令:
uv run python render.py --preview --still 20 60 -3 # 只渲染这些时刻的单帧(负数 = 从结尾倒数),调画面用
uv run python render.py --preview --start 80 --end 120 # 只渲染一段
uv run python render.py --cover # 无字的彩色全图(封面)
uv run python render.py --poster # 带流域名的彩色全图
uv run python names.py # 重新生成流域中文名表 data/basin_names.csv仓库已附带两份小缓存,开箱即用:
data/basin_names.csv:流域中文名(由names.py生成)data/atlas_outlets.csv:37 条特写河流的 RiverATLAS 统计(人口、降水、海拔)
如果要更换特写河流,需要 RiverATLAS 原始数据(2.4 GB,托管在 figshare,需用浏览器下载):https://figshare.com/ndownloader/files/20087321,把 zip 放进 data/ 即可,渲染时自动解压读取。
| 部分 | 作用 |
|---|---|
output |
预览 / 成片的分辨率、帧率、抗锯齿 |
style |
背景色、未点亮河流颜色、高光、线宽随缩放的变化、字体 |
timing |
开场、全球点亮、结尾巡游等各段时长 |
titles |
开场标题、片尾数据来源 |
tour |
依次点亮的河流:河口河段编号(HYRIV_ID)、颜色、简介、面板数字(面积 / 长度 / 流量) |
ending_tour |
结尾巡游的镜头点(经纬度 + 视野宽度) |
ending_labels |
结尾流域名的数量、字号、间距、出现速度 |
basin_names |
流域名的人工修正 |
audio |
背景音乐:分段拼接、交叉淡化、与画面对拍 |
背景音乐不随仓库提供(有版权)。把自己的音频放到 bgm/,在 audio.file 填路径即可;不填或文件不存在则输出无声视频。
download.py 下载 HydroRIVERS / Natural Earth
↓
prep.py 读取 848 万段河道 → Robinson 投影 → 按河流等级排序 → DFS 编号(快速求任意河口的全部上游)→ data/rivers.npz
names.py Natural Earth 河流线 → KD 树匹配到 HydroRIVERS 河段 → 流域中文名
↓
render.py 时间线(每段河道的点亮时刻、颜色、镜头路径、文字)→ GPU 逐帧渲染 → ffmpeg 编码 + 背景音乐
| 内容 | 数据 | 许可 |
|---|---|---|
| 河网与流域 | HydroRIVERS v1.0 — Lehner, B., Grill, G. (2013). Global river hydrography and network routing: baseline data and new approaches to study the world's large river systems. Hydrological Processes 27(15): 2171–2186. https://www.hydrosheds.org | HydroSHEDS 许可协议(可免费用于非商业及商业用途,需署名) |
| 流域人口 / 降水 / 海拔 | RiverATLAS v1.0 — Linke, S. et al. (2019). Global hydro-environmental sub-basin and river reach characteristics at high spatial resolution. Scientific Data 6: 283. 原始数据:GPW v4(CIESIN 2016)、WorldClim v1.4(Hijmans et al. 2005)、EarthEnv-DEM90(Robinson et al. 2014) | CC-BY 4.0 / ODbL 1.0 |
| 流域中文名 | Natural Earth 1:10m Rivers + lake centerlines https://www.naturalearthdata.com | 公有领域 |
| 面板中的河长 / 面积 / 流量 | 国家统计局《主要河流基本情况》;维基百科 | — |
数据口径与局限(流量为多年平均值、河长按最长源流计、投影非等面积等)见 docs/DATA_NOTES.md。
代码以 MIT 许可开源。使用本项目生成的图片 / 视频请按上表注明数据来源。


