Appliquer la symbologie d’une couche (Gestion des données)

Résumé

Applique la symbologie d’une couche ou d’un fichier de couche spécifique à l’entrée. Elle peut être appliquée à une entité, un raster, une analyse de réseau, un TIN et des couches géostatistiques.

Utilisation

  • La couche de symbologie doit correspondre au type de données de la couche en entrée. Par exemple, une couche d'entités ne peut pas s'appliquer à une couche raster et inversement.

  • La symbologie ne peut s'appliquer qu'aux entités de la même géométrie. Par exemple, une symbologie de points ne peut pas s'appliquer à une couche surfacique.

  • Les propriétés 3D, telles que l'extrusion et le décalage, ne sont pas prises en charge avec cet outil.

  • Si l’entrée est le chemin d’accès à une classe d’entités ou à un jeu de données, cet outil crée automatiquement une nouvelle couche en appliquant le résultat de l’outil.

  • Vous pouvez choisir de conserver ou de mettre à jour les plages de symbologie dans le paramètre Update Symbology Ranges by Data (Mettre à jour les plages de symbologie par données). Les méthodes de symbologie par défaut sont dynamiques. Par exemple, la méthode de classification par seuils naturels en cinq classes issue de la couche de symbologie est appliquée à la couche en entrée et les valeurs de plage sont mises à jour pour refléter les valeurs Shape_Area de la couche en entrée. Conserver les plages utilisera les mêmes valeurs que celles utilisées par la couche de symbologie. Mettre à jour créera la méthode de classification par seuils naturels en cinq classes à partir du champ Shape_Area des couches en entrée.

    Exemple d'utilisation de l'outil Appliquer la symbologie d'une couche

    Les méthodes suivantes sont dynamiques :

    • Symbologie par valeurs uniques sur une entité
      • Les valeurs uniques sont mises à jour pour refléter les valeurs de la couche en entrée.
      • Si vous ne voulez pas mettre à jour la classification par valeurs uniques, choisissez le symbole par défaut <all other values> (toutes autres valeurs) dans la couche de symbologie.
    • Symbologie par couleurs graduées sur une entité
      • Les valeurs de plage sont mises à jour selon les valeurs de la couche en entrée.
      • Si vous ne voulez pas mettre à jour la plage en sortie, optez pour la classification manuelle.
    • Rendu par valeurs classées sur un raster
      • Les valeurs de plage sont mises à jour pour refléter les valeurs de la couche en entrée.
      • Si vous ne voulez pas mettre à jour la plage en sortie, optez pour la classification manuelle.

  • Définir le paramètre Update Symbology Ranges by Data (Mettre à jour les plages de symbologie par données) sur Maintain ranges (Conserver les plages) aura pour effet de copier les étiquettes depuis la Symbology Layer (Couche de symbologie) vers la Input Layer (Couche en entrée). Si le paramètre est défini sur Update ranges (Mettre à jour les plages), les étiquettes seront recalculées.

Syntaxe

arcpy.management.ApplySymbologyFromLayer(in_layer, in_symbology_layer, {symbology_fields}, {update_symbology})
ParamètreExplicationType de données
in_layer

Couche à laquelle appliquer la symbologie.

Feature Layer; Raster Layer; Layer
in_symbology_layer

La symbologie de cette couche sera appliquée à la couche en entrée. Les fichiers .lyrx et .lyr sont tous deux pris en charge.

Layer
symbology_fields
[[field_type, source_field, target_field],...]
(Facultatif)

Champs de la couche en entrée qui correspondent aux champs de symbologie utilisés dans la couche de symbologie. Les champs de symbologie contiennent trois propriétés :

  • Type de champ : détermine le type de champ : valeur de la symbologie, normalisation ou autre type.
  • Champ source : le champ de symbologie utilisé par la couche de symbologie. Utilisez une valeur vide ou "#" si vous ne connaissez pas le champ source et souhaitez utiliser les valeurs par défaut.
  • Champ cible : le champ de la couche en entrée à utiliser lors de l'application de la symbologie.

