返回顶部

迁移至公共设施网络 (公共设施网络)

在本主题中

  1. 摘要
  2. 使用情况
  3. 参数
  4. 环境
  5. 许可信息

摘要

基于您提供的数据、结构和映射参数，在移动地理数据库中创建公共设施网络，从而支持基本的编辑和追踪工作流。

此工具能够利用您现有的数据，自动创建公共设施网络。 它可以将几何网络数据或非网络数据转换为移动地理数据库中的公共设施网络，同时保留现有要素类的结构。

使用情况

  • 对于源类和独立类参数，所有数据必须来自地理数据库。

  • 对于包含相关类和包含附件参数，所有的关系和附件必须使用全局 ID 主键。 不支持多对多关系和属性关系

  • 对于域网络参数值，为了正确设置子网控制器类型和层级定义参数，请务必理解公共设施网络对传统域网络的管理方式。 有关详细信息，请参阅子网控制器类型和层级定义。

  • 对于公共设施网络映射参数，编辑者追踪字段将映射到默认字段：created_user、created_date、last_edited_user 和 last_edited_date。

  • 了解公共设施网络要素的分类，有助于更好地设置多个公共设施网络映射参数。

参数

对话框Python

标注说明数据类型
输出文件夹

文件夹位置将包含输出名称参数中指定的输出文件夹和移动地理数据库。

Folder
服务区要素类

将用于创建公共设施网络地理范围的面要素类。 无法在此范围外创建公共设施网络要素。

Feature Set
公共设施网络名称
(可选)

公共设施网络名称。 默认为 Network。

String
要素数据集名称
(可选)

包含公共设施网络的要素数据集的名称。 默认为 UtilityNetwork。

String
输出名称
(可选)

输出文件夹和移动地理数据库的名称。 默认为 MigrationDatabase。

String
公共设施网络映射
(可选)

用于生成和映射输出地理数据库中公共设施网络的资产组和资产类型的要素类列表，及其详细信息。

  • 源类 - 将要迁移到公共设施网络的要素类。
  • 目标类 - 每个源类对应的目标域网络。
    • 域网络类包含传递资源的网络要素，而结构域网络类则为这些要素提供支持。
    • 点要素通常表示设备或交汇点。
    • 线要素表示域或结构网络线。
    • 面要素可以定义结构边界。
  • 资产组 - 在目标域网络类中创建的资产组的名称。 默认为源类的名称。
  • 资产类型 - 可选。 定义目标类中创建的资产组中不同资产类型的字段（可以是子类型或具有编码值域的字段）。 如果您的数据使用子类型或其他具有编码值属性域字段来区分某一类中不同类型的设备，您可以使用该数据作为目标类中使用的资产类型字段。 当您使用子类型字段作为资产类型时，如果代码在 1 到 1023 之间，则保留现有代码。否则，将使用子类型描述创建资产类型，并从 1 开始自动递增编号。 资产类型选项如下：
    • 空白 - 使用资产组名称创建一个默认的资产类型。 这是默认设置。
    • 指定字段的子类型或编码值域 - 字段的子类型或编码值用于定义资产类型。
      注：
      如果要素类已定义子类型，且选择了非子类型字段，则所选字段必须已定义编码值域。 不会使用定义在子类型字段上的编码值域
  • 是否为控制器 - 指定要素类是否能够在域网络中充当源或汇点。 启用后，属于此资产组的要素将能够作为子网控制器，存在于输出的域网络中。 是否为控制器参数的选项如下：
    • 选中 - 将为指定的资产组及资产类型分配“子网控制器”网络类别，使其能够定义子网的源头。 如果源要素类参与了几何网络，则会使用 Ancillary Role 字段中的值来确定哪些要素可作为公共设施网络中的子网控制器（适用于特定资产组及资产类型）。 这些符合条件的要素将被导出至输出位置参数指定的文件夹中，并保存为 controllers.csv 文件。后续可将此文件导入至输出公共设施网络中。 如果缺少 Ancillary Role 字段，则可在输出公共设施网络中，手动为特定资产类型设置子网控制器。
    • 未选中 - 指定的资产组及资产类型将不会被分配“子网控制器”网络类别，因此无法在域网络中充当子网控制器。

