ArcGIS Pro

Editing in network diagrams

Introduction

Do network diagram edits impact the utility network? Do diagram layouts preserve at diagram update? Based on questions the Network Diagrams team frequently received, it’s time for a blog to talk about diagram feature geometries and editing in network diagrams in general. The sections below are to explain the impact of any geometry change on diagram features and show ways you can edit and manage network diagram content.

 

Diagram feature geometry

A network diagram represents a set of utility network or trace network features and network objects.

Every feature in a network diagram includes its own geometry. That is, a diagram junction exists in a network diagram with its own coordinates. In the same way, a diagram edge or a diagram container includes its own shape.

Same network features in different diagrams
The network features selected in the geographical map at the left are represented in three different diagrams at the right with a different geometry in each.

Moving a device or modifying the geometry of a line in a network diagram doesn’t impact the geometry of the corresponding feature on the utility network or trace network side.

Edits on network diagram features don't impact the related network features
We are reshaping a diagram edge in the network diagram at the right. This diagram edge represents the network line currently selected at the left in the utility network map. The diagram edge geometry changes, but the related network line geometry doesn't.

Also, modifying the geometry of a device or a line in a network diagram has no impact on the same device or line represented in other network diagrams.

Edits on diagram features have no impact on the other network diagrams
We are moving a diagram junction in the network diagram at the left. This diagram junction and the one currently selected in the network diagram at the right represent the same network device. The geometry change on the diagram junction at the right doesn't impact the diagram junction at the left.

Edit diagram feature geometries

You change the geometry of diagram features each time you apply diagram layouts or use ArcGIS Pro editing tools on diagram features. You can also develop your own custom diagram layout or editing tools to edit the geometry of diagram features. Also, once you have created a network diagram you are happy with, you can use the Copy Layout tool. This will copy the layout to other network diagrams when they represent the same devices, junctions, lines, or objects. Below we discuss and show examples of these different tools and workflows.

Diagram layouts

We provide various diagram layout algorithms to lay out your network diagram contents and to change your diagram feature geometries—for example, Smart Tree, Reshape Diagram Edges, Force Directed, and so on.

You can configure these diagram layouts to run during the diagram generation process. You can also manually apply these layouts to any open network diagram on some or all of the diagram content.

Apply layout algorithms on demand to a sample diagram
This animated GIF shows some diagram layout algorithms run on the entire content of a sample network diagram.

ArcGIS Pro editing tools

In ArcGIS Pro, you can use the Move, Rotate and Edit Vertices tools to edit and reshape diagram feature geometries or adjust spacing between diagram features.

Moving diagram junctions and edges in a sample network diagram
Moving diagram junctions and diagram edges in a sample network diagram is shown.
Moving content diagram features and polygon diagram containers in a sample network diagram
Moving content diagram features and polygon diagram containers in a sample network diagram is shown.

Tip: To make your edits easier using the Move or Edit Vertices tools, you can turn on the editing reference grid on your diagram map like on any standard map. Then, you can also turn snapping on.

Sample network diagram edits with both the reference grid and snapping turned on
Turning both the reference grid and snapping on when editing diagrams makes your edits easier.

Custom diagram layouts and custom editing tools

Thanks to the NetworkDiagrams core assembly installed with the ArcGIS Pro SDK for the Microsoft .NET Framework, you can develop your own custom diagram layout algorithms or editing tools. Developing custom code allows you to finely edit diagram feature geometries and place each diagram feature as you expect. For example, you can compute the relative placement of devices that compose particular sets of selected devices or automatically place a given device according to the position of others. You can also determine the placement of given lines or devices according to some attribute values.

The images below show the same fiber splice closure diagram. On the first image, it displays with its initial layout. On the second image, you see the diagram arranged thanks to a custom diagram layout. This custom layout is coded as an ArcGIS Pro add-in using ArcGIS Pro SDK for .NET. It orders and places the fibers that come in and out of the hub terminator according to the fiber numbers.

Add-in custom layout applied on a sample fiber splice closure diagram
Add-in custom layout applied on a sample fiber splice closure diagram.

Note: See our NetworkDiagram ArcGIS Pro Add-In Samples GitHub repository to learn more about how to develop your own custom diagram layouts:

In the animated GIF below, we show a custom ArcGIS Pro add-in command. This sample command allows you to horizontally align a set of selected diagram junctions using the ordinate of the pivot diagram junction to determine the horizontal alignment axis.

Horizontally align a set of selected diagram junctions according to the specified pivot diagram junction ordinate
Horizontally align a set of selected diagram junctions according to the specified pivot diagram junction ordinate.

Copy layout

You can also use the Copy Layout From Diagram command to copy diagram layouts from one diagram to another. To use this command, the diagrams must be opened and represent all or part of the same network features and network objects.

The copy process applies to the active diagram that is considered the destination diagram. The process only operates on diagram features that represent the same network elements in both the source and destination diagrams. It copies the geometry of each diagram feature in the specified source diagram to the destination diagram.

When there are selected features in the active diagram, the command processes only the selected diagram features.

 

Copy layout from a diagram to another
In the sample above, we select the Clairmont substation and its contents in the diagram at the bottom. The related network features are also included in the diagram at the top. We can recopy their geometry from the diagram at the top to the diagram at the bottom.

Edit attributes

On the sublayers under a network diagram layer, there is a join between the diagram feature class and the associated network feature class. This allows you to view both the diagram and utility/trace network attributes through the Attributes pane window or open attribute table.

However, you cannot manually edit these attributes, nor the attributes stored in the diagram edge, junction, or container class, nor those coming from the join with the associated network source feature class.
Nonetheless, there are a few exceptions when you go through custom code. On the network diagram side, you can develop custom code to edit the diagram junction Rotation attribute. On the joined network feature class side, you can change any editable attributes using custom code.

To learn more about attribute editing through network diagrams, see the two following sample add-ins available in our NetworkDiagram ArcGIS Pro Add-In Samples GitHub repository:

Undo edits

Any edits even on temporary diagrams remain in your network diagrams. This means that you cannot discard, nor undo any layout changes in your network diagrams. The only exceptions concern manual edits operated using ArcGIS Pro editing tools on diagrams created in a mobile or a file geodatabase, or on published stored network diagrams in a branch version.

In addition, when you append network elements to a diagram or update a diagram, you never lose your network diagram layout.  The Append to Diagram and Update Diagram processes always preserve the geometry of all diagram features that existed in the diagram before the operation and remain after.

Moreover, any stored diagram that you or any other user opens, always loads with its last saved layout regardless of who edited it.
Also, when you are consuming a utility network or trace network service and connected to a historical moment, you can search for any stored diagrams that existed at this moment and open them. In this case, any diagram features in the open network diagrams display with their saved geometry at this moment.

 

Conclusion

Through this blog article, we discussed various ways you can edit your network diagram content. In a future post, we will discuss how edits on your utility networks or trace networks impact your network diagrams.

About the author

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

0 Comments
Inline Feedbacks
View all comments

Next Article

Demystifying licensing for ArcGIS StreetMap Premium

Read this article