Índice de posición topográfica (Spatial Analyst)

Disponible con una licencia de Spatial Analyst.

Resumen

Calcula el valor del índice de posición topográfica para cada celda dentro de una vecindad especificada.

Más información sobre cómo funciona el índice de posición topográfica

Uso

• El ráster de salida de esta herramienta contiene los valores de índice de posición topográfica (TPI) de cada celda. El valor de TPI es la diferencia entre el valor de celda actual y la elevación media de todas las celdas de su vecindario.

• Las formas de vecindad disponibles son anillo (un donut o anillo), círculo, rectángulo y cuña. Se puede definir una forma de vecindad personalizada utilizando un archivo kernel.

• Cuando se especifica una vecindad circular, con forma de anillo o con forma de porción de círculo, es probable que para el cálculo no se tengan en cuenta algunas celdas diagonales externas porque la vecindad debe abarcar el centro de la celda.

• El tipo de vecindad irregular requiere que se especifique un valor de archivo kernel. Un archivo kernel es un archivo de texto ASCII que especifica los valores y la forma de la vecindad. El archivo se puede crear con cualquier editor de texto sin formato. El archivo debe tener una extensión .txt y no contener espacios en el nombre del archivo.

• Cuando el formato de ráster de salida es .crf, esta herramienta admite el entorno de almacenamiento ráster Pirámide. De forma predeterminada, se crearán pirámides en la salida. Para cualquier otro formato de salida, este entorno no es compatible y no se crearán pirámides.

• Consulte Entornos de análisis y Spatial Analyst para obtener detalles adicionales sobre los entornos de geoprocesamiento que se aplican a esta herramienta.

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Ráster de superficie de entrada	Ráster de entrada de superficie.	Raster Layer
Vecindario (Opcional)	Celdas alrededor de una celda de procesamiento que se utilizarán en el cálculo de TPI. Hay varios tipos de vecindad predefinidos para elegir, o se puede definir un kernel personalizado. Una vez que se haya seleccionado el tipo de vecindad, se pueden establecer los demás parámetros para definir completamente la forma, el tamaño y las unidades de medida. La vecindad predeterminada tiene un anillo con radio interno de una celda y un radio externo de tres celdas. A continuación se detallan las formas de los tipos de vecindad disponibles: Anillo, Radio interno, Radio externo, Tipo de unidades Una vecindad con forma de donut o anillo definida por un radio interno y un radio externo. El valor mínimo para el radio es 1 celda, y el radio exterior debe ser mayor que el interior. El radio interior máximo es de 2046 celdas, y el radio exterior máximo es de 2047 celdas. El anillo predeterminado tiene un radio interior de 1 celda y un radio exterior de 3 celdas. Círculo, Radio, Tipo de unidades Una vecindad circular con un radio determinado. El valor mínimo para el radio es 1 celda y el valor máximo es 2047 celdas. El radio predeterminado es de 3 celdas. Rectángulo, Altura, Ancho, Tipo de unidades Una vecindad rectangular definida por el ancho y la altura. El valor mínimo de ancho o alto es 1 celda, y el valor máximo es 4096 celdas. El valor predeterminado es un cuadrado con un ancho y una altura de 3 celdas. Porción de círculo, Radio, Ángulo de inicio, Ángulo de finalización, Tipo de unidades Una vecindad en forma de cuña definida por un radio, un ángulo de inicio y un ángulo de finalización. El valor mínimo para el radio es 1 celda y el valor máximo es 2047 celdas. La cuña se extiende en el sentido contrario a las agujas del reloj desde el ángulo de inicio al ángulo de finalización. Los ángulos se especifican en grados, donde 0 o 360 representan el este. Se pueden utilizar ángulos negativos. La cuña predeterminada es de 0 a 90 grados, con un radio de 3 celdas. Irregular, Archivo kernel Una vecindad personalizada con especificaciones establecidas por el archivo de texto kernel identificado. El valor mínimo de ancho o alto del kernel es 1 celda, y el valor máximo es 4096 celdas. Para los tipos de vecindades de anillo, círculo, rectángulo y porción de círculo, las unidades de distancia para los parámetros pueden especificarse en unidades de Celda o unidades de Mapa. Las unidades de celda son las predeterminadas. Para el tipo de vecindad irregular, la primera línea del archivo kernel define el ancho y la altura de la vecindad en números de celdas. Las líneas siguientes indican cómo se procesará el valor de entrada que se corresponde con esa ubicación en el kernel. Un valor de 0 en el archivo del núcleo indica que la ubicación correspondiente no se incluirá en el cálculo. Un valor de 1 en el archivo del núcleo indica que la celda de entrada correspondiente se incluirá en la operación.	Neighborhood

Valor de retorno

Etiqueta	Explicación	Tipo de datos
Ráster de salida	Ráster de índice de posición topográfica de salida.	Raster

Python

