使用方法
关联必须位于单个 .csv 文件中。
公共设施网络中必须存在 .csv 文件中列出的要素。
.csv 文件中列出的要素必须具有支持的规则。
此工具可以与导出关联工具一起使用。
如果导入过程中出现错误(例如缺少规则),则整个导入过程将回滚。查看错误并检查 .csv 文件,然后再次导入关联。
使用企业级地理数据库时,输入公共设施网络必须来自作为数据库公共设施网络所有者建立的数据库连接。
.csv 文件中的信息按以下格式存储:ASSOCIATIONTYPE、FROMFEATURECLASS、FROMASSETGROUP、FROMASSETTYPE、FROMGLOBALID、FROMTERMINAL、TOFEATURECLASS、TOASSETGROUP、TOASSETTYPE、TOGLOBALID、TOTERMINAL、ISCONTENTVISIBLE、PERCENTALONG。
.csv 列
列 说明 示例 ASSOCIATIONTYPE
关联的类型。
- 交汇点交汇点连通性
- 交汇点边自连通性
- 交汇点边中跨连通性
- 交汇点边至连通性
- 包含
- 结构附件
包含
FROMFEATURECLASS/TOFEATURECLASS
参与关联的要素类或对象。
ElectricDistributionDevice、ElectricDistributionAssembly、StructureJunction
FROMASSETGROUP/TOASSETGROUP
要素的资产组。
Transformer、Fuse、Elbow
FROMASSETTYPE/TOASSETTYPE
要素的资产类型。
Streetlight、Attachment、Single-phase padmounted
FROMGLOBALID/TOGLOBALID
要素的全局 ID。
{16558C73-013C-4169-A095-7E9DCD57EB57}
FROMTERMINAL/TOTERMINAL
参与关联的终端。这仅适用于交汇点-交汇点连通性关联。
单一终端、负载、来源
ISCONTENTVISIBLE
布尔型标记指明内容是否可见。这仅适用于包含关联。
False、True
PERCENTALONG
交汇点对象和边对象之间交汇点边中跨连通性关联的延伸百分比值。
0.75
语法
arcpy.un.ImportAssociations(in_utility_network, association_type, csv_file)
参数 | 说明 | 数据类型 |
in_utility_network | 接收关联的公共设施网络。 | Utility Network; Utility Network Layer |
association_type | 指定要导入的关联类型。
| String |
csv_file | 包含待导入关联的 .csv 文件。 | File |
派生输出
名称 | 说明 | 数据类型 |
out_utility_network | 更新的公共设施网络。 | 公共设施网络 |
代码示例
此示例脚本会将所有类型的关联导入到名为 GridNetwork 的公共设施网络。
import arcpy
arcpy.ImportAssociations_un("GridNetwork", "ALL", "C:\\Temp\\AllAssociations.csv")
此示例脚本会将交汇点-交汇点连通性关联导入到名为 GridNetwork 的公共设施网络。
import arcpy
arcpy.ImportAssociations_un("GridNetwork", "JUNCTION_JUNCTION_CONNECTIVITY",
"C:\\Temp\\JJconnectivity.csv")
此示例脚本会将包含关联导入到名为 GridNetwork 的公共设施网络。
import arcpy
arcpy.ImportAssociations_un("GridNetwork", "CONTAINMENT",
"C:\\Temp\\Containment.csv")
此示例脚本会将结构附件关联导入名为 GridNetwork 的公共设施网络。
import arcpy
arcpy.ImportAssociations_un("GridNetwork", "STRUCTURAL_ATTACHMENT",
"C:\\Temp\\StructuralAttachment.csv")
环境
许可信息
- Basic: 否
- Standard: 是
- Advanced: 是