Convertir les étiquettes en graphiques (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 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.

Syntaxe

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

Paramètre	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 de 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