PIPESIM Python Toolkit 系列(6)：连接与断开——构建管网拓扑关系

管网模拟的核心是组件之间的连接关系（拓扑）。PTK 提供了完整的连接操作 API，让工程师能够通过代码自动构建复杂的管网拓扑结构。

基本连接操作

将井 Well_1 连接到管线 FL-1：文章源自云智设计-https://www.cidrg.com/cid-college/tutorial/pipesim/26890.html

model.connect('Well_1', 'FL-1')

指定端口的多端口连接

分离器（Separator）通常有 2~3 个出口，需要明确指定端口：文章源自云智设计-https://www.cidrg.com/cid-college/tutorial/pipesim/26890.html

from sixgill.definitions import Connection
# 顶部出口连接
model.connect(
    source='MBD101',
    destination='FL-PMP-1',
    source_port=Connection.Separator.TOP)
# 底部出口连接
model.connect(
    source='MBD101',
    destination='FL-WATER',
    source_port=Connection.Separator.BOTTOM)

高级井的多端口连接

同心管或双管柱井可能有多个出口：文章源自云智设计-https://www.cidrg.com/cid-college/tutorial/pipesim/26890.html

model.connect(
    source='Well_1',
    destination='FL-2',
    source_port=Connection.AdvancedWell.MIDDLE)

断开连接

model.disconnect(source='MBD101', destination='FL-PMP-1')

查看连接关系

查询某个组件的所有连接：文章源自云智设计-https://www.cidrg.com/cid-college/tutorial/pipesim/26890.html

connections = model.connections(context='MBD-101')
# 用 DataFrame 格式化显示
import pandas as pd
pd.DataFrame(connections)

使用 get_connections() 获取结构化连接信息：文章源自云智设计-https://www.cidrg.com/cid-college/tutorial/pipesim/26890.html

mbd101_conn = model.get_connections(context="MBD-101")
# 查看上游
upstream = mbd101_conn[Connection.SOURCE]
# 查看顶部出口
top_outlet = mbd101_conn[Connection.Separator.TOP]

应用场景

在大规模管网建模中，PTK 的 connect() 方法配合 Excel 数据源，可以批量自动化完成数百口井与管汇、分离器的连接操作，避免手动拖拽的繁琐和易错。文章源自云智设计-https://www.cidrg.com/cid-college/tutorial/pipesim/26890.html 文章源自云智设计-https://www.cidrg.com/cid-college/tutorial/pipesim/26890.html