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

ÉtiquetteExplicationType 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 carteLes étiquettes seront converties en graphiques pour toutes les couches de la carte. Il s’agit de l’option par défaut.
  • Couche uniqueLes é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.

  • Default (Par défaut) : l’étendue repose sur l’étendue maximale de toutes les entrées participantes. Il s’agit de l’option par défaut.
  • Union of Inputs (Union des entrées) : l’étendue est basée sur l’étendue maximale de toutes les entrées.
  • Intersection of inputs (Intersection des entrées) : l’étendue est basée sur la surface minimale commune à toutes les entrées.
  • Current Display Extent (Étendue d’affichage actuelle) : l’étendue correspond à l’affichage visible. Cette option n’est pas disponible lorsque aucune carte n’est active.
  • As Specified Below (Comme spécifié ci-dessous) : l’étendue est basée sur les valeurs d’étendue minimale et maximale indiquées.
  • Browse (Parcourir) : l’étendue repose sur un jeu de données existant.
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

arcpy.cartography.ConvertLabelsToGraphics(input_map, conversion_scale, {which_layers}, {single_layer}, {graphics_suffix}, {extent}, {multiple_graphics_layers}, {generate_unplaced}, {output_group_layer})
NomExplicationType 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_LAYERSLes étiquettes seront converties en graphiques pour toutes les couches de la carte. Il s’agit de l’option par défaut.
  • SINGLE_LAYERLes é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_LAYERLes étiquettes de toutes les couches seront converties en une couche de graphiques unique.
  • GRAPHICS_LAYER_PER_FEATURE_LAYERLes é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_PLACEDDes graphiques seront créés uniquement pour les entités étiquetées. Il s’agit de l’option par défaut.
  • GENERATE_UNPLACEDLes 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

Rubriques connexes