Annotation de contour (Cartographie)

Niveau de licence :BasicStandardAdvanced

Récapitulatif

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

Syntaxe

ContourAnnotation_cartography (in_features, out_geodatabase, contour_label_field, reference_scale_value, out_layer, contour_color, {contour_type_field}, {contour_alignment}, {enable_laddering})
ParamètreExplicationType 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

Saisissez l'échelle de référence à utiliser 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 couche pour enregistrer le groupe de couches en sortie dans un fichier de couche. 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

Couleur de la couche d'isolignes en sortie et entités annotations.

  • BLACKLa couche d'isolignes en sortie et les entités annotations apparaissent en noir. Il s'agit de l'option par défaut.
  • BROWNLa couche d'isolignes en sortie et les entités annotations apparaissent en marron.
  • BLUELa 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)

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.

  • 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.
  • UPHILLL'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.
String
enable_laddering
(Facultatif)

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.

  • ENABLE_LADDERINGL'annotation montera et descendra d'une isoligne à l'autre en ligne droite.
  • NOT_ENABLE_LADDERINGL'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

Exemple de code

Exemple d'utilisation de l'outil ContourAnnotation (fenêtre Python)

Le script autonome suivant montre comment utiliser la fonction ContourAnnotation.

import arcpy
from arcpy import env
env.workspace = "C:/data/data.gdb"
arcpy.ContourAnnotation_cartography("Contours", "C:/data/data.gdb", "Contour", 50000, "ContourGroupLayer", "BLACK", 
"", "PAGE", "")
Example2 de l'outil ContourAnnotation (script de workflow)

Cet exemple exécute la commande ContourWithBarriers et utilise la sortie de cet outil comme entrée pour l'outil ContourAnnotation.

# Name: ContourAnnotation_Example2.py
# Description: Create a contour with barriers feature class and then create annotation for the contours.
# Requirements: Extension ArcGIS Spatial Analyst 


# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *

# Set environment settings
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 Extension ArcGIS Spatial Analyst 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

Thèmes connexes

Informations de licence

ArcGIS for Desktop Basic: Oui
ArcGIS for Desktop Standard: Oui
ArcGIS for Desktop Advanced: Oui
6/5/2014