Disponible con una licencia de Spatial Analyst.
Resumen
Crea una clase de entidad de línea de curvas de nivel (isolíneas) a partir de una superficie de ráster.
Uso
Las curvas de nivel no se extienden más allá de la extensión espacial del ráster y no se generan en áreas de NoData; por lo tanto, las entradas de las curvas de nivel adyacentes primero deberían ajustar sus bordes en un dataset de entidades continuo. Como alternativa del ajuste de bordes, puede fusionar los rásteres adyacentes antes de computar las curvas de nivel.
Las curvas de nivel se pueden generar en áreas de valores de ráster negativos. Los valores de las curvas de nivel serán negativos en dichas áreas. No se permiten los intervalos negativos de las curvas de nivel.
Se pueden obtener curvas de nivel más suaves pero menos precisas procesando previamente el ráster de entrada con una operación de Estadísticas focalizadas con la opción MEAN o con la herramienta Filtro con la opción LOW.
Una curva de nivel base se usa, por ejemplo, cuando desea crear curvas de nivel cada 15 metros, comenzando a los 10 metros. Aquí, 10 se utilizará para la curva de nivel base y 15 será el intervalo de las curvas de nivel. Los valores en los que se generará una curva de nivel serán 10, 25, 40, 55 y así sucesivamente.
Especificar una curva de nivel base no evita que las curvas de nivel se creen por encima o por debajo de ese valor.
Si la extensión de salida cambia a un valor distinto del predeterminado, puede producirse el remuestreo del ráster de entrada. Para evitar que esto ocurra y garantizar la coherencia de los resultados, establezca el entorno de Alinear ráster como el ráster de entrada.
Cuando el ráster de entrada se deba remuestrear, se utilizará la técnica Bilineal. Un ejemplo en el que se debe remuestrear un ráster de entrada se produce cuando el sistema de coordenadas de salida, la extensión o el tamaño de celda es diferente del de entrada.
Consulte Entornos de análisis y Spatial Analyst para obtener detalles adicionales sobre los entornos de geoprocesamiento válidos para esta herramienta.
Sintaxis
Contour (in_raster, out_polyline_features, contour_interval, {base_contour}, {z_factor})
Parámetro | Explicación | Tipo de datos |
in_raster |
Ráster de entrada de superficie. | Raster Layer |
out_polyline_features |
Las entidades de polilínea de la curva de nivel de salida. | Feature Class |
contour_interval | El intervalo o la distancia entre las líneas de curvas de nivel. Éste puede ser cualquier número positivo. | Double |
base_contour (Opcional) | El valor de la curva de nivel base. Las curvas de nivel se generan por encima y por debajo de este valor según se necesite cubrir el rango de valor completo del ráster de entrada. El valor predeterminado es cero. | Double |
z_factor (Opcional) | El factor de conversión de la unidad que se utiliza al generar curvas de nivel. El valor predeterminado es 1. Las líneas de curvas de nivel se generan con base en los valores z en el ráster de entrada, que a menudo se miden en unidades de metros o pies. Con el valor predeterminado de 1, las curvas de nivel estarán en las mismas unidades que los valores z del ráster de entrada. Para crear curvas de nivel en una unidad diferente a la de los valores z, establezca un valor adecuado para el factor z. Tenga en cuenta que para esta herramienta no es necesario que las unidades x, y de terreno y z de superficie concuerden. Por ejemplo, si los valores de elevación de su ráster de entrada están en pies, pero desea que las curvas de nivel sean generadas basándose en unidades en metros, ajuste el factor z en 0,3048 (puesto que 1 ft = 0,3048 m). En otro ejemplo, si tenemos un ráster de entrada en coordenadas geográficas WGS_84 y unidades de elevación de metros para el cual desea generar líneas de curvas de nivel cada 100 pies con una base de 50 pies (de manera que las curvas de nivel serán de 50 pies, 150 pies, 250 pies, y así sucesivamente). Para llevar a cabo esta operación, establezca el Intervalo de curvas de nivel en 100, la Curva de nivel base en 50 y el Factor Z en 3,2808 (ya que 1 m = 3,2808 pies). | Double |
Ejemplo de código
Ejemplo 1 de Curvas de nivel (ventana de Python)
En este ejemplo se crean curvas de nivel a partir de un ráster Esri Grid y se genera un shapefile como resultado.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
Contour("elevation", "C:/sapyexamples/output/outcontours.shp", 200, 0)
Ejemplo 2 de Curvas de nivel (secuencia de comandos independiente)
En este ejemplo se crean curvas de nivel a partir de un ráster Esri Grid y se genera un shapefile como resultado.
# Name: Contour_Ex_02.py
# Description: Creates contours or isolines from a raster surface.
# Requirements: Spatial Analyst Extension
# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *
# Set environment settings
env.workspace = "C:/sapyexamples/data"
# Set local variables
inRaster = "elevation"
contourInterval = 200
baseContour = 0
outContours = "C:/sapyexamples/output/outcontours02.shp"
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute Contour
Contour(inRaster, outContours, contourInterval, baseContour)
Entornos
- Auto ejecución
- Tamaño de celda
- Espacio de trabajo actual
- Valor Z de salida predeterminado
- Extensión
- Transformaciones geográficas
- Resolución M
- Tolerancia M
- Mantener el índice espacial
- Palabra clave CONFIG de salida
- Sistema de coordenadas de salida
- La salida tiene valores M
- La salida tiene valores Z
- Dominio M de salida
- Dominio XY de salida
- Dominio Z de salida
- Espacio de trabajo temporal
- Alinear ráster
- Resolución XY
- Tolerancia XY
- Resolución Z
- Tolerancia Z
Información sobre licencias
- ArcGIS for Desktop Basic: Requiere Spatial Analyst o 3D Analyst
- ArcGIS for Desktop Standard: Requiere Spatial Analyst o 3D Analyst
- ArcGIS for Desktop Advanced: Requiere Spatial Analyst o 3D Analyst