Skip To Content

Add Domain Network


Adds a domain network to a utility network.

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



AddDomainNetwork(in_utility_network, domain_network_name, tier_definition, subnetwork_controller_type, {domain_network_alias_name})
ParameterExplanationData Type

The utility network to which the domain network will be added.

Utility Network; Utility Network Layer

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.


The tier definition for the new domain network.

  • HIERARCHICALA hierarchical tier definition. 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 is within a pressure zone, which in turn exists within a system zone. A feature in the isolation zone also exists in the pressure zone and in the system zone.
  • PARTITIONED A partitioned tier definition. 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 within one tier.

The subnetwork controller type for the new domain network.

  • SOURCEThe subnetwork controller type is a set of sources. A source is an origin of the resource delivered. For example, for an electric system, sources of electricity are power generating stations and substations.
  • SINKThe subnetwork controller type is a set of sinks. A sink is the destination of the gathered resource.

The alias name of the domain network. This optional parameter is used to give a more descriptive name to the domain network.


Derived Output

NameExplanationData Type

The updated utility network.

Utility Network

Code sample

AddDomainNetwork example (Python window)

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

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


This tool does not use any geoprocessing environments.

Licensing information

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

Related topics