PIPESIM Python Toolkit 系列(7)：组件复制、转换与重命名

在模型管理场景中，经常需要批量复制相似的井、将 Junction 转换为设备组件，或对组件进行重命名。PTK 提供了高效的方法来完成这些操作。

复制组件

复制一口井及其所有井下设备：文章源自云智设计-https://www.cidrg.com/cid-college/tutorial/pipesim/26891.html

model.copy(context='Well_1', name='Well_2')

该方法会自动复制井的所有子组件（油管、完井、ESP、油嘴等），生成一个完整的新井。文章源自云智设计-https://www.cidrg.com/cid-college/tutorial/pipesim/26891.html

转换组件类型

PIPESIM 中 Junction 是通用节点，可转换为 Well、Source 或 Sink。这在 GIS 导入后尤其有用：文章源自云智设计-https://www.cidrg.com/cid-college/tutorial/pipesim/26891.html

# 将 Junction 转换为 Well
model.convert(context="Manifold", to_component=ModelComponents.WELL)

# 将 Junction 转换为 Source
model.convert(context="Inlet_J1", to_component=ModelComponents.SOURCE)

# 将 Junction 转换为 Sink
model.convert(context="Outlet_J5", to_component=ModelComponents.SINK)

重要：转换与复制的限制

PTK 文档特别提醒两个关键点：文章源自云智设计-https://www.cidrg.com/cid-college/tutorial/pipesim/26891.html

• 组件转换（convert）：转换后的组件会丢失原组件的参数设置，需要重新赋值。
• 组件复制（copy）：复制井时，流体是引用而非复制——修改复制井的流体会同时影响原井。

重命名组件

通过参数设置来重命名：文章源自云智设计-https://www.cidrg.com/cid-college/tutorial/pipesim/26891.html

model.set_value(
    context="Src1",
    parameter=Parameters.Source.NAME,
    value='SOURCE_1')

重命名后，所有引用旧名称的连接关系会自动更新。文章源自云智设计-https://www.cidrg.com/cid-college/tutorial/pipesim/26891.html

实战技巧

在批量建模场景中，可以先创建一个"模板井"（包含所有典型井下设备），然后通过 copy() 快速生成多个变体，再通过 set_value 微调每个井的独有参数（如油藏压力、深度等）。这种方式比从头创建每个井快数十倍。文章源自云智设计-https://www.cidrg.com/cid-college/tutorial/pipesim/26891.html 文章源自云智设计-https://www.cidrg.com/cid-college/tutorial/pipesim/26891.html