Convertir la position des symboles ponctuels en points (Cartographie)

Synthèse

Crée des points à partir des symboles ponctuels d’un placement de symboles ponctuels dans une entité surfacique symbolisée.

Illustration

Illustration de l’outil Convertir la position des symboles ponctuels en points
Les symboles ponctuels placés à l’intérieur de polygones sont convertis en entités ponctuelles. Les points peuvent être déplacés afin d’assurer qu’une distance minimale est conservée entre les symboles ponctuels. Ils peuvent également être supprimés pour éviter les conflits avec les entités de type limites ou interruption.

Utilisation

  • Cet outil évalue les conflits graphiques des entités symbolisées pour déterminer quels symboles ponctuels seront ajoutés dans la sortie. L’étendue de symbologie et l’échelle de référence sont toutes deux utilisées. Exécutez cet outil uniquement après avoir finalisé l’apparence des symboles et assurez-vous que l’échelle de référence correspond à l’échelle finale voulue.

  • Le système de coordonnées par défaut de la sortie est le même que celui de la vue cartographique actuelle. Pour utiliser un autre système de coordonnées, utilisez le paramètre d’environnement Système de coordonnées cartographiques. Quand l’outil est exécuté dans un environnement d’écriture de scripts sans carte active, le système de coordonnées des entités en entrée est utilisé.

  • Seules les symbologies Symbole unique et Valeurs uniques sont prises en charge sur la couche en entrée. Les paramètres d’appariement d’attribut enregistrés dans la couche en entrée sont respectés.

  • Lorsque le paramètre Conserver au moins un symbole ponctuel est spécifié, un fichier journal est créé pour répertorier les entités en entrée pour lesquelles un seul symbole ponctuel a été créé, car il aurait sinon été omis. L’emplacement du fichier journal est inclus dans les détails du message de géotraitement.

  • Des points sont créés pour chaque couche de symboles ponctuels prise en charge dans un symbole en entrée. Pour vous assurer que les symboles ponctuels multi-couches complexes sont traités comme une entité unique et créent un seul point dans la sortie, commencez par créer le symbole en tant que symbole ponctuel, puis enregistrez-le en tant que style. Ensuite, dans l’onglet Couches de la fenêtre Symbologie, utilisez le bouton Style dans les paramètres Apparence pour définir le symbole ponctuel à partir du style.

  • Les paramètres Méthode de déplacement et Distance minimale des symboles ponctuels sont disponibles quand au moins une couche de symboles ponctuels utilise un placement aléatoire. Utilisez ces paramètres pour résoudre les conflits entre les symboles ponctuels qui se chevauchent et pour conserver une distance minimale entre eux. L’option Éloigner éloigne les symboles ponctuels l’un de l’autre jusqu’à ce qu’ils atteignent la distance minimale et supprime des symboles ponctuels si nécessaire pour éviter les conflits. L’option Déplacer vers le carroyage déplace les symboles ponctuels jusqu’à ce qu’ils atteignent la distance de séparation minimale ou atteignent leur placement d’origine sur le carroyage. L’option Déplacer vers le carroyage ne supprime aucun symbole ponctuel.

Paramètres

ÉtiquetteExplicationType de données
Couche en entrée

Couche de polygones symbolisée avec un placement de symbole ponctuel.

Layer
Classe d’entités en sortie

Classe d’entités ponctuelles contenant des points créés à partir des symboles ponctuels dans les paramètres de placement de symbole ponctuel de la couche en entrée. Les points sont ajoutés à la carte active en tant que couche symbolisée avec un moteur de rendu à valeur unique utilisant les symboles de l’entrée.

Feature Class
Créer des multi-points
(Facultatif)

Spécifie si les entités ponctuelles en sortie sont des entités multi-points.

  • Activé : une entité multi-point est créée pour les symboles ponctuels dans chaque polygone en entrée. Il s’agit de l’option par défaut.
  • Désactivé : une entité ponctuelle est créée pour chaque symbole ponctuel.

Boolean
Option des limites
(Facultatif)

