Set Edge Connectivity (Utility Network)

Summary

Defines how features will connect to a line or edge object of a given asset type.

Connectivity may be established with lines and edge objects at two locations: an endpoint and a midspan vertex. Each asset type in the domain network is set with a default edge connectivity setting.

Learn more about how to set edge connectivity for features

Usage

  • The network topology must be disabled.

  • The following requirements must be met when working with an enterprise geodatabase:

    • The Input Utility Network parameter value must be from a database connection established as the database utility network owner.
    • The connected ArcGIS Enterprise portal account must be the portal utility network owner.
    • This tool must be connected to the default version to run.
      • All other sessions connected to the default version are blocked from running validate or enable operations during the enable operation.

Parameters

LabelExplanationData Type
Input Utility Network

The utility network that contains the asset type with the edge connectivity to set.

Utility Network; Utility Network Layer
Domain Network

The domain network that contains the asset type with the edge connectivity to set.

String
Input Table

The name of the input feature class or table that contains the asset type with the edge connectivity to set.

String
Asset Group

The asset group that contains the asset type with the edge connectivity to set.

String
Asset Type

The asset type that requires the edge connectivity to set.

String
Edge Connectivity

Specifies the edge connectivity type that will be assigned to the asset type.

  • Any vertexFeatures will connect anywhere along the edge including end vertices.
  • End vertexFeatures will only connect to the end vertex of an edge.
String

Derived Output

LabelExplanationData Type
Updated Utility Network

The updated utility network.

Utility Network

arcpy.un.SetEdgeConnectivity(in_utility_network, domain_network, line_featureclass, assetgroup, assettype, edge_connectivity)
NameExplanationData Type
in_utility_network

The utility network that contains the asset type with the edge connectivity to set.

Utility Network; Utility Network Layer
domain_network

The domain network that contains the asset type with the edge connectivity to set.

String
line_featureclass

The name of the input feature class or table that contains the asset type with the edge connectivity to set.

String
assetgroup

The asset group that contains the asset type with the edge connectivity to set.

String
assettype

The asset type that requires the edge connectivity to set.

String
edge_connectivity

Specifies the edge connectivity type that will be assigned to the asset type.

  • ANY_VERTEXFeatures will connect anywhere along the edge including end vertices.
  • END_VERTEXFeatures will only connect to the end vertex of an edge.
String

Derived Output

NameExplanationData Type
out_utility_network

The updated utility network.

Utility Network

Code sample

SetEdgeConnectivity example 1 (Python window)

Alter the edge connectivity policy for the underground asset type in the Electric Distribution domain network to any vertex.

import arcpy
arcpy.SetEdgeConnectivity_un("Utility Network", "ElectricDistribution", 
                             "ElectricDistributionLine", "Low Voltage", 
                             "Underground", "AnyVertex")
SetEdgeConnectivity example 2 (Python window)

Alter the edge connectivity policy for the connector asset type in the Electric Distribution domain network to the end vertex.

import arcpy
arcpy.SetEdgeConnectivity_un("Utility Network", "ElectricDistribution", 
                             "ElectricDistributionLine", "Connector", 
                             "Connector", "EndVertex")

Environments

Licensing information

  • Basic: No
  • Standard: Yes
  • Advanced: Yes

Related topics