Skip To Content

Apply Spatial Dispatch Layout


Separates diagram junctions that are visibly close to overlapping.


If you have an open edit session, you must save your edits prior to running this tool. This ensures 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.


Each layout algorithm includes default parameter values. The default parameter values will be used unless otherwise specified. If the input network diagram is based on a template for which this layout has been configured with a different parameter value, that value is used instead.


  • This layout algorithm progressively separates diagram junctions that are visibly close to overlapping according to their current positions and to the shift factor specified.


ApplySpatialDispatchLayout_un (in_network_diagram_layer, {are_containers_preserved}, {iterations_number}, {maximum_shift_factor})
ParameterExplanationData Type

The network diagram where the layout will be applied.

Diagram Layer

Specifies how containers will be processed by the algorithm.

  • PRESERVE_CONTAINERS The layout algorithm executes on the top graph of the diagram so containers are preserved.
  • IGNORE_CONTAINERSThe layout algorithm executes on both content and noncontent features in the diagram. This is the default.

The number of iterations to process. The default is 5.


Increases the diagram junctions' displacement for junctions that are very close together. The larger the shift factor, the larger the separation between the diagram junctions that almost overlap. The default is 2.


Derived Output

NameExplanationData Type

The updated network diagram layer.

Diagram Layer

Code sample

ApplySpatialDispatchLayout example (Python window)

Apply the Spatial Dispatch layout algorithm to the diagram called Temporary Diagram.

import arcpy
arcpy.ApplySpatialDispatchLayout_un("Temporary Diagram", "PRESERVE_CONTAINERS", 5, 2)


This tool does not use any geoprocessing environments.

Licensing information

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

Related topics