Anotación de curva de nivel (Cartografía)

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

• Las curvas de nivel se etiquetan con el estilo Ubicación de curvas de nivel y la posición de ubicación Centrado recto en Motor de etiquetado Maplex.

  Más información sobre cómo etiquetar curvas de nivel

• 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 el panel Catálogo o ModelBuilder, puede usar la herramienta Guardar en archivo de capa para escribir la capa de grupo de salida en un archivo de capa.

• Las clases de entidad de anotación no se sobrescribirán si la herramienta se ejecuta varias veces en una única clase de entidad de curvas de nivel. En este caso, se agregará un número al nombre de 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 de color para la capa de curva de nivel y anotación de salida: negro, marrón y azul.

• Las curvas de nivel se han creado con la herramienta Curvas de nivel con barreras con un campo Type. El campo Type contiene uno o varios de los siguientes valores:

  • 1—Curvas de nivel
  • 2—Curvas de nivel indexadas
  • 3—Curvas de nivel explícitas

  Este campo Type se puede utilizar como entrada del parámetro Campo de tipo de curva de nivel. Se crea una clase de anotación separada para la anotación de cada tipo.

• Esta herramienta respeta el entorno Longitud del campo de cadena de texto de anotación. Cuando esté establecido, invalidará la longitud de campo predeterminada en el campo TextString de cualquier clase de entidad de anotación creada en una base de datos.

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Entidades de entrada	La clase de entidad de línea de curvas de nivel para la que se creará la anotación.	Feature Layer
Geodatabase de salida	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
Campo de etiqueta de curva de nivel	Campo de la tabla de atributos de la capa de entrada en la que se basará el texto de anotación.	Field
Escala de referencia	La escala que se usará como referencia para la anotación. Establece la escala en la que se basarán todos los tamaños de texto y símbolos de la anotación.	Double
Nombre de capa de salida	La capa de grupo que contendrá la capa de curva de nivel, la anotación y la capa de máscara. Cuando esté trabajando en el panel Catálogo, puede usar la herramienta Guardar en archivo de capas para escribir la capa de grupo de salida en un archivo de capas. Al utilizar ArcGIS Pro, la herramienta agrega la capa de grupo a la pantalla si la opción Agregar datasets de salida a un mapa abierto está activada en la pestaña Geoprocesamiento o el cuadro de diálogo Opciones. 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
Color de curva de nivel y etiqueta	Especifica el color de la capa de curvas de nivel de salida y de las entidades de anotación. Negro—La capa de curva de nivel de salida y entidades de anotación se dibujarán en negro. Esta es la opción predeterminada. Marrón—La capa de curvas de nivel de salida y las entidades de anotación se dibujarán en marrón Azul—La capa de curvas de nivel de salida y las entidades de anotación se dibujarán en azul.	String
Campo de tipo de curva de nivel (Opcional)	El campo de la tabla de atributos de capa de entrada que contiene un valor para el tipo de entidad de curva de nivel. Se crea una clase de anotación para cada valor de tipo.	Field
Alineación de curva de nivel (Opcional)	Especifica cómo se alineará la anotación con las elevaciones de la curva de nivel. La anotación se puede alinear con las elevaciones de curva de nivel para que la parte superior del texto siempre se sitúe hacia arriba o hacia abajo. Estas opciones permiten 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. Alinear parte superior del texto con parte superior de la página—La anotación se alineará con la página, lo que garantiza que el texto no esté nunca del revés. Esta es la opción predeterminada. Alinear parte superior del texto hacia arriba—La anotación se alineará con las elevaciones de curva de nivel para que la parte superior del texto siempre se sitúe hacia arriba. Esta opción permite que la anotación se coloque del revés. Alinear parte superior del texto hacia abajo—La anotación se alineará con las elevaciones de curva de nivel para que la parte superior del texto siempre se sitúe hacia abajo. Esta opción permite que la anotación se coloque del revés.	String
Habilitar escalas (Opcional)	Especifica si la anotación se situará en escaleras. Colocar anotaciones de forma escalonada ubicará el texto de forma que parezcan escalones en 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. Activado: la anotación aumenta o disminuye las curvas de nivel de una ruta recta. Desactivado: la anotación no se colocará de forma escalonada en las curvas de nivel de una ruta recta. Esta es la opción predeterminada.	Boolean

