Disperse Markers (Cartography)
Summary
Finds representation markers that are overlapping or too close to one another and spreads them apart based on a minimum spacing and dispersal pattern.
Illustration
Usage
-
The input must be a point feature layer containing representations. Multipoint features are not a valid input. Location changes are stored as geometry overrides on the input representation.
-
The analysis of marker groups is based on a minimum rectangular envelope around each marker. If any two marker envelopes are within the minimum spacing of each other or overlap, then the two markers are considered in the same marker group.
-
Clustered or coincident representation markers are assessed and processed in groups. Within each group, markers are dispersed to the minimum spacing. Minimum spacing of zero will result in markers that touch at their edges.
-
Graphical overlaps may be introduced between marker groups. Use the Detect Graphic Conflict tool to identify conflicts.
Syntax
Parameter | Explanation | Data Type |
in_point_features |
The input point feature layer containing marker representations. | Layer |
minimum_spacing |
The minimum separation distance between individual markers, in page units. A distance must be specified and must be greater than or equal to zero. When a positive value is specified, markers will be separated by that value; when a value of zero is specified, markers will be touching. The default page unit is Points. | Linear unit |
dispersal_pattern (Optional) |
Specifies the pattern in which the dispersed representation markers are placed. A group of markers will have a center of mass derived from the locations of each marker in the group. The center of mass is then used as the anchor point around which the dispersal pattern operates.
| String |
Code Sample
The following Python window script demonstrates how to use the DisperseMarkers tool in immediate mode.
import arcpy from arcpy import env env.workspace = "C:/data" env.referenceScale = "50000" arcpy.DisperseMarkers_cartography("crime.lyr", "2 Points", "EXPANDED")
This stand-alone script shows an example of using the DisperseMarkers tool.
# Name: DisperseMarkers_standalone_script.py # Description: creates visible space between representation markers which are graphically overlappig or coincident # Import system modules import arcpy from arcpy import env # Set environment settings env.workspace = "C:/data" env.referenceScale = "50000" # Set local variables in_point_features = "crime.lyr" minimum_spacing = "2 Points" dispersal_pattern = "EXPANDED" # Execute Disperse Markers arcpy.DisperseMarkers_cartography(in_point_features, minimum_spacing, dispersal_pattern)