Add Domain Network (Utility Network)

Summary

Adds a domain network to a utility network.

To learn more about adding a domain network, see Add a domain network.

Usage

• The network topology must be disabled.

• When working with an enterprise geodatabase the following are requirements:

  • 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

Dialog

Label	Explanation	Data Type
Input Utility Network	The utility network to which the domain network will be added.	Utility Network; Utility Network Layer
Domain Network Name	The name of the new domain network. The domain network name will prefix the feature class names that are created. For example, a domain named ElectricDistribution would include a feature class named ElectricDistributionJunction.	String
Tier Definition	Specifies the tier definition for the new domain network. Hierarchical—The tier will be defined as hierarchical. In hierarchical domain networks, tiers are nested within one another, so features existing in subnetworks for a lower tier naturally participate in all higher tiers. For example, in a gas network, a valve isolation zone exists in a pressure zone, which in turn exists in a system zone. A feature in the isolation zone also exists in the pressure zone and in the system zone. Partitioned— The tier will be defined as partitioned. Features in partitioned domain networks only exist in one tier. The relationship between tiers is ordered and linear. Features can exist in one or multiple subnetworks in one tier.	String
Subnetwork Controller Type	Specifies the subnetwork controller type for the new domain network. Subnetwork source—The subnetwork controller type is a set of sources. A source is an origin of the delivered resource. For example, in an electric system, sources of electricity are power generating stations and substations. Subnetwork sink—The subnetwork controller type is a set of sinks. A sink is the destination of the gathered resource.	String
Domain Network Alias Name (Optional)	The alias name of the domain network. This optional parameter is used to give a more descriptive name to the domain network.	String

Derived Output

Label	Explanation	Data Type
Updated Utility Network	The updated utility network.	Utility Network

Python

arcpy.un.AddDomainNetwork(in_utility_network, domain_network_name, tier_definition, subnetwork_controller_type, {domain_network_alias_name})

Name	Explanation	Data Type
in_utility_network	The utility network to which the domain network will be added.	Utility Network; Utility Network Layer
domain_network_name	The name of the new domain network. The domain network name will prefix the feature class names that are created. For example, a domain named ElectricDistribution would include a feature class named ElectricDistributionJunction.	String
tier_definition	Specifies the tier definition for the new domain network. HIERARCHICAL—The tier will be defined as hierarchical. In hierarchical domain networks, tiers are nested within one another, so features existing in subnetworks for a lower tier naturally participate in all higher tiers. For example, in a gas network, a valve isolation zone exists in a pressure zone, which in turn exists in a system zone. A feature in the isolation zone also exists in the pressure zone and in the system zone. PARTITIONED— The tier will be defined as partitioned. Features in partitioned domain networks only exist in one tier. The relationship between tiers is ordered and linear. Features can exist in one or multiple subnetworks in one tier.	String
subnetwork_controller_type	Specifies the subnetwork controller type for the new domain network. SOURCE—The subnetwork controller type is a set of sources. A source is an origin of the delivered resource. For example, in an electric system, sources of electricity are power generating stations and substations. SINK—The subnetwork controller type is a set of sinks. A sink is the destination of the gathered resource.	String
domain_network_alias_name (Optional)	The alias name of the domain network. This optional parameter is used to give a more descriptive name to the domain network.	String

Derived Output

Name	Explanation	Data Type
out_utility_network	The updated utility network.	Utility Network

Code sample

AddDomainNetwork example (Python window)

Add a domain network to the MyUtilityNetwork utility network named ElectricDistribution.

import arcpy
arcpy.AddDomainNetwork_un("MyUtilityNetwork", "ElectricDistribution", 
                          "HIERARCHICAL", "SOURCE", "Electric Distribution")

Environments

This tool does not use any geoprocessing environments.

Licensing information

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