Utility network vocabulary

Essential utility network terms are listed along with their descriptions.

Analytics

Analytics is the process of analyzing the utility network data to perform inspections of the network (utility network traces) and schematically represent the whole or parts of the utility network (network diagrams).

Asset group

The asset group attribute represents the major classification of utility features. The ASSETGROUP field is part of the schema for all datasets in the structure network and domain network, with the exception of the SubnetLine class. It is also defined as the subtype field. Subtype values are configured to define the major classification of your assets. Further classification of assets is accomplished by assigning attribute domains at the subtype level on the ASSETTYPE field.

To learn more, see Utility feature classification.

Asset type

The asset type attribute represents the minor classification of utility features. This allows further classification for each asset group. The ASSETTYPE field is part of the schema for all datasets in the structure and domain network, with the exception of the SubnetLine class. To extend the classification of assets, attribute domains are assigned on the ASSETTYPE field at the subtype level (asset group) for each network feature class. This allows a rich classification of network features using the asset group as a major classification and asset type as a minor classification of features.

To learn more, see Utility feature classification.

Associations

Associations model relationships between features that are not geometrically coincident. This allows modeling connectivity between features that are not coincident, the structural support of assets, and features contained within other features.

Learn more about associations

Association rules

Association rules prevent an editor from adding logically invalid feature associations in a network. Association rules define the valid ways network features can be associated with each other. There are three broad types of association rules: connectivity rules enforce the types of features that can be connected, structural attachment rules enforce the types of devices that can be connected to a structure, and containment rules enforce the types of network features that can be contained in network container features.

Examples

  • Connectivity rule: A transformer can connect to a fuse.
  • Structural attachment rule: A capacitor can be attached to a pole.
  • Containment rule: A vault can contain valves and pipes.

Connectivity

Network features in a utility network can be connected to each other in two basic ways: either with a shared endpoint, vertex, or point (common x-, y-, and z-values) or with a defined connectivity association between two features that are not spatially coincident. This is called connectivity.

Learn more about connectivity and traversability

Example

A pump placed at the end of a water pipe will have connectivity established because of the shared location.

Complex edge

A complex edge allow resources to enter one end of the edge and exit the other end. They also allow resources to flow in or out along the edge feature without the need to physically split the edge. This behavior is supported with complex edges because they allow midspan connectivity

Connectivity association

Junction-junction connectivity associations are used to establish a relationship between two point features or junction objects. Junction-junction connectivity associations also support connectivity between terminals on features. You can define connectivity associations for point feature classes and junction object tables in the domain network and structure network as long as network rules exist to support the association. Two point features, such as a transformer and fuse, that are not coincident can be offset from each other by x and y or z while connectivity is maintained through a connectivity association.

Learn more about connectivity associations

Container

A container represents an assembly of network features that are normally shown as a single feature on a map. For example, an electrical switchgear container feature contains internal switches, fuses, and a busbar, which are important for tracing analysis, but a map showing all these internal features would be too dense. Network features inside a container can be connected to features outside a container.

Example

Electrical substations and pumping stations are examples of container features.

Containment edit mode

Containment edit mode is enabled using the Enter Containment command in the Associations group on the Data tab on the Utility Network tab. In this mode, created features that have a supporting rule are automatically added to the active container as content. Editing in containment edit mode shows what network features are inside the active container and how they are connected. Analysis results are also shown inside the container view.

Example

While editing an assembly of features, you will usually enter containment edit mode. New features that are created are automatically added as content for the assembly.

Containment associations

Containment allows a dense collection of features to be represented by a single feature. For example, devices, wires, and conductors can be placed inside of features such as substations, switch gears, trenches, and ducts. Content features can be shown or hidden in the map view to improve visibility and reduce map clutter. Features that contain other features are called a container and the features being contained are called content.

Learn more about containment associations

Database utility network owner

When working with a utility network stored in an enterprise geodatabase, there are two owners for a utility network dataset: the database owner and the portal owner.

The database utility network owner is determined by the database user used in the data source when a utility network is created. The utility network must be accessed as the database utility network owner for configuration and publishing tasks.

Diagram view

The diagram view shows a schematic view of your network. A diagram is a symbolic representation of features in a utility network with an applied visualization technique. Diagrams can also show the results of a tracing analysis.

Example

At an electric utility, one type of diagram view is called a one-line diagram.

Directionality

Defines how resources flow through terminals on a feature. All terminal configurations require directionality to be defined as directional or bidirectional. A directional terminal configuration indicates that the network commodity can travel only one way through a device. A bidirectional terminal configuration indicates that the network commodity can travel in either direction through the Device or JunctionObject; there are no distinct upstream or downstream terminals.

See Terminal management for more information.

Dirty areas

