Résumé
Crée une annotation pour les entités isolignes.
L'outil crée une classe d'entités annotations avec les polygones de masquage correspondants selon les entités isolignes en entrée.
Utilisation
Les isolignes sont étiquetées à l’aide du style Placement de type isoligne et de la position Centrée droite dans Moteur d’étiquetage Maplex.
La sortie de cet outil est un groupe de couches. Le groupe de couches contient les entités isolignes en entrée, la couche d'annotation et les polygones de masquage.
Un groupe de couches existant sera remplacé si le même nom de couche est spécifié et si vous autorisez de manière explicite le remplacement de sorties.
Dans ArcCatalog ou ModelBuilder, vous pouvez utiliser l’outil Enregistrer dans un fichier de couches pour enregistrer le groupe de couches en sortie dans un fichier de couches. Lorsque vous utilisez ArcMap, l’outil ajoute le groupe de couches à l’affichage, si cette option est activée dans les options de géotraitement. Le groupe de couches créé est temporaire et disparaîtra à la fin de la session si le document n'est pas enregistré.
Les groupes de couches créés dans ArcCatalog ne peuvent pas être utilisés dans ArcMap à moins de les enregistrer dans un fichier de couche à l’aide de l’outil Enregistrer dans un fichier de couche.
Les classes d’entités annotations ne sont pas remplacées si l’outil est exécuté plusieurs fois sur une seule classe d’entités isolignes. Dans ce cas, un nombre sera ajouté au nom de la classe d’entités annotations (par exemple, ContourAnno, ContourAnno_1, et ainsi de suite).
Chaque masque est créé avec une marge de deux points autour de l'entité annotation et un type de masque EXACT_SIMPLIFIED, signifiant que le masque sera un polygone généralisé représentant la forme exacte de l'annotation.
Trois couleurs sont possibles pour la couleur de la couche d'isolignes et l'annotation en sortie : noir, marron et bleu.
Les isolignes créées à l’aide de l’outil Créer des isolignes avec interruptions contiennent un champ Type. Le champ Type contient une ou plusieurs des valeurs suivantes :
- 1—Isolignes
- 2—Isolignes indexées
- 3—Isolignes explicites
Ce champ Type peut être utilisé comme entrée pour le paramètre Champ de type de courbe de niveau. Une classe d'annotations distincte est créée pour les annotations de chaque type.
Syntaxe
arcpy.cartography.ContourAnnotation(in_features, out_geodatabase, contour_label_field, reference_scale_value, out_layer, contour_color, {contour_type_field}, {contour_alignment}, {enable_laddering})| Paramètre | Explication | Type de données |
in_features | Classe d'entités isolignes pour laquelle l'annotation est créée. | Feature Layer |
out_geodatabase | Espace de travail dans lequel les classes d'entités en sortie sont enregistrées. L'espace de travail peut être une géodatabase existante ou un jeu de données d'entité existant. | Workspace; Feature Dataset |
contour_label_field | Champ dans la table attributaire de la couche en entrée sur laquelle le texte d’annotation est basé. | Field |
reference_scale_value | Échelle qui sera utilisée comme référence pour l’annotation. Ce paramètre définit l’échelle à laquelle se rapportent toutes les tailles et symboles du texte des annotations. | Double |
out_layer | Groupe de couches qui contient la couche d’isolignes, l’annotation et la couche de masque. Dans ArcCatalog, vous pouvez utiliser l’outil Enregistrer dans un fichier de couches pour enregistrer le groupe de couches en sortie dans un fichier de couches. Lorsque vous utilisez ArcMap, l’outil ajoute le groupe de couches à l’affichage, si cette option est activée dans les options de géotraitement. Le groupe de couches créé est temporaire et disparaîtra à la fin de la session si le document n'est pas enregistré. | Group Layer |
contour_color | Spécifie la couleur de la couche d’isolignes en sortie et des entités annotations.
| String |
contour_type_field (Facultatif) | Champ dans la table attributaire de la couche en entrée contenant une valeur pour le type d’entité isoligne. Une classe d'annotations est créée pour chaque valeur de type. | Field |
contour_alignment (Facultatif) | Spécifie comment l’annotation sera alignée par rapport aux altitudes d’isoligne. L’annotation peut suivre les altitudes d’isoligne, afin que le haut du texte soit toujours placé vers le haut. Cette option permet de placer l’annotation à l’envers. L'annotation d'isoligne peut également suivre le sens de la page pour que le texte ne soit jamais placé à l'envers.
| String |
enable_laddering (Facultatif) | Spécifie si l’annotation est placée en échelles. Lorsqu’une annotation est placée en échelles, le texte semble monter et descendre d’une isoligne à l’autre en ligne droite. Ces échelles courent du sommet d'une colline vers le bas, ne se croisent pas, appartiennent à une seule pente et ne traversent pas d'autre pente.
| Boolean |
Sortie dérivée
| Nom | Explication | Type de données |
| out_geodatabase2 | Espace de travail d’enregistrement des classes d’entités en sortie. | Workspace; Feature Dataset |
Exemple de code
Exemple d’utilisation de l’outil ContourAnnotation (fenêtre Python)
Le script autonome ci-dessous illustre l’utilisation de la fonction ContourAnnotation.
import arcpy
arcpy.env.workspace = "C:/data/data.gdb"
arcpy.ContourAnnotation_cartography("Contours", "C:/data/data.gdb", "Contour",
50000, "ContourGroupLayer", "BLACK", "",
"PAGE")
Exemple 2 d’utilisation de l’outil ContourAnnotation (script autonome)
Cet exemple exécute la fonction ContourWithBarriers et utilise la sortie de cet outil comme entrée pour la fonction ContourAnnotation.
# Description: Create a contour with barriers feature class and then create
# annotation for the contours.
# Requirements: ArcGIS Spatial Analyst extension
# Import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = "C:/data/data.gdb"
# Set local variables
inRaster = "elevation"
inBarrier = "ridges"
inTextFile = ""
explicitValues = "NO_EXPLICIT_VALUES_ONLY"
contourInterval = 200
indexInterval = 1000
contourList = [1500, 3000]
baseContour = 0
outContours = "C:/data/data.gdb/outcontourwithbarriers"
# Check out the ArcGIS ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute ContourWithBarriers
arcpy.sa.ContourWithBarriers(inRaster, outContours, inBarrier, "POLYLINES",
inTextFile, explicitValues, baseContour,
contourInterval, indexInterval, contourList)
# Set local variables
inFeatures = "C:/data/data.gdb/outcontourwithbarriers"
inWorkspace = "C:/data/data.gdb"
LabelField = "Contour"
RefScaleValue = 50000
outLayer = "Contours"
Color = "BROWN"
TypeField = "Type"
Alignment = "PAGE"
Laddering = "NOT_ENABLE_LADDERING"
# Execute ContourAnnotation
arcpy.ContourAnnotation_cartography(inFeatures, inWorkspace, LabelField,
RefScaleValue, outLayer, Color, TypeField,
Alignment, Laddering)
Environnements
Informations de licence
- Basic: Oui
- Standard: Oui
- Advanced: Oui