houdini-simulation

Houdini 仿真工作流指南

Pyro（烟火）、RBD（刚体）、FLIP（流体）、Vellum（柔体/布料）的标准节点搭建流程。

⚠️ 仅适用于 Houdini — 通过 run_python 执行，使用 hou 模块

📌 前置依赖: 执行任何修改操作前，请先阅读 houdini-operation-rules Skill

---

通用仿真注意事项

1. 所有仿真操作必须包裹在 undo group 中
2. 仿真节点链通常为: Source → Solver → Post-Process → Cache
3. 务必使用 File Cache 节点缓存仿真结果，避免反复计算
4. 调试时先用低分辨率，确认效果后再提高分辨率
5. Houdini 20+ 推荐使用 SOP-level 仿真节点（而非 DOP Network），更简洁

---

1. Pyro 烟火仿真

流程: Source → Pyro Solver → Visualize → Cache

[Sphere/Source Geometry]
       ↓
[Pyro Source] — 生成密度/温度/燃料体积
       ↓
[Pyro Solver] — 烟火解算
       ↓
[Pyro Post Process] — 后处理（着色等）
       ↓
[File Cache] — 缓存 VDB 到磁盘

Python 代码模板

import hou

with hou.undos.group("ArtClaw: Pyro 仿真搭建"):
    # 创建 geo 节点
    geo = hou.node("/obj").createNode("geo", "pyro_sim")
    for child in geo.children():
        child.destroy()

    # ① 源几何体 - 球体作为火源
    sphere = geo.createNode("sphere", "fire_source")
    sphere.parm("scale").set(0.5)

    # ② Pyro Source - 从几何体生成体积源
    pyro_source = geo.createNode("pyrosource", "pyro_source")
    pyro_source.setInput(0, sphere)
    # 设置为燃烧模式
    pyro_source.parm("mode").set(0)  # Burn

    # ③ Pyro Solver (SOP-level, Houdini 20+)
    pyro_solver = geo.createNode("pyrosolver", "pyro_solver")
    pyro_solver.setInput(0, pyro_source)  # Source 输入

    # 基本参数调整
    pyro_solver.parm("resscale").set(0.5)     # 分辨率缩放（调试用低值）
    pyro_solver.parm("timescale").set(1.0)    # 时间缩放

    # ④ Pyro Post Process - 着色和可视化
    pyro_post = geo.createNode("pyropostprocess", "pyro_post")
    pyro_post.setInput(0, pyro_solver)

    # ⑤ File Cache - 缓存结果
    cache = geo.createNode("filecache", "pyro_cache")
    cache.setInput(0, pyro_post)
    cache.parm("file").set("$HIP/cache/pyro/pyro.$F4.bgeo.sc")
    cache.parm("trange").set(1)  # Render Frame Range

    cache.setDisplayFlag(True)
    cache.setRenderFlag(True)
    geo.layoutChildren()

print("Pyro 仿真节点搭建完成")
print("提示: 点击 Pyro Solver 的 Play 按钮开始仿真")