Dirty areas mark modified features in a map that are out of date in the network topology. Dirty areas are used as visual cues to show the areas that must be validated to maintain the network topology. Dirty areas are cleared when the network topology is validated.

Example

A new medium-voltage line is constructed in the map, and a new dirty area is created that is visible around this feature.

Disjoint subnetwork

If subnetwork controllers that share the same subnetwork name cannot be traversed to one another, the subnetwork is considered disjoint. For tiers within a partitioned domain network the Set Subnetwork Definition geoprocessing tool includes an option to Support Disjoint Subnetworks. The default is to not support disjoint subnetworks for partitioned domain networks. Tiers in a hierarchical domain network always have this option to support disjoint subnetworks set as true. This property of the tier can be viewed using the Network Properties tab of the utility network properties.

Domain network

When you create a utility network, you will add one or more domain networks to it. A domain network is an industry-specific collection of feature classes such as electric distribution or gas transmission. Sometimes a utility network will have two domain networks at the transmission level and distribution level. A utility network can also have crossing domain networks, such as gas and water, if they are both managed by that utility.

Example

An electric, gas, or water utility may have two domain networks for modeling the delivery of its resource: transmission and distribution.

Edge elements

The utility network is comprised of a logical network of junction and edge elements. Edge elements comprise the logical component of edge (or line) features in a utility network. A complex edge feature is associated with a set of junction and edge elements in the logical network.

Example

A water main represented by a single line feature may be composed of multiple edge elements separated by taps for service lines.

Geometric coincidence

When two or more features exist in the same x-, y-, and z-location, they are geometrically coincident.

Example

Sometimes features can occupy the same x- and y-locations, such as devices stacked on a pole. Assigning z-values features at the same x- and y-locations will help ensure features are not geometrically coincident.

Inconsistent subnetwork

When a subnetwork has multiple subnetwork controllers and the Subnetwork Name attribute is not consistent, the subnetwork is considered inconsistent. For example, in a subnetwork with five subnetwork controllers, four of the subnetwork controllers have the correct subnetwork name, while the fifth has a different name.

If inconsistent subnetworks are discovered during the update process, an error is returned in the Update Subnetwork tool and point error features are generated for the subnetwork controllers. Inconsistent subnetworks are also reported when performing a subnetwork trace.

Learn more about updating subnetworks.

Junction-edge connectivity rule

A junction-edge connectivity rule is a type of connectivity rule that governs which junction network features can be connected to endpoints or vertices of line network features.

Example

A switch can be connected to the endpoint of a medium-voltage line.

Junction-junction connectivity rule

A junction-junction connectivity rule is a type of connectivity rule that governs the junction network features that can be connected to other junction network features. Applying this rule allows a connectivity association to be defined between two disjointed junction network features.

Example

A capacitor can be connected to a switch.

Map view

The map view shows a cartographic display of your utility network. When edits are performed, dirty areas will appear on the map showing where the network topology is not current.

Midspan connectivity

When connecting network features to a line, you can make connections at either the endpoints or the midspan vertices of a line. Using the midspan vertices of a line allows you to create network features without breaking network lines where the physical line is continuous.

Example

A typical location for midspan connectivity is where a service drop connects to an electric distribution line. Subnetwork taps also occur midspan of line features.

Multiuser model

The multiuser model is the primary deployment pattern for a utility network that employs an enterprise geodatabase for publishing and editing services from ArcGIS Enterprise. This services-based architecture allows the sharing of a utility network across all platforms (desktop, mobile, and web).

Learn more about the alternate single-user model deployment pattern using file geodatabases.

Network attribute

Network attributes are associated with attributes on features in your network. They are derived from feature attributes and cached inside the network topology to aid in performance while feature attributes are evaluated during a trace or while performing subnetwork management tasks. The values stored as attributes for features in a map are reflected or updated in the associated network attribute each time you validate the network topology.

Example

Electric phases can be modeled as a network attribute so that a trace can be run on only one of three electric phases.

Pipe diameters can be defined as a network attribute to constrain gas and water traces.

Network categories

A network category is a tag used to represent a characteristic of an asset in your network. They are created and assigned to network features for specific asset group and asset type combinations.

See Network categories for more information.

Example

A network category of Protective can be used to limit traces of electric network features to devices or equipment that is used to protect the system, such as fuses or reclosers.

Network diagrams

Network diagrams provide a simplified view of a network, which is useful for different types of engineering analysis. These are also called schematic representations and apply user-specified algorithms to collapse nonessential features and highlight crucial features for an engineer's view of the network.

Example

A one-line diagram for electric utilities is a network diagram.

Network topology

