Convertir les étiquettes en graphiques (Cartographie)

Synthèse

Convertit les étiquettes en graphiques pour une seule couche ou pour toute une carte.

Utilisation

• Les étiquettes peuvent être converties en graphiques pour une seule couche ou pour toute la carte. Si l’option de couche unique est choisie, la couche doit être spécifiée et se trouver sur la carte.

• Les plages d'échelle des classes d'étiquettes sont respectées. Lorsque l’outil génère des graphiques pour une échelle de carte spécifique, il ne convertit que les classes d’étiquettes activées et visibles à cette échelle.

  Remarque :

  Les plages d’échelle des classes d’étiquettes sont définies dans l’onglet Etiquetage dans ArcGIS Pro.

• Le format du nom des couches de graphiques est <layer name><graphics layer suffix>.

  Les noms de couche de graphiques en double ne sont pas écrasés.

• Une sortie de cet outil est un groupe de couches. Vous pouvez utiliser l’outil Enregistrer dans un fichier de couche pour enregistrer le groupe de couches en sortie dans un fichier de couche. Lorsque l’outil est utilisé dans ArcGIS Pro, il ajoute le groupe de couches à l’affichage. Le groupe de couches créé est temporaire et disparaîtra à la fin de la session si le projet n'est pas enregistré.

• Tout groupe de couches existant sera remplacé si le même nom de couche est spécifié et que l’option Allow geoprocessing tools to overwrite existing datasets (Autoriser les outils de géotraitement à remplacer les jeux de données existants) est sélectionnée dans les options de géotraitement.

• Le paramètre Convert labels from all layers to a single output graphics layer (Convertir les étiquettes de toutes les couches en une seule couche de graphiques en sortie) peut être utilisé pour créer une couche de graphiques unique pour toute la carte.