Les types de champs pris en charge sont les suivants :

  • VALUE_FIELD : champ principal utilisé pour symboliser les valeurs.
  • NORMALIZATION_FIELD : champ utilisé pour normaliser les valeurs quantitatives.
  • EXCLUSION_CLAUSE_FIELD : champ utilisé pour la clause d’exclusion de symbologie.
  • CHART_RENDERER_PIE_SIZE_FIELD : champ utilisé pour définir la taille des symboles des diagrammes à secteurs.
  • ROTATION_XEXPRESSION_FIELD :champ utilisé pour définir la rotation des symboles sur l’axe des X.
  • ROTATION_YEXPRESSION_FIELD : champ utilisé pour définir la rotation des symboles sur l’axe des Y.
  • ROTATION_ZEXPRESSION_FIELD : champ utilisé pour définir la rotation des symboles sur l’axe des Z.
  • TRANSPARENCY_EXPRESSION_FIELD : champ utilisé pour définir la transparence des symboles.
  • TRANSPARENCY_NORMALIZATION_FIELD : champ utilisé pour normaliser les valeurs de transparence.
  • SIZE_EXPRESSION_FIELD : champ utilisé pour définir la taille ou la largeur des symboles.
  • COLOR_EXPRESSION_FIELD : champ utilisé pour définir la couleur des symboles.
  • PRIMITIVE_OVERRIDE_EXPRESSION_FIELD : champ utilisé pour définir diverses propriétés sur des couches de symboles individuelles.

Value Table
update_symbology
(Facultatif)

Précise si les plages de symbologie seront mises à jour.

  • DEFAULTLes plages de symbologie sont mises à jour, sauf dans les situations suivantes :
    • Lorsque la couche en entrée est vide.
    • Lorsque la couche de symbologie utilise des interruptions de classe (par exemple, couleurs graduées ou symboles gradués) et que la méthode de classification est manuelle ou à intervalle défini.
    • Lorsque la couche de symbologie utilise des valeurs uniques et que l’option Show all other values (Afficher toutes les autres valeurs) est activée.
  • UPDATELes plages de symbologie seront mises à jour.
  • MAINTAINLes plages de symbologie ne seront pas mises à jour ; elles seront préservées.
String

Sortie dérivée

NomExplicationType de données
out_layer

Couche en entrée mise à jour.

Couche

Exemple de code

Exemple 1 d'utilisation de la fonction ApplySymbologyFromLayer (fenêtre Python)

Le script de fenêtre Python ci-dessous illustre l'utilisation de la fonction ApplySymbologyFromLayer en mode immédiat.

import arcpy
arcpy.env.workspace = "C:/data.gdb"
arcpy.ApplySymbologyFromLayer_management("sf_points", "sf_points_water.lyrx")
Exemple 2 d'utilisation de la fonctionApplySymbologyFromLayer (script autonome)

Le script autonome ci-dessous illustre l’utilisation de la fonction ApplySymbologyFromLayer dans un script autonome.

# Import system modules
import arcpy
# Set the current workspace
arcpy.env.workspace = "C:/data.gdb"
# Set layer to apply symbology to
inputLayer = "sf_points"
# Set layer that output symbology will be based on
symbologyLayer = "water_symbols_pnt.lyrx"
# Apply the symbology from the symbology layer to the input layer
arcpy.ApplySymbologyFromLayer_management(inputLayer, symbologyLayer)
Exemple 3 d'utilisation de la fonction ApplySymbologyFromLayer (script autonome)

Le script autonome ci-dessous illustre l’utilisation de la fonction ApplySymbologyFromLayer dans un script autonome.

# Import system modules
import arcpy
# Set the current workspace
arcpy.env.workspace = "C:/data.gdb"
# Set layer to apply symbology to
inputLayer = "InlandEmpireBlocks"
# Set layer that output symbology will be based on
symbologyLayer = "USCensusBlocks.lyrx"
# The symbology layer is symbolized by population normalized by area.
# Symbolize the input by Pop2014 field normalized to Square Miles
symbologyFields = [["VALUE_FIELD", "#", "Pop2014"], 
                   ["NORMALIZATION_FIELD", "#", "SQ_MILES"]]
# Apply the symbology from the symbology layer to the input layer
arcpy.ApplySymbologyFromLayer_management(inputLayer, symbologyLayer, 
                                         symbologyFields)

Informations de licence

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

Rubriques connexes