The network topology enables tracing analysis and rapid retrieval of network features. When edits occur on a utility network, affected parts of the network topology are displayed as dirty areas to indicate that the network topology does not match the edited features. The network topology stores all types of associations—connectivity, containment, and structural attachment—in the utility network. A validate network topology operation will update the associations in the area where edits took place and produce accurate tracing results.

To learn more, see Network topology.

Nonspatial objects

Junction and edge objects are nonspatial network objects used to model and work with a large number of real-world features that share a common geographical space, for example, the strands inside of a fiber cable or conductors in an underground duct. This allows organizations to model their network in more detail without the need to create features with shapes for every asset.

To learn more, see Junction and edge objects.

Portal utility network owner

When working with a utility network stored in an enterprise geodatabase, there are two owners for a utility network dataset: the database owner and the portal owner.

The active portal user when the utility network is created serves as the portal dataset owner. The portal utility network owner must meet certain requirements and prerequisites. Having the portal utility network owner signed in is a prerequisite for certain network configuration tasks as well as for publishing utility network layers. Tools that require an active portal connection with the portal utility network owner list this requirement in the usage notes.

Dive-in:
When accessed from a database connection established as the database utility network owner, the portal utility network owner is listed in the General section of the Network Properties dialog box.

Learn more about updating the portal utility network owner

Preset template

A preset template allows an editor to quickly place a complex collection of features. Preset templates create all types of needed associations as well as place network features. Preset templates are part of the core ArcGIS Pro editing framework and work with the association framework in the utility network.

Example

A preset template would place a switchgear container with all its internal switches, fuses, and busbars and connect them properly.

Service territory

The service territory is an m- and z-enabled polygon feature class containing one or more features. This is used as input when creating a utility network. The extent of the features in the service territory feature class are used to define the network extent. The network extent is a single polygon feature that is calculated by aggregating the spatial extents of all input features; it is created slightly larger than the aggregated extent from the input service territory features. The polygon that encompasses the network extent can be viewed by displaying the dirty area for a utility network when the network topology is disabled.

The network extent represents the area in which the network topology is maintained. This also restricts the editable area for all of the structure network and domain network features collectively. To restrict the creation of network features at a finer level, a constraint attribute rule can be created using Arcade geometry functions such as Intersects as part of the script expression.

Example

A service territory spans the operational area of a utility. It can be roughly the area of a city, state, or province.

Single-user model

The single-user model is an alternate deployment pattern for a utility network stored in a file geodatabase that provides access to the full analytic capability of the utility network. In this model, you interact with the utility network through ArcGIS Pro on the desktop. While concurrent access is enabled for read-only operations, locking at the feature dataset level prevents editing by more than one user.

Learn more about the multiuser model to configure a utility network on an enterprise geodatabase.

Structural attachment association

A structural attachment association allows the modeling of supporting structures and attachments in a network. Often, a utility needs to report what structural features, such as poles, are associated with a subnetwork, or it may need to locate a manhole where a piece of a critical device can be reached. Structures are not part of the network for purposes of tracing the resource, but there is a need to quickly identify and list structures that are attached to network features. Structural attachments logically associate structure features with other features in a utility network. These associations allow you to model the relationship between structures that support equipment and associated assets that are attached. For example, a pole can serve as the structure, with a transformer as the attachment.

  • A structure can have many attachments (for example, a pole with a transformer, ground, riser, and arrester attached to it).
  • Attachment features, such as platforms, can also be associated with multiple poles (structures).

Learn more about structural attachments

Structure network

Every utility network has a structure network that represents the features that support the devices and lines that convey a resource. All domain networks in a utility network share a common structure network.

Example

An electric network has poles, pads, cabinets, and other structural features that are utility assets but do not directly carry the delivered resource.

Subnetwork

A subnetwork represents a topological subpart within a tier where all the connected features are defined by the same subnetwork controller or controllers. To create a subnetwork, a subnetwork controller is set, the network topology is validated, and the subnetwork is updated.

To learn more, see Subnetworks.

Example

Subnetworks are called circuits in electric systems and pressure zones in gas and water systems.

Subnetwork-based trace

There are many core trace types provided with the Trace geoprocessing tool. Subnetwork-based traces rely on information from the subnetwork trace configuration. This is part of the subnetwork definition for a tier and is used to limit the scope of the trace results when specifying the Domain Network and Tier parameters in the Trace tool.

Subnetwork-based traces that use the subnetwork definition in the trace configuration include the following:

Learn more about utility network trace types

Subnetwork controller

A subnetwork controller is a type of network feature from which a resource is delivered or collected. A subnetwork controller type is defined for each domain network and when the tier is configured it is defined to use one or more of the controllers in the domain network. Certain asset group and asset type features in the device feature class are configured to allow features to be set as subnetwork controllers; this is done by assigning a network category. Subnetwork controllers are set for device features and junction objects using a specific terminal and are used as start or end points for tracing analysis.