Spécifie si des points en sortie sont créés pour les symboles ponctuels en entrée qui croisent les limites du polygone.

  • Peut croiser des limitesDes points en sortie sont créés pour les symboles ponctuels en entrée qui croisent les limites du polygone. Il s’agit de l’option par défaut.
  • Distance fixeAucun point en sortie n’est créé pour les symboles ponctuels en entrée qui se trouvent à l’intérieur des limites du polygone définies par le paramètre Distance des limites.
  • Valeur à partir du champAucun point en sortie n’est créé pour les symboles ponctuels en entrée qui se trouvent à l’intérieur des limites du polygone définies par le paramètre Champ de distance des limites.
String
Distance des limites
(Facultatif)

Distance minimale entre les symboles ponctuels en sortie et les limites du polygone. Ce paramètre s’applique uniquement lorsque le paramètre Option des limites est défini sur Distance fixe. La valeur par défaut est 0.

Double
Champ de distance des limites
(Facultatif)

Champ numérique des polygones en entrée utilisé pour déterminer la distance des limites. Ce paramètre s’applique uniquement lorsque le paramètre Option des limites est défini sur Valeur à partir du champ.

Field
Unité de distance des limites
(Facultatif)

Spécifie l’unité linéaire à utiliser pour les valeurs de distance des limites.

  • KilomètresLes kilomètres sont l’unité.
  • MètresLes mètres sont l’unité.
  • DécimètresLes décimètres sont l’unité.
  • CentimètresLes centimètres sont l’unité.
  • MillimètresLes millimètres sont l’unité.
  • Milles nautiquesLes milles nautiques sont l’unité.
  • Milles terrestresL’unité est le mille terrestre.
  • YardsLes yards sont l’unité.
  • PiedsLes pieds sont l’unité.
  • PoucesLes pouces sont l’unité.
  • DegrésLes degrés sont l’unité.
  • PointsLes points sont l’unité. Il s’agit de l’option par défaut.
String
Couches de barrières en entrée
(Facultatif)

Couches qui contiennent les entités ponctuelles, linéaires ou surfaciques qui constituent des interruptions en conflit avec les symboles ponctuels en entrée. Les symboles ponctuels en conflit avec les interruptions ne sont pas créés. La symbologie des couches d’interruptions est prise en compte.

  • Couche d’interruption : couche contenant des entités ponctuelles, linéaires ou surfaciques.
  • Distance d’interruption : valeur numérique spécifiant la distance minimale entre les symboles ponctuels et l’interruption. Ce paramètre est ignoré si la valeur Champ de distance d’interruption est définie. La valeur par défaut est 0.
  • Champ de distance d’interruption : champ numérique de la couche d’interruption utilisé comme distance d’interruption. Ce paramètre écrase la valeur Distance d’interruption. La valeur par défaut est <Aucun>.
  • Unité de distance d’interruption : unité linéaire utilisée pour les valeurs de distance d’interruption. La valeur par défaut est Points.

Value Table
Conserver au moins un symbole ponctuel
(Facultatif)

Spécifie si un seul symbole ponctuel est créé pour les polygones en entrée lorsque tous les symboles ponctuels sont en conflit avec les limites ou les interruptions.

  • Activé : un symbole ponctuel est créé pour les polygones en entrée lorsque tous les symboles ponctuels sont en conflit avec les limites ou les interruptions.
  • Désactivé : aucun symbole ponctuel n’est créé pour les polygones en entrée lorsque tous les symboles ponctuels sont en conflit avec les limites ou les interruptions. Il s’agit de l’option par défaut.

Boolean
Méthode de déplacement
(Facultatif)

Spécifie la méthode de déplacement utilisée pour déplacer les symboles ponctuels qui sont trop proches les uns des autres. Ce paramètre s’applique uniquement lorsque les symboles ponctuels sont positionnés de manière aléatoire à l’intérieur des polygones.

  • Ne pas déplacerLes symboles ponctuels ne sont pas déplacés. Il s’agit de l’option par défaut.
  • Déplacer vers le carroyageLes symboles ponctuels en conflit sont déplacés vers leur point de carroyage d’origine.
  • ÉloignerLes symboles ponctuels en conflit sont éloignés les uns des autres.