Salida derivada

Etiqueta	Explicación	Tipo de datos
Espacio de trabajo de salida	El espacio de trabajo donde se guardan las clases de entidad de salida.	Workspace; Feature Dataset

Python

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

Nombre	Explicación	Tipo de datos
in_features	La clase de entidad de línea de curvas de nivel para la que se creará 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 de la tabla de atributos de la capa de entrada en la que se basará el texto de anotación.	Field
reference_scale_value	La escala que se usará como referencia para la anotación. Establece la escala en la que se basarán todos los tamaños de texto y símbolos de la anotación.	Double
out_layer	La capa de grupo que contendrá la capa de curva de nivel, la anotación y la capa de máscara. Cuando esté trabajando en el panel Catálogo, puede usar la herramienta Guardar en archivo de capas para escribir la capa de grupo de salida en un archivo de capas. Al utilizar ArcGIS Pro, la herramienta agrega la capa de grupo a la pantalla si la opción Agregar datasets de salida a un mapa abierto está activada en la pestaña Geoprocesamiento o el cuadro de diálogo Opciones. 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	Especifica el color de la capa de curvas de nivel de salida y de las entidades de anotación. BLACK—La capa de curva de nivel de salida y entidades de anotación se dibujarán en negro. Esta es la opción predeterminada. BROWN—La capa de curvas de nivel de salida y las entidades de anotación se dibujarán en marrón BLUE—La capa de curvas de nivel de salida y las entidades de anotación se dibujarán en azul.	String
contour_type_field (Opcional)	El campo de la tabla de atributos de capa de entrada que contiene un valor para el tipo de entidad de curva de nivel. Se crea una clase de anotación para cada valor de tipo.	Field
contour_alignment (Opcional)	Especifica cómo se alineará la anotación con las elevaciones de la curva de nivel. La anotación se puede alinear con las elevaciones de curva de nivel para que la parte superior del texto siempre se sitúe hacia arriba o hacia abajo. Estas opciones permiten 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. PAGE—La anotación se alineará con la página, lo que garantiza que el texto no esté nunca del revés. Esta es la opción predeterminada. UPHILL—La anotación se alineará con las elevaciones de curva de nivel para que la parte superior del texto siempre se sitúe hacia arriba. Esta opción permite que la anotación se coloque del revés. DOWNHILL—La anotación se alineará con las elevaciones de curva de nivel para que la parte superior del texto siempre se sitúe hacia abajo. Esta opción permite que la anotación se coloque del revés.	String
enable_laddering (Opcional)	Especifica si la anotación se situará en escaleras. Colocar anotaciones de forma escalonada ubicará el texto de forma que parezcan escalones en 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. ENABLE_LADDERING—La anotación aumenta o disminuye las curvas de nivel de una ruta recta. NOT_ENABLE_LADDERING—La anotación no se colocará de forma escalonada en las curvas de nivel de una ruta recta. Esta es la opción predeterminada.	Boolean

Salida derivada

Nombre	Explicación	Tipo de datos
out_geodatabase2	El espacio de trabajo donde se guardan las clases de entidad de salida.	Workspace; Feature Dataset

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
arcpy.env.workspace = "C:/data/data.gdb"
arcpy.ContourAnnotation_cartography("Contours", "C:/data/data.gdb", "Contour", 
                                    50000, "ContourGroupLayer", "BLACK", "", 
                                    "PAGE")

Ejemplo 2 de ContourAnnotation (script independiente)

Esta muestra ejecuta la función ContourWithBarriers y utiliza la salida de esa herramienta como entrada de la función 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)

Entornos

Escala de referencia, Sistema de coordenadas de salida, Longitud del campo TextString de anotación

Información de licenciamiento

• Basic: Sí
• Standard: Sí
• Advanced: Sí