Learn more about subnetwork controllers

Example

For an electric system, a subnetwork controller for electricity is a power generating station or substation. For a gravity-fed system, a subnetwork controller can be a reservoir for a water delivery system.

System junction

A system junction is a hidden network feature that is placed at the endpoint of a network edge element when there is no user-defined junction. System junctions are generated during the initial enabling of the network topology or through validating the network topology. These features are hidden in the map view but can be displayed in a network diagram view.

There are a few situations in which system junctions are created:

  • A single edge element with no user-defined junctions at the endpoints
  • Two edge elements that share an endpoint and do not have a user-defined junction connecting them
    • If the edge features have the same Asset group and Asset Type attributes, a system junction is created between the edge features and connectivity is established.
    • If the edge features have different Asset group and Asset Type attributes, a system junction is created at the end of each edge feature, and connectivity is not established. Errors are created.
Learn more about feature restrictions

Terminal

Terminals model physical connections on a feature such as a Device or JunctionObject. While terminals are not required, there are cases where terminals are necessary. A feature that serves as a subnetwork controller requires terminals when there are three or more connections to the feature. The use of terminals allows a more realistic modeling of some features and enables more accurate data exchange to external analytic systems.

See Terminal management and Terminals for more information.

Example

A transformer has high- and low-side terminals. A circuit breaker has source-side and load-side terminals.

Terminal configuration

A terminal configuration defines how a resource can flow within a feature that has defined terminals. When you create a terminal configuration, you define whether the resource can flow in both directions or only one direction, the name of terminals, whether a terminal is on the upstream or downstream side of the feature, which paths between terminals are valid, and the default path through terminals. Once created, a terminal configuration is assigned to an asset type of an asset group in the Device feature class or JunctionObject table.

Example

A delta-wye transformer will have a terminal configuration that specifies the valid pathways between the high-side and low-side terminals.

Tier

Tiers are used to segregate and manage the final architectural piece of a network: subnetworks. A single tier defines a collection of individual subnetworks that all share the same properties and adhere to the same restrictions. Properties are defined when you add a domain network and create tiers for the utility network. These properties determine the layout of tiers and their position relative to the rest of the tiers in a domain network.

For more information, see Network hierarchies with tiers and Tiers.

Example

An electric distribution domain network can be modeled with two tiers, where the medium-voltage tier starts at the load-side terminal of the outbound circuit breaker of the substation. The circuit breaker converts transmission-level voltages to medium-level voltages and traverses all the lines and devices until it reaches the high-side terminal of distribution transformers, which convert electric power to low voltages.

Trace analysis

Common types of analysis done with a network involve traces. A utility may want to know every network feature that is connected to a source, find loops in a network, or find all features upstream or downstream from a selected point. Some types of traces are constrained by specific devices, such as protective devices, and the definitions of those device types are specified by device categories in a domain network.

Example

Examples of trace analysis are upstream traces, downstream traces, and connected traces.

Traversability

Two related concepts in the utility network are connectivity and traversability. Connectivity describes the potential range of the resource flow (electricity, water, gas, or other). Traversability describes the actual range of resource flow according to the current state of devices that can impede flow, such as valves or switches. The definition of subnetworks that are delimited by the present status of interrupting devices (switches and valves) illustrates the concept of traversability.

Learn more about connectivity and traversability

Example

A water system can have many connected pipes, but closed valves disconnect zones of water delivery from one another. Both point and line features can be disabled, limiting the flow of a resource.

Unlocatable objects

Nonspatial junction and edge objects are referred to as unlocatable when they are not associated with spatial features through a connectivity, containment, or structural attachment association.

Utility network

A utility network is a geodatabase dataset that provides advanced capabilities to visualize, edit, and analyze your network data in ArcGIS. It is the main component users will work with when managing utility and telecom networks in ArcGIS, providing a comprehensive framework of functionality for the modeling of utility systems such as electric, gas, water, storm water, wastewater, and telecommunications.

A utility network is a collection of domain networks (gas, water, electric, or other) plus a structure network. An organization will specify the set of domain networks that it manages when it configures a utility network. It is possible to define associations across domain networks and enable tracing analysis across those domains. For example, you can perform electric tracing analysis from transmission to distribution levels with a utility network with electric transmission and electric distribution domain networks.

Learn more about a utility network

Example

A utility network can contain multiple domain networks. This enables the utility to define associations from common structures. For example, a municipal utility might manage poles that carry cable TV and electrical power.

Utility Network Version

When a utility network is created, the version of ArcGIS Pro is recorded in the network properties in the General section for the Created with ArcGIS Pro Release property. The Utility Network Version value is determined by the version of ArcGIS Pro used to create or upgrade a utility network dataset.

Learn more about the Utility Network Version