Value Table
域网络
(可选)

定义将在输出公共设施网络中创建的域网络或网络的名称和属性。 域网络具有以下属性：

  • 名称 - 域网络的名称。 该属性用于描述域网络所管理的资源类型，并作为添加到此域网络的所有网络类的前缀。
  • 子网控制器类型 - 子网控制器类型决定网络资源如何在域网络的所有子网中流动。 需指定资源是自网络中的某点发出（源），还是流向网络中的某点（汇点）：
    • 源 - 如果使用源子网控制器类型定义域网络，则资源只能远离子网控制器或从中流出，无法流向或流入子网控制器。
    • 汇点 - 如果使用汇子网控制器类型定义域网络，则资源只能流向和进入子网控制器，无法远离子网控制器或从中流出。
  • 层级定义 - 指定域网络的层级定义类型，可选项为分区型或层级型。 层定义表示相对于网络其他部分的层组织。
    • 分区 - 具有分区层级定义的域网络中的要素独立并且只能存在于一个层中。 要素可以存在于一个或多个子网中。 分区域网络中的层之间的关系按线性排列。 例如，输送层长距离输送资源，配电层为客户提供资源。
    • 等级 - 采用等级层级定义的域网络中，要素可以在多种类型的子网中进行建模。 例如，可以在层组内的两个层中对压力区和隔离区进行定义。 天然气和水要素可以作为压力层和隔离层的一部分。

提示：

通过此工具创建的公共设施网络和域网络是数据库特有的，不会继承公共设施网络基础解决方案的配置。 下面提供了不同行业配置域网络的典型指南：

  • 通信 - 通信网络是基于源的，并且通常使用分区型层级定义。 子网用于对设备端口间的电路进行建模，任何有源设备上的端口均可作为子网控制器。
  • 电力 - 电力网络是基于源的，并且使用分区型层级定义。 配电网络通常使用断路器作为各馈线的子网控制器。 变电站内的电力变压器也视作该变电站内该电压等级下所有设备的子网控制器。 输电网络使用输电线路两端的变电站设备作为子网控制器，管理输电线路的追踪分析。
  • 天然气 - 天然气网络是基于源的，并且使用等级层级定义。 公共区域内的所有天然气源，例如计量交接站和互联点，都视为资源点。
  • 雨水 - 雨水网络是基于汇点的，并且使用等级层级定义。 排放口充当流域区域的子网控制器。
  • 污水 - 污水网络是基于汇点的，并且使用等级层级定义。 网络中的污水处理厂或其他汇点充当污水汇集区域的子网控制器。
  • 水 - 水网络是基于源的，并且使用等级层级定义。 诸如水处理厂、水井、水库和系统互联点等水源均被用作供水系统的资源点。

Value Table
独立类
(可选)

指不参与公用设施网络的独立类，将被复制到输出地理数据库中。

Table
加载数据
(可选)

指定是将源类和独立类数据加载至输出公共设施网络和独立类，还是仅更新其模式。

  • 选中 - 将加载源数据至输出公共设施网络及独立类。 这是默认设置。
  • 未选中 - 输出地理数据库将仅包含模式。 数据不会被加载。

Boolean
合并字段至公共设施网络类
(可选)

指定是否将源类的字段合并到输出公共设施网络类的字段中。

  • 选中 - 将源类的字段合并到输出公共设施网络类的字段中。 这是默认设置。
  • 未选中 - 不会将源类的字段合并到输出公共设施网络类的字段中。

Boolean
包含相关类
(可选)

指定是否将源类和独立类的相关类包含在输出公共设施网络中。

  • 选中 - 在输出公共设施网络中包含源类和独立类的相关类。
  • 未选中 - 不会在输出公共设施网络中包含源类和独立类的相关类。 这是默认设置。

Boolean
包括附件
(可选)

指定是否创建附件表，并将源类的附件包含在输出地理数据库中。

  • 选中 - 附件将被迁移至输出地理数据库。
  • 未选中 - 附件将不包含在输出地理数据库中。 这是默认设置。

Boolean
公共设施网络版本