String
Distance de symbole ponctuel minimum
(Facultatif)

Distance minimale entre chaque symbole ponctuel. Ce paramètre s’applique uniquement lorsque les symboles ponctuels sont positionnés de manière aléatoire à l’intérieur des polygones. La valeur par défaut est 0.

Linear Unit

arcpy.cartography.ConvertMarkerPlacementToPoints(in_layer, out_feature_class, {create_multipoints}, {boundary_option}, {boundary_distance}, {boundary_distance_field}, {boundary_distance_unit}, {in_barriers}, {keep_at_least_one_marker}, {displacement_method}, {minimum_marker_distance})
NomExplicationType de données
in_layer

Couche de polygones symbolisée avec un placement de symbole ponctuel.

Layer
out_feature_class

Classe d’entités ponctuelles contenant des points créés à partir des symboles ponctuels dans les paramètres de placement de symbole ponctuel de la couche en entrée. Les points sont ajoutés à la carte active en tant que couche symbolisée avec un moteur de rendu à valeur unique utilisant les symboles de l’entrée.

Feature Class
create_multipoints
(Facultatif)

Spécifie si les entités ponctuelles en sortie sont des entités multi-points.

  • CREATE_MULTIPOINTSUne entité multi-point est créée pour les symboles ponctuels dans chaque polygone en entrée. Il s’agit de l’option par défaut.
  • CREATE_POINTSUne entité ponctuelle est créée pour chaque symbole ponctuel.
Boolean
boundary_option
(Facultatif)

Spécifie si des points en sortie sont créés pour les symboles ponctuels en entrée qui croisent les limites du polygone.

  • MAY_CROSS_BOUNDARYDes points en sortie sont créés pour les symboles ponctuels en entrée qui croisent les limites du polygone. Il s’agit de l’option par défaut.
  • FIXED_DISTANCEAucun point en sortie n’est créé pour les symboles ponctuels en entrée qui se trouvent à l’intérieur des limites du polygone définies par le paramètre boundary_distance.
  • VALUE_FROM_FIELDAucun point en sortie n’est créé pour les symboles ponctuels en entrée qui se trouvent à l’intérieur des limites du polygone définies par le paramètre boundary_distance_field.
String
boundary_distance
(Facultatif)

Distance minimale entre les symboles ponctuels en sortie et les limites du polygone. Ce paramètre s’applique uniquement lorsque le paramètre boundary_option est défini sur FIXED_DISTANCE. La valeur par défaut est 0.

Double
boundary_distance_field
(Facultatif)

Champ numérique des polygones en entrée utilisé pour déterminer la distance des limites. Ce paramètre s’applique uniquement lorsque le paramètre boundary_option est défini sur VALUE_FROM_FIELD.

Field
boundary_distance_unit
(Facultatif)

Spécifie l’unité linéaire à utiliser pour les valeurs de distance des limites.

  • KilometersLes kilomètres sont l’unité.
  • MetersLes mètres sont l’unité.
  • DecimetersLes décimètres sont l’unité.
  • CentimetersLes centimètres sont l’unité.
  • MillimetersLes millimètres sont l’unité.
  • Nautical MilesLes milles nautiques sont l’unité.
  • Statute MilesL’unité est le mille terrestre.
  • YardsLes yards sont l’unité.
  • FeetLes pieds sont l’unité.
  • InchesLes pouces sont l’unité.
  • DegreesLes degrés sont l’unité.
  • PointsLes points sont l’unité. Il s’agit de l’option par défaut.
String
in_barriers
[[barrier_layer, {barrier_distance}, {barrier_distance_field}, {barrier_distance_unit}],...]
(Facultatif)

