whitebox-tools

项目地址： https://github.com/jblindsay/whitebox-tools

官方文档： 用户手册站 https://www.whiteboxgeo.com/manual/wbt_book/preface.html（2026-10 实测返回 404，暂以仓库 README 与 UserManual.txt 为可访问入口）

最新版本： 2.4.0（GitHub Release，截至 2026-10）

PyPI 前端： whitebox 2.3.6（whitebox-python 封装，仅负责下载与调用二进制，版本号落后于核心库）

许可证： MIT

注意： 上游仓库 README 已标记为 legacy，新开发转向 https://github.com/jblindsay/whitebox_next_gen；但 2.4.0 仍是当前稳定可用的开源版本，本文以其为基准。

概述

WhiteboxTools 是圭尔夫大学 GHRG 实验室（John Lindsay）用 Rust 编写的独立地理空间分析引擎，面向「分析后端」而非制图：它不渲染地图，只接收栅格/矢量/LAS 输入并产出分析结果。相比通用 GIS 桌面软件，它的优势在于命令行与脚本化，几百个工具都能通过统一参数形式批量执行，适合 DEM 地形分析、水文建模与 LiDAR 处理流水线。

• 地形分析：坡度、坡向、曲率、山体阴影、相对高程、地形位置指数（TPI）、多尺度位置分析
• 水文分析：洼地填充/决口、D8/DInf/FD8 流向与流量累积、河网提取、Strahler 分级、流域划分
• LiDAR：点云信息与直方图、按类别过滤、去噪、地面点分类、插值成 DEM、密度与强度栅格
• 栅格与矢量工具：栅格计算器、重分类、分区统计、矢量栅格互转、要素裁剪与合并
• 统一接口：whitebox_tools --run=<ToolName> [参数]，另有 --toolhelp、--toolparameters 查询元数据

---

环境准备

方式一：下载预编译二进制（推荐）

到 https://github.com/jblindsay/whitebox-tools/releases 下载对应平台的预编译压缩包，解压后目录内含 whitebox_tools（Windows 为 whitebox_tools.exe）与 WBT 插件目录。

cd /opt/WBT          # 解压后的 WBT 目录
./whitebox_tools --version
./whitebox_tools --listtools slope | head -5

# Windows PowerShell
cd C:\Tools\WBT
.\whitebox_tools.exe --version

方式二：源码编译（适合无预编译包的平台）

需要 Rust 工具链；Windows 上还需 MSVC 或 GNU 链接器。仓库根目录的 build.py 会调用 cargo 并把产物整理到 WBT/。

git clone https://github.com/jblindsay/whitebox-tools.git
cd whitebox-tools
python build.py
./WBT/whitebox_tools --version

方式三：Python 前端（whitebox 包）

whitebox-python 是社区维护的封装，首次运行会下载 / 复用 WBT 二进制；它不提升核心工具版本，因此工具能力以二进制实际版本为准。

pip install whitebox==2.3.6

# 或 conda
conda install -c conda-forge whitebox

import whitebox
print(whitebox.__version__)          # 2.3.6 —— 这是 Python 封装版本

wbt = whitebox.WhiteboxTools()
wbt.set_verbose_mode(False)
print(wbt.version())                 # 打印底层 WhiteboxTools 二进制版本