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 la symbologie dans le paramètre Update Symbology Ranges by Data (Mettre à jour les plages de symbologie par données) ou d’utiliser la valeur par défaut. Par défaut, les méthodes de symbologie peuvent être dynamiques. Par exemple, la symbologie est mise à jour pour refléter les caractéristiques de la couche en entrée comme cela est illustré ci-dessous. 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.

  

  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.

• Toutes les classes d’étiquettes sont copiées de Symbology Layer (Couche de symbologie) vers Input Layer (Couche en entrée) peu importe la valeur du paramètre Update Symbology Ranges by Data (Mettre à jour les plages de symbologie par données).

Syntaxe

ApplySymbologyFromLayer(in_layer, in_symbology_layer, {symbology_fields}, {update_symbology})

Paramètre	Explication	Type 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 x. ROTATION_YEXPRESSION_FIELD : champ utilisé pour définir la rotation des symboles sur l’axe y. ROTATION_ZEXPRESSION_FIELD : champ utilisé pour définir la rotation des symboles sur l’axe 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. DEFAULT —Les 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. UPDATE —Les plages de symbologie seront mises à jour. MAINTAIN —Les plages de symbologie ne seront pas mises à jour ; elles seront préservées.	String

Sortie dérivée

Nom	Explication	Type 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 suivant illustre l'utilisation de la fonction ApplySymbologyFromLayer dans les scripts.

# 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 suivant illustre l'utilisation de la fonction ApplySymbologyFromLayer dans les scripts.

# 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)

Environnements

Validation automatique, Espace de travail courant

Informations de licence

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