Extends a network diagram one network element level based on network connectivity or traversability or on containment or structural attachment associations.
For example, a diagram with a portion of a pipe network in it may have many open-ended pipes with connected network elements. When running the Extend Diagram tool on this diagram with the By connectivity extension type, any connected elements are appended to the diagram.
Elements can also be obtained based on traversability using the By traversability extension type. In this case, network elements are appended to the diagram if they allow the network commodity to continue through to the next elements. For example, a diagram with a portion of a pipe network in it may have a closed valve at the end of a pipe end. Since a resource travelling this network cannot travel beyond the closed valve, the valve is not returned in the diagram. If this example was based on connectivity instead of traversability, the valve would be returned, as it is connected to the pipe.
Extending diagrams can be locked on the related diagram template. In this case, the Extend Diagram property appears as Disabled for the diagram template under the Diagram Templates section in the Network Diagrams tab in the network Layer Properties dialog box.
If you have an open edit session, you must save your edits prior to running this tool. This ensures that the diagram reflects the latest changes made to the network topology in the database. If you fail to save your edits, the edits will not be reflected in the diagram.
This tool is not supported when working with a database connection to a utility network or trace network in an enterprise geodatabase. You must use either the related published utility network or trace network service, or a utility network or trace network in a file or mobile geodatabase.
The input network diagram layer must be from either a utility network or a trace network in a file or mobile geodatabase or a network diagram service.
The All Layers mode must be enabled on the input network diagram layer.
This tool is typically used for network data control and validation.
This tool applies to either the entire content of a network diagram or a part of it (that is, to a subset of selected diagram features). It allows you to fully or partially extend a network diagram one network element level based on network connectivity or traversability or containment or structural attachments.
Use this tool to extend a network diagram one network element level when you are working on a small portion of your network. It allows you to check the connectivity on this area and visually control network data quality.
Select any structural feature in your diagram and use this tool to extend the diagram one level by attachment. This adds all the network elements that have logical associations with the selected structural element and allows you to visually check the structural attachment associations.
In the same way, select any feature in your diagram that is expected to be attached to a network structure, and use this tool to extend the diagram one level by attachment. If an attachment with a network structure exists, the structure is added to the diagram.
Use this tool to quickly extend a network diagram or a selected portion of a network diagram one level by containment. This adds any network elements that are the contents of network container elements represented in the diagram or in the selected portion of the diagram.
Running this tool on subnetwork system diagrams will fail, as they are maintained by the Update Subnetwork tool. These types of diagrams cannot be altered.
The Extend Diagram tool fails in the following situations:
| Label | Explanation | Data Type |
Input Network Diagram Layer
| The network diagram to extend. | Diagram Layer |
Ignore traversability
(Optional) | Boolean | |
Extension Type
(Optional) | Specifies how the diagram will be extended.
| String |
| Label | Explanation | Data Type |
| Output Network Diagram | The updated network diagram layer. | Diagram Layer |
arcpy.nd.ExtendDiagram(in_network_diagram_layer, {ignore_traversability}, {extension_type})| Name | Explanation | Data Type |
in_network_diagram_layer | The network diagram to extend. | Diagram Layer |
ignore_traversability (Optional) | Specifies whether traversability or connectivity is used to extend the diagram. Legacy:This parameter was deprecated at ArcGIS Pro 2.2. It is systematically ignored regardless of its value when the extension_type parameter is specified. To maintain compatibility with models and Python scripts written at ArcGIS Pro 2.1, it remains enabled when the extension_type parameter is not specified.
| Boolean |
extension_type (Optional) | Specifies how the diagram will be extended.
| String |
| Name | Explanation | Data Type |
| out_network_diagram_layer | The updated network diagram layer. | Diagram Layer |
Extend the specified network diagram based on the traversability of the network.
import arcpy
arcpy.ExtendDiagram_nd('Temporary Diagram', '', 'BY_TRAVERSABILITY')