Annotations de courbes de niveau (Outils de cartographie)

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 Contour placement (Placement de type isoligne) et de la position Centered straight (Centrée droite) dans le Moteur d’étiquetage Maplex.

En savoir plus sur l’étiquetage des isolignes
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 la fenêtre Catalog (Catalogue) ou dans ModelBuilder, 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.
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 est 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 Contour With Barriers (Créer des isolignes avec interruptions) contiennent un champ Type. Le champ Type contient une ou plusieurs des valeurs suivantes :
- 1—Isolignes
- 2—Indexed contours (Isolignes indexées)
- 3—Explicit contours (Isolignes explicites)
Ce champ Type peut être utilisé comme entrée du paramètre Contour Type Field (Champ de type de courbe de niveau). Une classe d'annotations distincte est créée pour les annotations de chaque type.
Cet outil respecte l’environnement Annotation Text String Field Length (Longueur du champ de chaîne de texte d’annotation). Lorsqu’il est défini, il remplace la longueur du champ définie par défaut dans le champ TextString dans n’importe quelle classe d’entités annotations créée dans une base de données.

Etiqueter	Explication	Type de données
Input Features (Entités en entrée)	Classe d'entités isolignes pour laquelle l'annotation est créée.	Feature Layer
Géodatabase en sortie	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
Champ d’étiquetage de courbes de niveau	Champ dans la table attributaire de la couche en entrée sur laquelle le texte d’annotation est basé.	Field
Echelle de référence	É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
Nom de la couche en sortie	Groupe de couches qui contient la couche d’isolignes, l’annotation et la couche de masque. Dans la fenêtre Catalog (Catalogue), 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. Avec ArcGIS Pro, l’outil ajoute le groupe de couches à l’affichage si l’option Add output datasets to an open map (Ajouter des jeux de données en sortie à une carte ouverte) est sélectionnée dans l’onglet Geoprocessing (Géotraitement) de la boîte de dialogue Options. Le groupe de couches créé est temporaire et disparaîtra à la fin de la session si le document n'est pas enregistré.	Group Layer
Couleur de courbe de niveau et d’étiquette	Spécifie la couleur de la couche d’isolignes en sortie et des entités annotations. Noir—La couche d’isolignes en sortie et les entités annotations apparaissent en noir. Il s’agit de l’option par défaut. Marron—La couche d'isolignes en sortie et les entités annotations apparaissent en marron. Bleu—La couche d'isolignes en sortie et les entités annotations apparaissent en bleu.	String
Champ de type de courbe de niveau (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
Alignement par rapport à la courbe de niveau (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 ou vers le bas. Ces options permettent 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. Aligner le haut du texte sur le haut de la page—L’annotation suit le sens de la page pour que le texte ne soit jamais placé à l’envers. Il s’agit de l’option par défaut. Aligner le haut du texte vers le haut—L’annotation suit les altitudes d’isoligne pour que le haut du texte soit toujours placé vers le haut. Cette option permet de placer l’annotation à l’envers. Aligner le haut du texte vers le bas—L’annotation suit les altitudes d’isoligne pour que le haut du texte soit toujours placé vers le bas. Cette option permet de placer l’annotation à l’envers.	String
Activer les échelles (Facultatif)	Spécifie si l’annotation est placée en échelles. Si une annotation est placée en échelles, le texte semble monter et descendre d’une isoligne à une 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. Activé—L'annotation montera et descendra d'une isoligne à l'autre en ligne droite. Décoché—L’annotation ne sera pas placée en montant et en descendant d’une isoligne à l’autre en ligne droite. Il s’agit de l’option par défaut.	Boolean

Sortie dérivée

Etiqueter	Explication	Type de données
Espace de travail en sortie	Espace de travail d’enregistrement des classes d’entités en sortie.	Workspace; Feature Dataset

arcpy.cartography.ContourAnnotation(in_features, out_geodatabase, contour_label_field, reference_scale_value, out_layer, contour_color, {contour_type_field}, {contour_alignment}, {enable_laddering})

Nom	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 la fenêtre Catalog (Catalogue), 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. Avec ArcGIS Pro, l’outil ajoute le groupe de couches à l’affichage si l’option Add output datasets to an open map (Ajouter des jeux de données en sortie à une carte ouverte) est sélectionnée dans l’onglet Geoprocessing (Géotraitement) de la boîte de dialogue Options. 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. `BLACK`—La couche d’isolignes en sortie et les entités annotations apparaissent en noir. Il s’agit de l’option par défaut. `BROWN`—La couche d'isolignes en sortie et les entités annotations apparaissent en marron. `BLUE`—La couche d'isolignes en sortie et les entités annotations apparaissent en bleu.	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 ou vers le bas. Ces options permettent 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. `PAGE`—L’annotation suit le sens de la page pour que le texte ne soit jamais placé à l’envers. Il s’agit de l’option par défaut. `UPHILL`—L’annotation suit les altitudes d’isoligne pour que le haut du texte soit toujours placé vers le haut. Cette option permet de placer l’annotation à l’envers. `DOWNHILL`—L’annotation suit les altitudes d’isoligne pour que le haut du texte soit toujours placé vers le bas. Cette option permet de placer l’annotation à l’envers.	String
enable_laddering (Facultatif)	Spécifie si l’annotation est placée en échelles. Si une annotation est placée en échelles, le texte semble monter et descendre d’une isoligne à une 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. `ENABLE_LADDERING`—L'annotation montera et descendra d'une isoligne à l'autre en ligne droite. `NOT_ENABLE_LADDERING`—L’annotation ne sera pas placée en montant et en descendant d’une isoligne à l’autre en ligne droite. Il s’agit de l’option par défaut.	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 1 d’utilisation de l’outil ContourAnnotation (fenêtre Python)

Le script autonome ci-après illustre l’utilisation de la fonction ContourAnnotation.

import arcpy
arcpy.env.workspace = "C:/data/data.gdb"
arcpy.cartography.ContourAnnotation("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 de 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"

# Run 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"

# Run ContourAnnotation
arcpy.cartography.ContourAnnotation(inFeatures, inWorkspace, LabelField,
                                    RefScaleValue, outLayer, Color, TypeField,
                                    Alignment, Laddering)

Environnements

Echelle de référence, Système de coordonnées en sortie, Longueur de champ de la chaîne de texte d’annotation

Informations de licence

Basic: Oui
Standard: Oui
Advanced: Oui

Annotations de courbes de niveau (Outils de cartographie)

Résumé

Utilisation

Paramètres

Sortie dérivée

Environnements

Informations de licence

Rubriques connexes