指定将要创建的公共设施网络版本。

  • 当前—将创建与当前 ArcGIS Pro 版本兼容的最新公共设施网络。 这是默认设置。
  • 7—将创建版本为 7 的公共设施网络。
  • 6—将创建版本为 6 的公共设施网络。
  • 5—将创建版本为 5 的公共设施网络。
String

派生输出

标注说明数据类型
输出公共设施网络

输出公共设施网络。

Utility Network
输出控制器

输出子网控制器。

File
输出图层文件

包含公共设施网络控制的各类子类型组图层的输出图层文件。

File
数据加载工作空间

用于将源数据映射至输出公共设施网络的数据加载工作空间。 可用于在不创建新的移动地理数据库的前提下，将数据重新加载至输出公共设施网络。

File

arcpy.un.MigrateToUtilityNetwork(output_folder, service_territory_feature_class, {utility_network_name}, {dataset_name}, {output_name}, {un_mapping}, {domain_networks}, {in_standalone_classes}, {load_data}, {merge_fields}, {include_related}, {include_attachments}, utility_network_version)
名称说明数据类型
output_folder

文件夹位置将包含 output_name 参数中指定的输出文件夹和移动地理数据库。

Folder
service_territory_feature_class

将用于创建公共设施网络地理范围的面要素类。 无法在此范围外创建公共设施网络要素。

Feature Set
utility_network_name
(可选)

公共设施网络名称。 默认为 Network。

String
dataset_name
(可选)

包含公共设施网络的要素数据集的名称。 默认为 UtilityNetwork。

String
output_name
(可选)

输出文件夹和移动地理数据库的名称。 默认为 MigrationDatabase。

String
un_mapping
[un_mapping,...]
(可选)

用于生成和映射输出地理数据库中公共设施网络的资产组和资产类型的要素类列表，及其详细信息。

  • Source Class - 将要迁移到公共设施网络的要素类。
  • Target Class - 每个 Source Class 值对应的目标域网络。 其应基于源中要素的集合类型确定。
    • 域网络类包含传递资源的网络要素，而结构域网络类则为这些要素提供支持。
    • 点要素通常表示设备或交汇点。
    • 线要素表示域或结构网络线。
    • 面要素可以定义结构边界。
  • Asset Group - 在目标域网络类中创建的资产组的名称。 默认为 Source Class 的名称。
  • Asset Type - 可选。 定义 Target Class 中创建的资产组中不同资产类型的字段（可以是子类型或具有编码值域的字段）。 如果您的数据使用子类型或其他具有编码值属性域字段来区分某一类中不同类型的设备，您可以使用该数据作为 Target Class 中使用的资产类型字段。 对于编码值域，当使用子类型定义资产类型，且所有代码均在有效范围内时，将保留代码 1 到 1023。 Asset Type 选项如下：
    • Blank - 这是用作 Asset Type 值的 Asset Group 名称。 这是默认设置。
    • Field - 使用指定字段中定义的子类型或编码值域生成 Asset Type 值。 编码值域的代码不会被保留。 若此字段在字段或子类型级别未定义任何值域，则将使用 Asset Group 名称作为 Asset Type 值。
  • Is Controller - 指定要素类是否能够在域网络中充当源或汇点。 启用后，属于此资产组的要素将能够作为子网控制器，存在于输出的域网络中。 Is Controller 选项如下：
    • CONTROLLER - 将为指定的资产组及资产类型分配“子网控制器”网络类别，使其能够定义子网的源头。 如果源要素类参与了几何网络，则会使用 Ancillary Role 字段中的值来确定哪些要素可作为公共设施网络中的子网控制器（适用于特定资产组及资产类型）。 这些符合条件的要素将被导出至 Output Location 参数指定的文件夹中，并保存为 controllers.csv 文件。后续可将此文件导入至输出公共设施网络中。 如果缺少 Ancillary Role 字段，则可在输出公共设施网络中，手动为特定资产类型设置子网控制器。
    • NO_CONTROLLER - 指定的资产组及资产类型将不会被分配“子网控制器”网络类别，因此无法在域网络中充当子网控制器。

Value Table
domain_networks
[domain_networks,...]
(可选)

