PIPESIM Python Toolkit 系列(2)：第一个脚本——打开模型与基本查询

了解 PTK 的最佳方式是直接动手写代码。本文将通过一个完整示例，演示如何使用 Python 打开 PIPESIM 模型文件，执行基本查询并保存修改。

打开和关闭模型

所有操作都从导入 Model 类开始：文章源自云智设计-https://www.cidrg.com/cid-college/tutorial/pipesim/26886.html

from sixgill.pipesim import Model

打开一个 .pips 文件：文章源自云智设计-https://www.cidrg.com/cid-college/tutorial/pipesim/26886.html

model = Model.open('C:/Projects/MyNetwork.pips')

PTK 支持两种单位制——油田单位（默认）和国际单位制（SI）。指定 SI 单位：文章源自云智设计-https://www.cidrg.com/cid-college/tutorial/pipesim/26886.html

from sixgill.definitions import Units
model = Model.open('MyNetwork.pips', units=Units.SI)

创建全新模型：文章源自云智设计-https://www.cidrg.com/cid-college/tutorial/pipesim/26886.html

model = Model.new('C:/Projects/NewModel.pips')

模型基本信息查询

获取模型元数据：文章源自云智设计-https://www.cidrg.com/cid-college/tutorial/pipesim/26886.html

model.about()

这会返回模型名称、单位制、组件数量等信息。文章源自云智设计-https://www.cidrg.com/cid-college/tutorial/pipesim/26886.html

保存与关闭

model.save()                                    # 覆盖保存
model.save('C:/Projects/Modified.pips')         # 另存为
model.close()                                   # 关闭会话

打开模型到 UI 中查看

如果需要可视化查看模型：文章源自云智设计-https://www.cidrg.com/cid-college/tutorial/pipesim/26886.html

model.open_ui()     # 关闭 PTK 会话，在 PIPESIM UI 中打开
# 或直接指定文件：
Model.open_ui('C:/Projects/Check.pips')

注意：调用 open_ui() 会自动关闭 PTK 会话，因为同一模型不能同时在 Toolkit 和 UI 中编辑。文章源自云智设计-https://www.cidrg.com/cid-college/tutorial/pipesim/26886.html

掌握这些基础操作后，下一篇文章将深入讲解 PTK 最核心的概念——模型上下文（Model Context）。文章源自云智设计-https://www.cidrg.com/cid-college/tutorial/pipesim/26886.html 文章源自云智设计-https://www.cidrg.com/cid-college/tutorial/pipesim/26886.html