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.
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
Un anillo o vecindad en forma de donut definido 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 interno máximo son 2.046 celdas y el radio externo máximo son 2.047 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 para la anchura o la altura es 1 celda y el valor máximo son 4.096 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 ó 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 para la anchura o la altura del kernel es 1 celda y el valor máximo son 4.096 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 subsiguientes indican cómo se procesará el valor de entrada que se corresponde con la 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.
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:
NbrAnnulus({innerRadius}, {outerRadius}, {units})
Un anillo o vecindad en forma de donut definido 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 interno máximo son 2.046 celdas y el radio externo máximo son 2.047 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 para la anchura o la altura es 1 celda y el valor máximo son 4.096 celdas. El valor predeterminado es un cuadrado con un ancho y una altura de 3 celdas.
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 ó 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 para la anchura o la altura del kernel es 1 celda y el valor máximo son 4.096 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 subsiguientes indican cómo se procesará el valor de entrada que se corresponde con la 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
TopographicPositionIndex ejemplo 1 (ventana de Python)
Este ejemplo calcula los valores de TPI mediante una vecindad de anillo alrededor de cada celda del raster de entrada.