定义将在输出公共设施网络中创建的域网络或网络的名称和属性。 域网络具有以下属性：

  • Name - 域网络的名称。 该属性用于描述域网络所管理的资源类型，并作为添加到此域网络的所有网络类的前缀。
  • Subnetwork Controller Type - 子网控制器类型用于确定网络资源在域网络的所有子网中的流动方式。 需指定资源是自网络中的某点发出（源），还是流向网络中的某点（汇点）：
    • SOURCE - 如果使用源子网控制器类型定义域网络，则资源只能远离子网控制器或从中流出，无法流向或流入子网控制器。
    • SINK - 如果使用汇子网控制器类型定义域网络，则资源只能流向和进入子网控制器，无法远离子网控制器或从中流出。
  • Tier Definition - 指定域网络的层级定义类型，可选项为分区型或层级型。 层定义表示相对于网络其他部分的层组织。
    • PARTITIONED - 具有分区层定义的域网络中的要素独立并且只能存在于一个层中。 要素可以存在于一个或多个子网中。 分区域网络中的层之间的关系按线性排列。 例如，输送层长距离输送资源，配电层为客户提供资源。
    • HIERARCHICAL - 采用等级层级定义的域网络中，要素可以在多种类型的子网中进行建模。 例如，可以在层组内的两个层中对压力区和隔离区进行定义。 天然气和水要素可以作为压力层和隔离层的一部分。

提示：

通过此工具创建的公共设施网络和域网络是数据库特有的，不会继承公共设施网络基础解决方案的配置。 下面提供了不同行业配置域网络的典型指南：

  • 通信 - 通信网络是基于源的，并且通常使用分区型层级定义。 子网用于对设备端口间的电路进行建模，任何有源设备上的端口均可作为子网控制器。
  • 电力 - 电力网络是基于源的，并且使用分区型层级定义。 配电网络通常使用断路器作为各馈线的子网控制器。 变电站内的电力变压器也视作该变电站内该电压等级下所有设备的子网控制器。 输电网络使用输电线路两端的变电站设备作为子网控制器，管理输电线路的追踪分析。
  • 天然气 - 天然气网络是基于源的，并且使用等级层级定义。 公共区域内的所有天然气源，例如计量交接站和互联点，都视为资源点。
  • 雨水 - 雨水网络是基于汇点的，并且使用等级层级定义。 排放口充当流域区域的子网控制器。
  • 污水 - 污水网络是基于汇点的，并且使用等级层级定义。 网络中的污水处理厂或其他汇点充当污水汇集区域的子网控制器。
  • 水 - 水网络是基于源的，并且使用等级层级定义。 诸如水处理厂、水井、水库和系统互联点等水源均被用作供水系统的资源点。

Value Table
in_standalone_classes
[in_standalone_classes,...]
(可选)

指不参与公用设施网络的独立类，将被复制到输出地理数据库中。

Table
load_data
(可选)

指定是将源类的数据加载至输出公用设施网络，还是仅在输出公共设施网络中更新源类的模式。

  • LOAD—加载源类数据至输出公共设施网络。 这是默认设置。
  • SCHEMA—仅更新输出公共设施网络中源类的模式。 数据不会被加载。
Boolean
merge_fields
(可选)

指定是否将源类的字段合并到输出公共设施网络类的字段中。

  • MERGE—将源类的字段合并到输出公共设施网络类的字段中。 这是默认设置。
  • DO_NOT_MERGE—不会将源类的字段合并到输出公共设施网络类的字段中。
Boolean
include_related
(可选)

指定是否将源类和独立类的相关类包含在输出公共设施网络中。

  • DO_NOT_INCLUDE—源类和独立类的相关类将不包含在输出地理数据库中。 这是默认设置。
  • INCLUDE—源类和独立类的相关类将包含在输出公共设施地理数据库中。
Boolean
include_attachments
(可选)

指定是否创建附件表，并将源类的附件包含在输出地理数据库中。

  • DO_NOT_INCLUDE—附件将不包含在输出地理数据库中。 这是默认设置。
  • INCLUDE—附件将被迁移至输出地理数据库。
