Convertir les étiquettes en graphiques (Outils de cartographie)

Résumé

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 Labeling (Étiquetage) dans ArcGIS Pro.
Le format de dénomination 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 Save To Layer File (Enregistrer dans un fichier de couche) pour enregistrer le groupe de couches en sortie dans un fichier de couche. Si 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 est 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.

Etiqueter	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 avec le paramètre Feature Layer (Couche d’entités).	String
Couche d’entités (Facultatif)	Couche contenant les étiquettes à convertir si 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 scène active. Draw Extent (Dessiner l’étendue) : l’étendue est basée sur un rectangle dessiné sur la carte ou dans la scène. Extent of a Layer (Étendue d’une couche) : l’étendue repose sur une couche de carte active. Choisissez une couche disponible ou utilisez l’option Étendue des données dans toutes les couches. Chaque couche de carte comporte les options suivantes : All Features (Toutes les entités) : étendue de toutes les entités. Selected Features (Entités sélectionnées) : étendue des entités sélectionnées. Visible Features (Entités visibles) : étendue des entités visibles. 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 d’intersection de toutes les entrées. Union of Inputs (Union des entrées) : l’étendue est basée sur l’étendue combinée de toutes les entrées. Clipboard (Presse-papiers) : l’étendue peut être copiée depuis et vers le Presse-papiers. Copy Extent (Copier l’étendue) : copie l’étendue et le système de coordonnées dans le Presse-papiers. Paste Extent (Coller l’étendue) : colle l’étendue et les coordonnées depuis le Presse-papiers. Si le Presse-papiers n’inclut pas de système de coordonnées, l’étendue utilise celui de la carte. Reset Extent (Réinitialiser l’étendue) : la valeur par défaut de l’étendue est rétablie. Lorsque les coordonnées sont saisies manuellement, elles doivent être des valeurs numériques incluses dans le système de coordonnées de la carte active. La carte peut utiliser des unités d’affichage différentes de celles des coordonnées saisies. 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écoché—Les étiquettes seront converties en couches de graphiques individuelles correspondant aux couches associées. 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. Activé—Les graphiques non placés sont stockés dans la couche de graphiques et leur visibilité est désactivée. Décoché—Des graphiques seront créés uniquement pour les entités étiquetées. Il s’agit de l’option par défaut.	Boolean
Couche en sortie (Facultatif)	Groupe de couches qui contiendra les graphiques générés. Dans la fenêtre Catalog (Catalogue), 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. Lors de l’utilisation d’ArcGIS Pro avec une carte 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

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 avec le paramètre `single_layer`.	String
single_layer (Facultatif)	Couche contenant les étiquettes à convertir si le paramètre `which_layers` contient la valeur `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. `Extent` object : 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. `GENERATE_UNPLACED`—Les graphiques non placés sont stockés dans la couche de graphiques et leur visibilité est désactivée. `ONLY_PLACED`—Des graphiques seront créés uniquement pour les entités étiquetées. Il s’agit de l’option par défaut.	Boolean
output_group_layer (Facultatif)	Groupe de couches qui contiendra les graphiques générés. 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.	Group Layer

Exemple de code

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

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