• Si l’espace est insuffisant, certaines étiquettes peuvent ne pas s’afficher sur la carte. Cochez la case Convert unplaced labels to graphics (Convertir les étiquettes non placées en graphiques) pour enregistrer les étiquettes non placées dans la couche de graphiques, ce qui permet de les afficher et de les positionner ultérieurement.

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Carte en entrée	Nom de la carte en entrée.	Map
Echelle de conversion	Echelle à laquelle il convient de convertir les étiquettes. Si une échelle de référence est définie sur la carte, elle est utilisée pour le dimensionnement des symboles et la création des couches de graphiques, mais la conversion s’effectue à cette échelle.	Double
Convertir (Facultatif)	Spécifie si les graphiques doivent être convertis pour toutes les couches de la carte ou pour une seule couche. Toutes les couches de la carte—Les étiquettes seront converties en graphiques pour toutes les couches de la carte. Il s’agit de l’option par défaut. Couche unique—Les étiquettes seront converties en graphiques pour une couche unique. Cette couche doit être spécifiée dans le paramètre Feature Layer (Couche d’entités) (single_layer dans Python).	String
Couche d’entités (Facultatif)	Couche contenant les étiquettes à convertir lorsque le paramètre Convert (Convertir) est défini sur Single layer (Couche unique). Cette couche doit se trouver sur la carte.	Feature Layer
Suffixe de la couche de graphiques (Facultatif)	Suffixe qui sera ajouté à chaque nouvelle couche de graphiques. Ce suffixe sera ajouté au nom de la classe d’entités source pour chaque nouvelle couche de graphiques.	String
Etendue (Facultatif)	Spécifie l’étendue qui contient les étiquettes à convertir en graphiques. Current Display Extent (Étendue actuellement affichée)  : l’étendue repose sur la carte ou la scène active. Cette option est uniquement disponible lorsqu’une carte est active. Dessiner l’étendue  : l’étendue est basée sur un rectangle dessiné sur la carte ou dans la scène. Cette option crée une classe d’entités dans la géodatabase du projet et ajoute une couche à la carte. La classe d’entités possède le même système de coordonnées que la carte. Remarque : Cette option n’est pas disponible dans la boîte de dialogue Environnements. Elle est disponible uniquement dans un paramètre de l’outil correspondant à un type de données d’étendue ou dans l’onglet Environnements de la boîte de dialogue de l’outil. Remarque : Lorsque l’option de mise à jour Activer et désactiver la mise à jour de l’onglet Mettre à jour est activée, vous devez activer la mise à jour dans l’onglet du ruban Mettre à jour pour dessiner l’étendue. Extent of a Layer (Étendue d’une couche)  : l’étendue repose sur une couche de carte active. Utilisez la liste déroulante pour choisir une couche disponible ou utilisez l’option Extent of data in all layers (Étendue des données dans toutes les couches) pour obtenir l’étendue combinée de toutes les couches de carte actives, y compris le fond de carte. Cette option est uniquement disponible lorsqu’une carte avec des couches est active. Chaque couche de carte comporte les options suivantes : Toutes les entités  : étendue de toutes les entités dans la couche. Entités sélectionnées : étendue de toutes les entités sélectionnées dans la couche. Entités visibles  : étendue de toutes les entités visibles dans la couche. Remarque : Les étendues des options Entités sélectionnées  et Entités visibles  sont disponibles uniquement pour les couches d’entités. Browse (Parcourir)  : l’étendue repose sur un jeu de données existant. Intersection of Inputs (Intersection des entrées)  : l’étendue repose sur l’étendue minimale ou l’étendue d’intersection de toutes les entrées. S’il n’existe aucune intersection entre les entrées, il en résulte une étendue nulle avec uniquement des zéros. Union of Inputs (Union des entrées)  : l’étendue est basée sur l’étendue maximale ou combinée de toutes les entrées. Presse-papiers  : l’étendue peut être copiée depuis et vers le Presse-papiers. Copier l’étendue  : copie les coordonnées et le système de coordonnées de l’étendue dans le Presse-papiers. Coller l’étendue  : colle les coordonnées et, éventuellement, le système de coordonnées de l’étendue depuis le Presse-papiers. Si les valeurs du Presse-papiers n’incluent pas de système de coordonnées, l’étendue utilise celui de la carte. Remarque : Les coordonnées de l’étendue sont copiées vers et collées depuis le Presse-Papiers avec la même mise en forme et le même ordre que ceux de l’objet ArcPy Extent : X min, Y min, X max, Y max et la référence spatiale. Reset Extent (Réinitialiser l’étendue)  : la valeur par défaut de l’étendue est rétablie. Manually entered coordinates (Coordonnées saisies manuellement) : les coordonnées doivent être des valeurs numériques incluses dans le système de coordonnées de la carte active. Attention : La carte peut utiliser des unités d’affichage différentes de celles des coordonnées saisies. L’utilisation d’une direction cardinale (N, S, E, O) n’est pas prise en charge. Utilisez le signe moins pour les coordonnées sud et ouest.	Extent
Convertir les étiquettes de toutes les couches en une seule couche de graphiques en sortie (Facultatif)	Spécifie si les étiquettes seront converties en couches de graphiques individuelles ou en une couche de graphiques unique. Activé : les étiquettes de toutes les couches seront converties en une couche de graphiques unique. Désactivé : les étiquettes seront converties en couches de graphiques individuelles correspondant à leurs couches. Il s’agit de l’option par défaut.	Boolean
Convertir les étiquettes non placées en graphiques (Facultatif)	Spécifie si des graphiques seront créés à partir des étiquettes non placées. Désactivé : des graphiques seront créés uniquement pour les entités étiquetées. Il s’agit de l’option par défaut. Activé : les graphiques non placés sont stockés dans la couche de graphiques et leur visibilité est désactivée.	Boolean
Couche en sortie (Facultatif)	Groupe de couches qui contiendra les graphiques générés. Dans Catalog, vous pouvez utiliser l'outil Save To Layer File (Enregistrer dans un fichier de couche) pour enregistrer le groupe de couches en sortie dans un fichier de couche. Lorsque vous utilisez ArcGIS Pro quand une carte est ouverte, l’outil ajoute le groupe de couches à l’affichage si l’option Add output dataset to an open map (Ajouter un jeu de données en sortie à une carte ouverte) est sélectionnée dans les options de géotraitement. Le groupe de couches créé est temporaire et disparaîtra à la fin de la session si le projet n'est pas enregistré.	Group Layer

Python

arcpy.cartography.ConvertLabelsToGraphics(input_map, conversion_scale, {which_layers}, {single_layer}, {graphics_suffix}, {extent}, {multiple_graphics_layers}, {generate_unplaced}, {output_group_layer})