Boolean
utility_network_version

指定将要创建的公共设施网络版本。

  • CURRENT—将创建与当前 ArcGIS Pro 版本兼容的最新公共设施网络。 这是默认设置。
  • VERSION_7—将创建版本为 7 的公共设施网络。
  • VERSION_6—将创建版本为 6 的公共设施网络。
  • VERSION_5—将创建版本为 5 的公共设施网络。
String

派生输出

名称说明数据类型
out_utility_network

输出公共设施网络。

Utility Network
out_controller

输出子网控制器。

File
out_layer_file

包含公共设施网络控制的各类子类型组图层的输出图层文件。

File
out_loading_workspace

用于将源数据映射至输出公共设施网络的数据加载工作空间。 可用于在不创建新的移动地理数据库的前提下，将数据重新加载至输出公共设施网络。

File

代码示例

MigrateToUtilityNetwork 示例（Python 窗口）

使用 MigrateToUtilityNetwork 函数从 LocalGovernment.gdb 现有几何网络中的源类创建基于源的等级水域网络。 其中，WaterLine 等要素类定义了资产类型，且 wNetworkStructure 资产组的资产类型被指定为控制器。

arcpy.un.MigrateToUtilityNetwork(r"C:\temp", r"C:\temp\LocalGovernment.gdb\wServiceBoundary", "Network", "UtilityNetwork", "MigrationDatabase", r"C:\temp\LocalGovernment.gdb\WaterDistribution\wConstructionLine StructureLine wConstructionLine # #;C:\temp\LocalGovernment.gdb\WaterDistribution\wControlValve WaterDevice wControlValve # #;C:\temp\LocalGovernment.gdb\WaterDistribution\wCasing StructureLine wCasing # #;C:\temp\LocalGovernment.gdb\WaterDistribution\wCurbStopValve WaterDevice wCurbStopValve # #;C:\temp\LocalGovernment.gdb\WaterDistribution\wFitting WaterDevice wFitting FITTINGTYPE #;C:\temp\LocalGovernment.gdb\WaterDistribution\wHydrant WaterDevice wHydrant # #;C:\temp\LocalGovernment.gdb\WaterDistribution\wLateralLine WaterLine wLateralLine LINETYPE #;C:\temp\LocalGovernment.gdb\WaterDistribution\wMain WaterLine wMain # #;C:\temp\LocalGovernment.gdb\WaterDistribution\wNetworkStructure WaterDevice wNetworkStructure STRUCTTYPE true;C:\temp\LocalGovernment.gdb\WaterDistribution\wPump WaterDevice wPump # #;C:\temp\LocalGovernment.gdb\WaterDistribution\wSamplingStation WaterJunction wSamplingStation # #;C:\temp\LocalGovernment.gdb\WaterDistribution\wServiceConnection WaterDevice wServiceConnection SERVICETYPE #;C:\temp\LocalGovernment.gdb\WaterDistribution\wStructure StructureBoundary wStructure STRUCTTYPE #;C:\temp\LocalGovernment.gdb\WaterDistribution\wSystemValve WaterDevice wSystemValve # #;C:\temp\LocalGovernment.gdb\WaterDistribution\wTestStation WaterDevice wTestStation # #", "Water SOURCE HIERARCHICAL", r"C:\temp\LocalGovernment.gdb\WaterDistribution\wAbandonedLine;C:\temp\LocalGovernment.gdb\WaterDistribution\wAbandonedPoint;C:\temp\LocalGovernment.gdb\WaterDistribution\wConstructionLine;C:\temp\LocalGovernment.gdb\WaterDistribution\wElevationPt;C:\temp\LocalGovernment.gdb\WaterDistribution\wPressureZone", "LOAD", "MERGE", "INCLUDE", "DO_NOT_INCLUDE", "VERSION_7")

环境

此工具不使用任何地理处理环境。

许可信息

  • Basic: 否
  • Standard: 是
  • Advanced: 是

相关主题

  • 迁移工具集概览
  • 查找地理处理工具

有关此主题的反馈?

在本主题中
  1. 摘要
  2. 使用情况
  3. 参数
  4. 环境
  5. 许可信息