ArcGIS Utility Network

A tale of two network diagrams: Subnetwork system diagrams and standard diagrams

In this blog, you will learn about the differences between subnetwork system diagrams and standard diagrams. You will explore the differences in how each diagram is created and updated. You will get recommendations for configuring the subnetwork diagram templates and tips to help you identify when managing subnetwork diagramming using standard diagrams is more suitable than subnetwork system diagrams.

Subnetwork system diagram and  standard diagram definitions

Standard diagrams are diagrams that you create and manage on demand starting from the input network features you choose. They represent any part of the network. You can create them for a one-off consultation without storing them in the geodatabase. You can overwrite their content and append new network features to them. You can store a standard diagram as a protected or private diagram to prevent other users from editing or viewing it. You can delete standard diagrams you own and any public diagrams you don’t own at any time.

A subnetwork system diagram is a publicly stored diagram that represents an entire subnetwork. Its creation and maintenance are fully managed by the system when you update the related subnetwork. You cannot overwrite subnetwork system content, or append new network features to subnetwork system diagrams. Only the portal utility network owner can delete subnetwork system diagrams. You can identify a subnetwork system diagram among all the diagrams created for a utility network. It appears in the Find Diagrams pane with a green exclamation point in the third column of the diagrams list.

Sample subnetwork system diagrams in the Find Diagrams pane

Standard and subnetwork system diagram creation and update

Standard diagrams

Standard diagram creation

To create a standard diagram, you must first select the initial network features or objects you want to use as input, specify the diagram template to apply, and run the Create Diagram tool. The Create Diagram tool starts from the input network features and objects and runs in memory applying the sequence of diagram rules configured on this diagram template to progressively build the standard diagram content.

Standard diagram creation process

Standard diagram update

To update a standard diagram, you must run another tool, the Update Diagram tool. The Update Diagram process automatically retrieves the input network features and objects used as input at diagram creation or at its last update. Then, starting from these queried elements, it reruns the sequence of diagram rules set up on the diagram template to update the in-memory diagram graph. By default, the Update Diagram process preserves the diagram layout. This means that the geometry of the diagram features is kept for any diagram feature present in the diagram before and after the update by default. However, any diagram feature added to the diagram during the update process is placed at its geographical position by default. You can run the Update Diagram tool at any time even when your diagram is not dirty.

Standard diagram update process

Subnetwork system diagrams

Subnetwork system diagram creation

Subnetwork system diagrams are created when the Update Subnetwork command runs on a subnetwork for the first time and that subnetwork’s tier is configured with a subnetwork diagram template. When no subnetwork diagram template is defined for a tier, no subnetwork system diagram is created when the subnetwork is updated.

The first time the Update Subnetwork tool runs, the process performs a number of different tasks. It will update the attributes on features that participate in the subnetwork, calculate summaries for the features that participate in the subnetwork, and create a subnetwork line in the SubnetLine feature class. To learn more, read the Update a subnetwork page in the online help.
Next, if a subnetwork diagram template exists for the related tier, there is an extra step in the process to create a subnetwork system diagram. During this step, the subnetwork trace runs in-memory and is used as input to build the related subnetwork system diagram. This diagram build process is the same as any standard diagram build process. It consists of applying the sequence of diagram rules configured on the specified subnetwork diagram template to progressively build the system diagram content.

Subnetwork system diagram update

To update a subnetwork system diagram, you must use the Update Subnetwork tool. The update and creation process are the same. The subnetwork system diagram content is fully overwritten starting from the updated subnetwork trace result it builds in memory. The geometry of the diagram features in the updated system diagram is preserved for any diagram feature present in the system diagram before and after the update. However, any diagram features added during the update process are placed at their geographical position.

Subnetwork system diagram update process

Diagram template setting recommendations for system diagrams

The diagram templates specified as subnetwork diagram templates for tiers must be considered as specific templates. It is recommended that you design your own subnetwork diagram templates and ensure your template settings obey the following design rules:

To sum up, when designing subnetwork diagram templates, avoid using diagram rules that will slow down the update subnetwork process or expand the diagram to include features from other subnetwork. These rules are listed in the first column in the table below. Instead, consider diagram rules that will help build system diagrams to show simplified and readable representations of subnetworks (the second column in the table below).

Not recommended for subnetwork diagram template configuration Recommended for subnetwork diagram template configuration
Add Connectivity Associations Rule
Add Expand Container Rule
Add Expand Container By Attribute Rule
Add Spatial Query Rule
Add Structural Attachments Rule
Add Set Starting Point Rule
Add Trace Rule
Add Diagram Feature Capability By Attribute Rule
Add Collapse Container Rule
Add Collapse Container By Attribute Rule
Add Reduce Junction Rule
Add Reduce Junction By Attribute Rule
Add Reduce Edge By Attribute Rule
Add Start Iteration Rule
Add Stop Iteration Rule

Note: There are three out-of-the-box diagram templates provided by default with the utility network at its creation—Basic, Expand Containers, and Collapse Containers. These diagram templates are generic with definitions that are not specific to any network domain and do not process particular network elements. They are provided to allow you to gain familiarity with network diagrams by generating simple standard diagrams. Nothing prevents you from using these templates as subnetwork diagram templates. However, they are not best suited for use as subnetwork diagram templates. Above all, do not set the Expand Containers template as a subnetwork diagram template since its definition includes an Expand Containers rule that will automatically add content features that can be part of other subnetworks.


Choose standard diagrams or subnetwork system diagrams

You must carefully analyze your needs for subnetwork diagramming before specifying any diagram templates as subnetwork diagram templates for tiers. Consider the following questions:

If you answer yes to the above questions, there is no need to set up “system” diagrams that will be automatically created for each subnetwork. Because there is overhead in generating and maintaining subnetwork system diagrams each time you run update subnetwork, only use them when you need them for all subnetworks in a tier.

What if you want a diagram that contains multiple subnetworks? This is another benefit that standard diagrams have over subnetwork system diagrams. If you want to represent a set of specific subnetworks in the same diagram, all the subnetworks in a particular region, or a highly stylized diagram of multiple interconnected subnetworks all in the same diagram, you must use a standard diagram.

In this case, as in the two others above, maintaining such a subnetwork diagram as a standard diagram using the Create Diagram and Update Diagram tools is more suitable than managing a “system” diagram through the subnetwork update process. The best approach is to configure a specific custom diagram template based on a subnetwork trace rule at the beginning of the rule sequence. Then, starting with the controllers related to subnetworks you are interested in as input, you can create the related subnetwork diagrams on demand only when you need it and choose whether to store this diagram.



In this blog, you learned the differences between standard and subnetwork system diagrams, and how to judge the relevance of managing subnetwork diagrams as system or standard diagrams.

In a future post, you will learn what makes standard diagrams and subnetwork system diagrams become inconsistent during typical workflows and how to make these diagrams consistent again.


About the author

The Network Diagrams Team blogs about network diagram topics. #UtilityNetwork #TraceNetwork #EsriElectric #EsriGas

Inline Feedbacks
View all comments

Next Article

Using Alternative Text for Equitable Storytelling

Read this article