Apparier la symbologie d’une couche à un style (Gestion des données)

Synthèse

Créé une symbologie de valeurs uniques pour la couche en entrée basée sur l’expression ou le champ en entrée en appariant des chaînes d’expression ou de champ en entrée à des noms de symbole provenant du style en entrée.

Utilisation

• La symbologie de valeurs uniques est créée pour la couche en entrée. Si la couche se trouve dans la carte actuelle, elle est mise à jour. Sinon, la couche symbolisée est ajoutée à la carte. Quelle que soit la situation, la symbologie de la couche existante est remplacée.

• Les classes de symboles de valeurs uniques sont créées par le paramètre Match Values (Field or Expression) [Apparier les valeurs (Champ ou Expression)] et symbolisées par un symbole transmis par le paramètre Style en entrée dont le nom correspond à la valeur du champ ou à la valeur de l’expression résultante. Lorsque l'outil apparie des valeurs d’un même champ et que ce champ est un champ de sous-type ou possède un domaine de valeurs précodées, les symboles sont appariés à la description du sous-type ou domaine.

• Les couches d’entités ponctuelles et multi-ponctuelles sont appariées aux symboles ponctuels du style. Les couches d’entités polylinéaires sont appariées aux symboles linéaires. Les couches d’entités surfaciques sont appariées aux symboles surfaciques. Les couches d’entités multipatch sont appariées aux symboles de maillage.

• En l’absence d’appariement, la classe de symbole est dessinée avec le symbole par défaut pour toutes les autres valeurs.

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Couche en entrée	Couche en entrée ou fichier de couche auquel les symboles appariés s’appliquent en tant que classes de symboles de valeurs uniques. La couche en entrée contient une symbologie ponctuelle, linéaire, surfacique, multi-point ou multipatch. La symbologie existante sur la couche est remplacée.	Feature Layer
Apparier les valeurs (Champ ou Expression)	Champ ou expression sur lequel/laquelle la couche en entrée est symbolisée. Les valeurs de champs ou les valeurs d’expressions finales sont appariées aux noms de symboles dans le style spécifié pour affecter des symboles aux classes de symboles obtenues.	Calculator Expression
Style	Style contenant les symboles dont le nom correspond aux valeurs de champs ou d’expressions.	String

Sortie obtenue

Étiquette	Explication	Type de données
Couche en sortie	Couche symbolisée mise à jour.	Couche d’entités

Python

arcpy.management.MatchLayerSymbologyToAStyle(in_layer, match_values, in_style)

Nom	Explication	Type de données
in_layer	Couche en entrée ou fichier de couche auquel les symboles appariés s’appliquent en tant que classes de symboles de valeurs uniques. La couche en entrée contient une symbologie ponctuelle, linéaire, surfacique, multi-point ou multipatch. La symbologie existante sur la couche est remplacée.	Feature Layer
match_values	Champ ou expression sur lequel/laquelle la couche en entrée est symbolisée. Les valeurs de champs ou les valeurs d’expressions finales sont appariées aux noms de symboles dans le style spécifié pour affecter des symboles aux classes de symboles obtenues.	Calculator Expression
in_style	Style contenant les symboles dont le nom correspond aux valeurs de champs ou d’expressions.	String

Sortie obtenue

Nom	Explication	Type de données
out_layer	Couche symbolisée mise à jour.	Couche d’entités

Exemple de code

Exemple d’utilisation de l’outil MatchLayerSymbologyToAStyle (fenêtre Python)

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

import arcpy
arcpy.management.MatchLayerSymbologyToAStyle("Streets", "$feature.RoadClass", 
                                             r"C:\RoadClasses.stylx")

Environnements

Cet outil n’utilise pas d’environnement de géotraitement.