Detect Graphic Conflict (Cartography)

License Level:BasicStandardAdvanced

Summary

Creates polygons where two or more symbolized features graphically conflict.

Illustration

Detect graphic quality

Usage

Syntax

DetectGraphicConflict_cartography (in_features, conflict_features, out_feature_class, {conflict_distance}, {line_connection_allowance})
ParameterExplanationData Type
in_features

The input feature layer containing symbolized features. CAD, coverage, or VPF annotation, dimensions, charts, dot-density or proportional symbols, raster layers, Network Analyst layers, or 3D symbols are not acceptable inputs.

Layer
conflict_features

The feature layer containing symbolized features potentially in conflict with symbolized features in the input layer.

Layer
out_feature_class

The output feature class to be created to store conflict polygons. It cannot be one of the feature classes associated with the input layers.

Feature Class
conflict_distance
(Optional)

Sets the conflict distance. Temporary buffers one-half the size of the conflict distance value are created around symbols in both the input and conflict layers. Conflict polygons will be generated where these buffers overlap. Conflict distance is measured in page units (Points, Inches, Millimeters, Centimeters). If you enter a conflict distance in map units, it will be converted to page units using the reference scale. The default conflict distance is 0, where no buffers are created and only symbols that physically overlap one another are detected as conflicts.

Linear unit
line_connection_allowance
(Optional)

The radius of a circle, centered where lines join, within which graphic overlaps won't be detected. This parameter is only considered when the input layer and the conflict layer are identical. Zero allowance will detect a conflict at each line join (if end caps are overlapping). Line connection allowance is calculated in page units (Points, Inches, Millimeters, Centimeters). If you enter a conflict distance in map units, it will be converted to page units using the reference scale. The value cannot be negative; the default value is 1 Point.

Linear unit

Code Sample

DetectGraphicConflict tool example1 (Python window)

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

import arcpy
from arcpy import env
env.workspace = "C:/data/cartography.gdb/buildings"
env.referenceScale = "50000"
arcpy.DetectGraphicConflict_cartography("footprints.lyr", "roads.lyr",
                                        "C:/data/cartography.gdb/buildings/dgc_polys",
                                        "25 meters", "0 meters")
DetectGraphicConflict tool example 2 (stand-alone Python script)

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

# Name: DetectGraphicConflict_standalone_script.py
# Description: Detects graphic conflicts between feature representations and stores the overlaps as polygons in the output feature class.
# Author: ESRI
 
# Import system modules
import arcpy
from arcpy import env

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

# Set local variables
in_features = "footprints.lyr"
conflict_features = "roads.lyr"
out_feature_class = "C:/data/cartography.gdb/buildings/dgc_polys"
conflict_distance = "25 meters"
line_connection_allowance = "0 meters"

# Execute Detect Graphic Conflict
arcpy.DetectGraphicConflict_cartography(in_features, conflict_features, out_feature_class, conflict_distance, line_connection_allowance)

Environments

Related Topics

Licensing Information

ArcGIS for Desktop Basic: No
ArcGIS for Desktop Standard: No
ArcGIS for Desktop Advanced: Yes
10/25/2012