cffview：不用打开 Fluent 就能看算例设置的 Python 小工具

在使用 Ansys Fluent 的过程中，有时候只是想看一下某个 case 某个参数的数值是多少，但是使用 Fluent 打开 case 需要花费一定时间，所以写了个小工具叫 cffview，在终端里直接读 Fluent 算例的设置，不用启动 Fluent。

安装

pip install cffview

用法

# 查看求解器设置和边界条件
cffview case.cas.h5 --solver --bd

# 查看全部设置并保存为 JSON
cffview case.cas.h5 --save

# 可视化网格（支持 .cas.h5 和 .msh.h5）
cffview case.cas.h5 --mesh

# 导出原始 Scheme 字符串
cffview case.cas.h5 --extract

输出是彩色高亮的 JSON，也能存成文件用 Python 批量处理。

支持的查看项：求解器配置 --solver、材料 --mat、边界条件 --bd、命名表达式 --ne、离散格式与松弛因子 --disc、报告定义 --rd、图表集 --plotsets、监控集 --monitorsets、迭代设置 --iter、云图 --contours、矢量图 --vectors。随意组合，不加选项就是全输出。

演示

原理

Fluent 从 2023 R1 起默认用 HDF5 存算例。用 h5py 打开 .cas.h5，核心就两个数据集：

• settings/Rampant Variables — 求解器、材料、离散格式等，是一段 Scheme（Lisp 方言）字符串

• settings/Thread Variables — 边界条件，也是 Scheme 字符串

内容示例：

(rp-seg? . #t)         ;; 基于压力的求解器
(rp-unsteady? . #f)      ;; 稳态
(rp-kw? . #t)          ;; k-omega 湍流模型
(gravity/x-expr "-9.8")   ;; x 方向重力

处理流程分为三步：h5py 读字符串 → 正则 + sexpdata 解析 Scheme 字符串读取所需参数 → 打印 JSON。

网格可视化用 PyVista, .cas.h5 可以直接读取，.msh.h5 需要手动解析。

局限

• 只在 Fluent 25R2 下测过

• 只实现了个人常用设置的读取

项目地址：https://github.com/preamer/cffview

代码不多，结构清晰，欢迎交流。