Nom	Explication	Type de données
input_map	Objet de carte en entrée.	Map
conversion_scale	Echelle à laquelle il convient de convertir les étiquettes. Si une échelle de référence est définie sur la carte, elle est utilisée pour le dimensionnement des symboles et la création des couches de graphiques, mais la conversion s’effectue à cette échelle.	Double
which_layers (Facultatif)	Spécifie si les graphiques doivent être convertis pour toutes les couches de la carte ou pour une seule couche. ALL_LAYERS—Les étiquettes seront converties en graphiques pour toutes les couches de la carte. Il s’agit de l’option par défaut. SINGLE_LAYER—Les étiquettes seront converties en graphiques pour une couche unique. Cette couche doit être spécifiée dans le paramètre Feature Layer (Couche d’entités) (single_layer dans Python).	String
single_layer (Facultatif)	Couche contenant les étiquettes à convertir lorsque le paramètre which_layers est défini sur SINGLE_LAYER. Cette couche doit se trouver sur la carte.	Feature Layer
graphics_suffix (Facultatif)	Suffixe qui sera ajouté à chaque nouvelle couche de graphiques. Ce suffixe sera ajouté au nom de la classe d’entités source pour chaque nouvelle couche de graphiques.	String
extent (Facultatif)	Spécifie l’étendue qui contient les étiquettes à convertir en graphiques. MAXOF : l’étendue maximale de toutes les entrées est utilisée. MINOF : l’étendue minimale commune à toutes les entrées est utilisée. DISPLAY : l’étendue est égale à l’affichage visible. Nom de la couche : l’étendue de la couche spécifiée est utilisée. Objet Extent : l’étendue de l’objet spécifié est utilisée. Chaîne délimitée par des espaces de coordonnées géographiques : l’étendue de la chaîne spécifiée est utilisée. Les coordonnées sont exprimées dans l’ordre x-min, y-min, x-max, y-max.	Extent
multiple_graphics_layers (Facultatif)	Spécifie si les étiquettes seront converties en couches de graphiques individuelles ou en une couche de graphiques unique. SINGLE_GRAPHICS_LAYER—Les étiquettes de toutes les couches seront converties en une couche de graphiques unique. GRAPHICS_LAYER_PER_FEATURE_LAYER—Les étiquettes seront converties en couches de graphiques individuelles correspondant aux couches associées. Il s’agit de l’option par défaut.	Boolean
generate_unplaced (Facultatif)	Spécifie si des graphiques seront créés à partir des étiquettes non placées. ONLY_PLACED—Des graphiques seront créés uniquement pour les entités étiquetées. Il s’agit de l’option par défaut. GENERATE_UNPLACED—Les graphiques non placés sont stockés dans la couche de graphiques et leur visibilité est désactivée.	Boolean
output_group_layer (Facultatif)	Groupe de couches qui contiendra les graphiques générés. Vous pouvez utiliser l'outil Enregistrer dans un fichier de couche pour enregistrer le groupe de couches en sortie dans un fichier de couche.	Group Layer

Exemple de code

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

Exemple Python pour la fonction ConvertLabelsToGraphics qui convertit les étiquettes en graphiques pour une seule couche de la carte.

import arcpy
arcpy.cartography.ConvertLabelsToGraphics(
    'Map1', 10000, 'SINGLE_LAYER', 'Schools', 'Graphics', 'MAXOF', 
    'GRAPHICS_LAYER_PER_FEATURE_LAYER', 'ONLY_PLACED', 'GroupGraphics')

Exemple 2 d’utilisation de l’outil ConvertLabelsToGraphics (script autonome)

Script autonome qui convertit les étiquettes en graphiques pour la carte à l’aide de la fonction ConvertLabelsToGraphics.

# Name: ConvertLabelsToGraphics.py
# Description: Find all the maps in the project and
#              convert labels to graphics for each map
# import system modules
import arcpy
# Loop through the project, find all the maps, and
#   convert labels to graphics for each map,
#   using the name of the map as part of the graphics layer suffix 
project = arcpy.mp.ArcGISProject("D:\\data\\myproject.aprx")
for mp in project.listMaps():
    print("Converting labels to graphics for: " + mp.name)
    arcpy.cartography.ConvertLabelsToGraphics(
            mp, 10000, 'ALL_LAYERS', '', 'Graphics_' + mp.name, 'MAXOF', 
            'GRAPHICS_LAYER_PER_FEATURE_LAYER', 'ONLY_PLACED',  
            'GraphicsLayers_' + mp.name)

Environnements

Cet outil n’utilise pas d’environnement de géotraitement.

Informations de licence

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