Resolve Road Conflicts (Cartography)

License Level:BasicStandardAdvanced

Summary

Resolves graphic conflicts among symbolized road features by adjusting portions of line segments.

Learn more about how Resolve Road Conflicts works

CautionCaution:

This tool does not produce output layers but instead alters the source feature classes of the input layers. If the input layers are drawn with a representation (whose editing behavior is set to store shape overrides), the modified features are stored as shape overrides in the representation. If the layer is not drawn with a representation, the geometry of the input features is modified. Using representations is recommended when working with the conflict resolution tools. That way, if the results are not acceptable, or to rerun the tool with different parameters, simply remove the overrides using the Remove Override tool. It is strongly suggested that you make a copy of your input features if you are not using representations whose editing behavior is set to store shape overrides.

Learn more about representations

CautionCaution:

A warning is raised if the input features are not in a projected coordinate system. This tool relies on linear distance units, which will create unexpected results in an unprojected coordinate system. It is strongly suggested that you run this tool on data in a projected coordinate system to ensure valid results. An error is raised and the tool will not process if the coordinate system is missing or unknown.

Illustration

The Resolve Road Conflicts tool
Road network before and after the Resolve Road Conflicts tool

Usage

Syntax

ResolveRoadConflicts_cartography (in_layers, hierarchy_field, {out_displacement_features})
ParameterExplanationData Type
in_layers
[in_layers,...]

The input feature layers containing symbolized road features that may be in conflict.

Layer
hierarchy_field

The field that contains hierarchical ranking of feature importance, where 1 is very important and larger integers reflect decreasing importance. A value of 0 (zero) locks the feature to ensure that it is not moved. The hierarchy field must be present and named the same for all input feature classes.

String
out_displacement_features
(Optional)

The output polygon features containing the degree and direction of road displacement, to be used by the Propagate Displacement tool to preserve spatial relationships.

Feature Class

Code Sample

ResolveRoadConflicts tool example 1 (Python window)

The following Python window script demonstrates how to use the ResolveRoadConflicts tool in immediate mode.

import arcpy
from arcpy import env
env.workspace = "C:/data"
env.referenceScale = "50000"
arcpy.ResolveRoadConflicts_cartography("C:/data/roads.lyr;C:/data/streets.lyr;C:/data/highways.lyr",
                                        "hierarchy", "C:/data/cartography.gdb/transportation/displace")
ResolveRoadConflicts tool example 2 (stand-alone Python script)

This stand-alone script shows an example of using the ResolveRoadConflicts tool.

# Name: ResolveRoadConflicts_standalone_script.py
# Description: Resolves symbology conflicts between roads by separating them apart from each other
# Author: ESRI
 
# Import system modules
import arcpy
from arcpy import env

# Set environment settings
env.workspace = "C:/data"
env.referenceScale = "50000"

# Set local variables
in_layers = "C:/data/roads.lyr;C:/data/streets.lyr;C:/data/highways.lyr"
hierarchy_field = "hierarchy"
out_displacement_features = "C:/data/cartography.gdb/transportation/displace"

# Execute Resolve Road Conflicts
arcpy.ResolveRoadConflicts_cartography(in_layers, level_field, out_displacement_features)

Environments

Related Topics

Licensing Information

ArcGIS for Desktop Basic: No
ArcGIS for Desktop Standard: No
ArcGIS for Desktop Advanced: Yes
3/3/2014