Couches qui contiennent les entités ponctuelles, linéaires ou surfaciques qui constituent des interruptions en conflit avec les symboles ponctuels en entrée. Les symboles ponctuels en conflit avec les interruptions ne sont pas créés. La symbologie des couches d’interruptions est prise en compte.

  • barrier_layer : couche contenant des entités ponctuelles, linéaires ou surfaciques.
  • barrier_distance : valeur numérique spécifiant la distance minimale entre les symboles ponctuels et l’interruption. Ce paramètre est ignoré si la valeur barrier_distance_field est définie. La valeur par défaut est 0.
  • barrier_distance_field : champ numérique de la couche d’interruption utilisé comme distance d’interruption. Ce paramètre écrase la valeur barrier_distance. La valeur par défaut est <None>.
  • barrier_distance_unit : unité linéaire utilisée pour les valeurs de distance d’interruption. La valeur par défaut est Points.

Value Table
keep_at_least_one_marker
(Facultatif)

Spécifie si un seul symbole ponctuel est créé pour les polygones en entrée lorsque tous les symboles ponctuels sont en conflit avec les limites ou les interruptions.

  • KEEP_AT_LEAST_ONE_MARKERUn symbole ponctuel est créé pour les polygones en entrée lorsque tous les symboles ponctuels sont en conflit avec les limites ou les interruptions.
  • DO_NOT_KEEP_AT_LEAST_ONE_MARKERAucun symbole ponctuel n’est créé pour les polygones en entrée lorsque tous les symboles ponctuels sont en conflit avec les limites ou les interruptions. Il s’agit de l’option par défaut.
Boolean
displacement_method
(Facultatif)

Spécifie la méthode de déplacement utilisée pour déplacer les symboles ponctuels qui sont trop proches les uns des autres. Ce paramètre s’applique uniquement lorsque les symboles ponctuels sont positionnés de manière aléatoire à l’intérieur des polygones.

  • DO_NOT_DISPLACELes symboles ponctuels ne sont pas déplacés. Il s’agit de l’option par défaut.
  • DISPLACE_TOWARD_GRIDLes symboles ponctuels en conflit sont déplacés vers leur point de carroyage d’origine.
  • DISPLACE_APARTLes symboles ponctuels en conflit sont éloignés les uns des autres.
String
minimum_marker_distance
(Facultatif)

Distance minimale entre chaque symbole ponctuel. Ce paramètre s’applique uniquement lorsque les symboles ponctuels sont positionnés de manière aléatoire à l’intérieur des polygones. La valeur par défaut est 0.

Linear Unit

Exemple de code

Exemple 1 d’utilisation de l’outil ConvertMarkerPlacementToPoints (fenêtre Python)

Le script ci-dessous pour la fenêtre Python montre comment utiliser la fonction ConvertMarkerPlacementToPoints en mode immédiat.

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.env.referenceScale = 5000
arcpy.cartography.ConvertMarkerPlacementToPoints("parks.lyrx", "cartography.gdb/tree_markers")
Exemple 2 d’utilisation de l’outil ConvertMarkerPlacementToPoints (script autonome)

Ce script autonome montre un exemple d’utilisation de la fonction ConvertMarkerPlacementToPoints.

# Name: ConvertMarkerPlacementToPoints_standalone_script.py
# Description: Converts markers in a marker placement into point features.

# Import system modules
import arcpy
from arcpy import env

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

# Set local variables
in_layer = "parks.lyrx"
out_feature_class = "cartography.gdb/tree_markers"
create_multipoints = "CREATE_MULTIPOINTS"
boundary_option = "VALUE_FROM_FIELD"
boundary_distance = ""
boundary_distance_field = "distance"
boundary_distance_unit = "Points"
in_barriers = [["roads.lyrx", 1, "", "Points"],["rivers.lyrx", 0, "distance", "Points"]]
keep_at_least_one_marker = "KEEP_AT_LEAST_ONE_MARKER"
displacement_method = "DISPLACE_APART"
minimum_marker_distance = "2 Points"


arcpy.cartography.ConvertMarkerPlacementToPoints(in_layer,
                                                 out_feature_class,
                                                 create_multipoints,
                                                 boundary_option,
                                                 boundary_distance,
                                                 boundary_distance_field,
                                                 boundary_distance_unit,
                                                 in_barriers,
                                                 keep_at_least_one_marker,
                                                 displacement_method,
                                                 minimum_marker_distance
)

Informations de licence

  • Basic: Non
  • Standard: Non
  • Advanced: Oui

Rubriques connexes