TopographicPositionIndex(in_raster, {neighborhood})

Nombre	Explicación	Tipo de datos
in_raster	Ráster de entrada de superficie.	Raster Layer
neighborhood (Opcional)	Celdas alrededor de una celda de procesamiento que se utilizarán en el cálculo de TPI. Hay varios tipos de vecindad predefinidos para elegir, o se puede definir un kernel personalizado. Una vez que se haya seleccionado el tipo de vecindad, se pueden establecer los demás parámetros para definir completamente la forma, el tamaño y las unidades de medida. La vecindad predeterminada tiene un anillo con radio interno de una celda y un radio externo de tres celdas. La forma de las vecindades está definida por la clase Neighborhood. Los tipos de vecindad disponibles son NbrAnnulus, NbrCircle, NbrRectangle, NbrWedge y NbrIrregular. A continuación se detallan las formas de los tipos de vecindad disponibles: NbrAnnulus({innerRadius}, {outerRadius}, {units}) Una vecindad con forma de donut o anillo definida por un radio interno y un radio externo. El valor mínimo para el radio es 1 celda, y el radio exterior debe ser mayor que el interior. El radio interior máximo es de 2046 celdas, y el radio exterior máximo es de 2047 celdas. El anillo predeterminado tiene un radio interior de 1 celda y un radio exterior de 3 celdas. NbrCircle({radius}, {units} Una vecindad circular con un radio determinado. El valor mínimo para el radio es 1 celda y el valor máximo es 2047 celdas. El radio predeterminado es de 3 celdas. NbrRectangle({width}, {height}, {units}) Una vecindad rectangular definida por el ancho y la altura. El valor mínimo de ancho o alto es 1 celda, y el valor máximo es 4096 celdas. El valor predeterminado es un cuadrado con un ancho y una altura de 3 celdas. NbrWedge({radius}, {startAngle}, {endAngle}, {units}) Una vecindad en forma de cuña definida por un radio, un ángulo de inicio y un ángulo de finalización. El valor mínimo para el radio es 1 celda y el valor máximo es 2047 celdas. La cuña se extiende en el sentido contrario a las agujas del reloj desde el ángulo de inicio al ángulo de finalización. Los ángulos se especifican en grados, donde 0 o 360 representan el este. Se pueden utilizar ángulos negativos. La cuña predeterminada es de 0 a 90 grados, con un radio de 3 celdas. NbrIrregular(inKernelFile) Una vecindad personalizada con especificaciones establecidas por el archivo de texto kernel identificado. El valor mínimo de ancho o alto del kernel es 1 celda, y el valor máximo es 4096 celdas. Para el tipo de vecindad irregular, la primera línea del archivo kernel define el ancho y la altura de la vecindad en números de celdas. Las líneas siguientes indican cómo se procesará el valor de entrada que se corresponde con esa ubicación en el kernel. Un valor de 0 en el archivo del núcleo indica que la ubicación correspondiente no se incluirá en el cálculo. Un valor de 1 en el archivo del núcleo indica que la celda de entrada correspondiente se incluirá en la operación.	Neighborhood

Valor de retorno

Nombre	Explicación	Tipo de datos
out_raster	Ráster de índice de posición topográfica de salida.	Raster

Muestra de código

Ejemplo 1 de TopographicPositionIndex (ventana de Python)

En este ejemplo se calcula el valor que ocurre con menor frecuencia en una vecindad con forma de anillo alrededor de cada celda del ráster de entrada.

from arcpy.sa import *
outTPI = TopographicPositionIndex("elevation.tif", "Annulus 1 3 CELL")
outTPI.save("C:/sapyexamples/output/tpiout01.tif")

Ejemplo 2 de TopographicPositionIndex (secuencia de comandos independiente)

En este ejemplo se determina el valor que ocurre con menor frecuencia en una vecindad de 10 por 10 alrededor de cada celda en el ráster de entrada.

# Name: TopographicPositionIndex_standalone.py
# Description: Calculates the TPI.
# Requirements: Spatial Analyst Extension

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

# Set environment settings
arcpy.env.workspace = "C:/sapyexamples/data"

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Set local variables
inRaster = "elevation.tif"
inNeighborhood = "Circle 90 Map"

# Execute the tool
outTPI = TopographicPositionIndex(inRaster, inNeighborhood)

# Save the output 
outTPI.save("C:/sapyexamples/output/tpiout02.tif")

Entornos

Auto ejecución, Tamaño de celda, Método de proyección de tamaño de celda, Compresión, Espacio de trabajo actual, Extensión, Transformaciones geográficas, Máscara, Palabra clave CONFIG de salida, Sistema de coordenadas de salida, Espacio de trabajo temporal, Alinear ráster, Tamaño de tesela

Información de licenciamiento

• Basic: Requiere Spatial Analyst
• Standard: Requiere Spatial Analyst
• Advanced: Requiere Spatial Analyst