Resumen
Crea una anotación para las entidades de curvas de nivel.
La herramienta crea una clase de entidad de anotación con los polígonos de máscara correspondientes basados en las entidades de curvas de nivel de entrada.
Uso
La salida de esta herramienta es una capa de grupo. La capa de grupo contiene las entidades de curvas de nivel de entrada, la capa de anotación y los polígonos de máscara.
Una capa de grupo existente se sobrescribirá si se especifica el mismo nombre de capa y si especifica explícitamente que está permitida la sobreescritura de las salidas.
Cuando esté trabajando en ArcCatalog o ModelBuilder, puede usar la herramienta Guardar en archivo de capa para escribir la capa de grupo de salida en un archivo de capa. Cuando utiliza ArcMap, la herramienta agrega la capa de grupo a la visualización si la opción está seleccionada en las opciones de geoprocesamiento. La capa de grupo que se crea es temporal y, una vez finalizada la sesión, no permanece en el sistema a menos que se guarde el documento.
Las capas de grupo creadas en ArcCatalog no se pueden utilizar en ArcMap, a menos que se guarden en un archivo de capa usando la herramienta Guardar en archivo de capa.
Las clases de entidad de anotación no se sobrescriben si la herramienta se ejecuta varias veces en una misma clase de entidad de curvas de nivel. En este caso, se agrega un número a la clase de entidad de anotación (por ejemplo, ContourAnno, ContourAnno_1, etc.).
Cada máscara se creará con un margen de dos puntos alrededor de la entidad de anotación y un tipo de máscara de simplificado exacto, es decir, la máscara será un polígono generalizado que representa la forma exacta de la anotación.
Hay tres opciones para el color de la capa de curvas de nivel y la anotación de salida: negro, marrón y azul.
Las curvas de nivel creadas con la herramienta Curvas de nivel con barreras contienen un campo Tipo. El campo Tipo contiene uno o más de los siguientes valores:
1 for contours 2 for indexed contours 3 for explicit contours
El campo Tipo se puede utilizar como entrada para el parámetro Campo de tipo de curva de nivel. Se crea una clase de anotación separada para la anotación de cada tipo.
Sintaxis
ContourAnnotation_cartography (in_features, out_geodatabase, contour_label_field, reference_scale_value, out_layer, contour_color, {contour_type_field}, {contour_alignment}, {enable_laddering})
Parámetro | Explicación | Tipo de datos |
in_features | Clase de entidad de línea de curvas de nivel para la que se crea la anotación. | Feature Layer |
out_geodatabase | El espacio de trabajo donde se guardan las clases de entidad de salida. El espacio de trabajo puede ser una geodatabase o un dataset de entidades existente. | Workspace; Feature Dataset |
contour_label_field | Campo en la tabla de atributos de la capa de entrada en la que se basará el texto de anotación. | Field |
reference_scale_value | Introduzca la escala que se va a utilizar como una referencia para la anotación. Esto establece la escala en la que se basarán todos los tamaños de texto y símbolos en la anotación. | Double |
out_layer | La capa de grupo que contiene la capa de curvas de nivel, la anotación y la capa de máscara. Cuando esté trabajando en ArcCatalog, puede usar la herramienta Guardar en archivo de capa para escribir la capa de grupo de salida en un archivo de capa. Cuando utiliza ArcMap, la herramienta agrega la capa de grupo a la visualización si la opción está seleccionada en las opciones de geoprocesamiento. La capa de grupo que se crea es temporal y, una vez finalizada la sesión, no permanece en el sistema a menos que se guarde el documento. | Group Layer |
contour_color | Color de la capa de curvas de nivel de salida y de las entidades de anotación.
| String |
contour_type_field (Opcional) | Campo en la tabla de atributos de la capa de entrada que contiene un valor para el tipo de entidad de curvas de nivel. Se crea una clase de anotación para cada valor de tipo. | Field |
contour_alignment (Opcional) | La anotación se puede alinear a las elevaciones de las curvas de nivel, de manera que la parte superior del texto siempre quede ubicada hacia arriba. Esta opción permite colocar la anotación al revés. La anotación de curvas de nivel también se puede alinear a la página, lo que garantiza que el texto nunca pueda ubicarse al revés.
| String |
enable_laddering (Opcional) | Si ubica la anotación en forma escalonada, el texto se colocará de manera tal que parezca aumentar o disminuir las curvas de nivel de una ruta recta. Estas escaleras irán desde lo alto a lo más bajo de una colina, y no se cruzarán entre ellas, pertenecerán a una única pendiente y no atravesarán ninguna otra pendiente.
| Boolean |
Muestra de código
Ejemplo de ContourAnnotation (ventana de Python)
La siguiente secuencia de comandos independiente muestra cómo utilizar la función 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", "")
Ejemplo 2 de ContourAnnotation (secuencia de comandos del flujo de trabajo)
Esta muestra ejecuta el comando ContourWithBarriers y utiliza la salida de esa herramienta como entrada para la herramienta ContourAnnotation.
# Name: ContourAnnotation_Example2.py # Description: Create a contour with barriers feature class and then create annotation for the contours. # Requirements: 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 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)
Entornos
Información sobre licencias
- ArcGIS Desktop Basic: Sí
- ArcGIS Desktop Standard: Sí
- ArcGIS Desktop Advanced: Sí