Résumé
Recherche des ponctuels de représentation qui se superposent ou sont trop près les uns des autres, en fonction de la symbologie et de l’échelle de référence, et les disperse selon un espacement minimal et un modèle de dispersion.
Illustration
Utilisation
L'entrée doit être une couche d'entités ponctuelles contenant des représentations. Une échelle de référence doit être définie. Les entités multi-points ne sont pas des entrées valides. Les changements d'emplacement sont stockés en fonction du comportement de mise à jour sur la représentation en entrée. Pour en savoir plus, reportez-vous à la rubrique Configuration du comportement lors de la mise à jour de la géométrie.
Les symboles ponctuels de représentation agrégés ou qui coïncident sont évalués et traités par groupes. L'analyse de groupes de symboles ponctuels est basée sur une enveloppe rectangulaire minimale autour de chaque symbole ponctuel. Les groupes sont constitués de symboles ponctuels dont les enveloppes se chevauchent ou sont séparées par un espacement minimal. Dans chaque groupe, les symboles ponctuels sont dispersés selon l'espacement minimal.
Des superpositions graphiques peuvent être introduites entre les groupes de symboles ponctuels. Utilisez l'outil Détecter les conflits graphiques pour identifier les conflits.
Syntaxe
arcpy.cartography.DisperseMarkers(in_point_features, minimum_spacing, {dispersal_pattern})
Paramètre | Explication | Type de données |
in_point_features | Couche d’entités ponctuelles en entrée contenant des représentations ponctuelles. | Layer |
minimum_spacing | Distance de séparation minimale entre chaque symbole ponctuel, exprimée en unités de page. Une distance supérieure ou égale à zéro doit être spécifiée. Quand une valeur positive est spécifiée, les ponctuels sont séparés par cette valeur ; quand une valeur nulle est spécifiée, les ponctuels se touchent. L'unité de page par défaut est le point. | Linear Unit |
dispersal_pattern (Facultatif) | Spécifie le modèle dans lequel les ponctuels de représentation dispersés sont placés. Le centre de masse d’un groupe de ponctuels est dérivé des emplacements de tous les ponctuels inclus dans ce groupe. Le centre de masse est utilisé comme point d'ancrage autour duquel opère le modèle de dispersion.
| String |
Sortie dérivée
Nom | Explication | Type de données |
out_representations | Entités en entrée mises à jour. | Feature Layer |
Exemple de code
Exemple 1 d’utilisation de la fonction DisperseMarkers (fenêtre Python)
Le script ci-dessous pour la fenêtre Python illustre l’utilisation de la fonction DisperseMarkers en mode immédiat.
import arcpy
arcpy.env.workspace = "C:/data"
arcpy.env.referenceScale = "50000"
arcpy.DisperseMarkers_cartography("crime.lyr", "2 Points", "EXPANDED")
Exemple 2 d’utilisation de l’outil DisperseMarkers (script autonome)
Ce script autonome montre un exemple d’utilisation de la fonction DisperseMarkers.
# Name: DisperseMarkers_standalone_script.py
# Description: creates visible space between representation markers which are graphically overlappig or coincident
# 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_point_features = "crime.lyr"
minimum_spacing = "2 Points"
dispersal_pattern = "EXPANDED"
# Execute Disperse Markers
arcpy.DisperseMarkers_cartography(in_point_features, minimum_spacing, dispersal_pattern)
Environnements
Informations de licence
- Basic: Non
- Standard: Non
- Advanced: Oui