Diferencia de superficie multiescala (Herramientas de Spatial Analyst)

Resumen

Calcula la diferencia máxima respecto a la elevación media en todo un rango de escalas espaciales.

Más información sobre cómo funciona Diferencia de superficie multiescala

Uso

La diferencia máxima con respecto a la elevación media se calcula en todas las escalas. Estas escalas son el valor de distancia de vecindad utilizado para el cálculo (la distancia desde el centro de la celda objetivo, creando un cuadrado de celdas alrededor de la celda objetivo). Por ejemplo, una escala de dos celdas es un vecindario de 5 por 5 celdas.
Para cada escala se halla la elevación media y la diferencia entre el valor de la celda central y la elevación media de esa escala. La diferencia se conserva para compararla con valores de escalas diferentes.
El valor del parámetro Ráster de superficie de entrada (in_raster en Python) puede ser cualquier tipo de ráster de superficie.
El parámetro Ráster de diferencia de salida (out_difference_raster en Python) es la salida principal. Se trata de un ráster que contiene la diferencia máxima respecto a la elevación media en un rango de escalas espaciales.
El parámetro Ráster de escala de salida (out_scale_raster en Python) proporciona más información sobre la salida principal. Contiene la escala en la que se ha encontrado la máxima diferencia con respecto a la elevación media para cada celda. La escala es el valor de la distancia de la vecindad, que es la distancia desde el centro de la celda objetivo, creando un cuadrado de celdas alrededor de la celda objetivo.
Las opciones de unidades imperiales para el parámetro Unidades de distancia (distance_units en Python) son las versiones internacionales de las unidades. Las unidades imperiales de agrimensura de EE. UU. no de admiten actualmente. Si la unidad de mapa de la referencia espacial para el valor de Ráster de superficie de entrada es una unidad de agrimensura de EE. UU., Celdas será el valor predeterminado utilizado para este parámetro.
Los parámetros Distancia mínima de vecindad (min_scale en Python) y Distancia máxima de vecindad (max_scale en Python) definen los tamaños mínimo y máximo de la vecindad, o escalas, para los que se calculará la diferencia. Estos valores representan la menor y la mayor distancia a la célula objetivo. Por ejemplo, un valor de 1 crea una vecindad de 3 por 3 celdas, y un valor de 2 crea una vecindad de 5 por 5 celdas.

Estos valores no pueden ser inferiores al tamaño de celda ráster de entrada ni a 1 celda.

El valor del parámetro Distancia mínima de vecindad debe ser menor o igual que el valor del parámetro Distancia máxima de vecindad.
El Incremento de distancia (increment en Python) es el incremento en la distancia de vecindad entre escalas.

El valor de este parámetro no puede ser inferior al tamaño de celda del ráster de entrada o a 1 celda. El valor predeterminado es el tamaño de la celda ráster de entrada.
Las celdas NoData del valor Ráster de superficie de entrada se ignorarán y se les asignará NoData en los valores de los parámetros Ráster de diferencia de entrada y Ráster de escala de salida.
Esta herramienta se puede agilizar mediante una GPU, lo que significa que si en el sistema hay disponible una unidad de procesamiento de gráficos (GPU), se utilizará para mejorar el rendimiento de la herramienta. Utilice el parámetro Dispositivo objetivo para el análisis (analysis_target_device en Python) para controlar si la GPU o la CPU se utilizarán para ejecutar la herramienta.

Consulte Procesamiento de GPU con Spatial Analyst para obtener más información sobre GPU compatibles, configurar y trabajar con dispositivos GPU, así como sugerencias de solución de problemas.
Esta herramienta admite el procesamiento en paralelo. Si su equipo tiene varios procesadores o procesadores con varios núcleos, puede conseguir un mayor rendimiento, especialmente en los datasets mayores. El tema de ayuda Procesamiento en paralelo con Spatial Analyst incluye más detalles sobre esta posibilidad y cómo configurarla.

De forma predeterminada, esta herramienta usará el 50 por ciento de los núcleos disponibles. Es posible controlar el número de núcleos empleados por la herramienta, a través de la configuración de entorno de Factor de procesamiento en paralelo.
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 válidos para esta herramienta.

Etiqueta	Explicación	Tipo de datos
Ráster de superficie de entrada	Ráster de entrada de superficie.	Raster Layer
Ráster de escala de salida (Opcional)	Ráster de salida que contiene la escala en la que se encontró la diferencia más extrema para cada celda. Las escalas se representan como sus valores de distancia de vecindad. Será de tipo punto flotante.	Raster Dataset
Unidades de distancia (Opcional)	Especifica la unidad de distancia que se utilizará para los parámetros Distancia mínima de vecindad, Distancia máxima de vecindad e Incremento de distancia. La distancia se medirá en el número de celdas o unidad especificada. El valor predeterminado es la unidad de mapa de la referencia espacial para el valor de Ráster de superficie de entrada. Celdas—La unidad de distancia será celdas. Metros—La unidad de distancia será metros. Centímetros—La unidad de distancia será centímetros. Kilómetros—La unidad de distancia será kilómetros. Pulgadas—La unidad de distancia será la pulgada internacional. Pies—La unidad de distancia será el pie internacional. Yarda—La unidad de distancia será la yarda internacional. Millas—La unidad de distancia será la milla internacional.	String
Distancia de vecindad mínima (Opcional)	Distancia que define la escala mínima de vecindad para la que se calculará la diferencia de elevación. Esta es la distancia desde el centro de la celda objetivo, creando un cuadrado de celdas alrededor de la celda objetivo. Este valor debe ser menor o igual que el valor del parámetro Distancia máxima de vecindad y mayor o igual que el tamaño de celda ráster de entrada o una celda. El valor predeterminado es cuatro veces el tamaño de celda del valor del parámetro Ráster de superficie de entrada, lo que da como resultado una vecindad de 9 por 9 celdas.	Double
Distancia de vecindad máxima (Opcional)	Distancia que define la escala máxima de vecindad para la que se calculará la diferencia de elevación. Esta es la distancia desde el centro de la celda objetivo, creando un cuadrado de celdas alrededor de la celda objetivo. Este valor debe ser mayor o igual que el valor del parámetro Distancia mínima de vecindad y el tamaño de celda ráster de entrada o una celda. El valor predeterminado es 13 veces el tamaño de celda del valor del parámetro Ráster de superficie de entrada, lo que da como resultado una vecindad de 27 por 27 celdas.	Double
Incremento de distancia (Opcional)	Incremento en la distancia de vecindad entre escalas. El valor de este parámetro no puede ser inferior al tamaño de celda de Ráster de superficie de entrada o a 1 celda. El valor predeterminado es el tamaño de la celda del valor del parámetro Ráster de superficie de entrada.	Double
Dispositivo objetivo para el análisis (Opcional)	Especifica el dispositivo que se utilizará para realizar el cálculo. GPU, luego, CPU—Si se encuentra una GPU compatible, se utilizará para realizar el cálculo; de lo contrario, se utilizará la CPU. Esta es la opción predeterminada. Solo CPU—El cálculo solo se realizará en la CPU. Solo GPU—El cálculo solo se realizará en la GPU.	String

Valor de retorno

Etiqueta	Explicación	Tipo de datos
Ráster de diferencia de salida	Ráster que contiene la diferencia máxima respecto a la elevación media para cada celda. Será de tipo punto flotante.	Raster

Etiqueta

Explicación

Tipo de datos

Ráster de diferencia de salida

Ráster que contiene la diferencia máxima respecto a la elevación media para cada celda.

Será de tipo punto flotante.

Raster

MultiscaleSurfaceDifference(in_raster, {out_scale_raster}, {distance_units}, {min_scale}, {max_scale}, {increment}, {analysis_target_device})

Nombre	Explicación	Tipo de datos
in_raster	Ráster de entrada de superficie.	Raster Layer
out_scale_raster (Opcional)	Ráster de salida que contiene la escala en la que se encontró la diferencia más extrema para cada celda. Las escalas se representan como sus valores de distancia de vecindad. Será de tipo punto flotante.	Raster Dataset
distance_units (Opcional)	Especifica la unidad de distancia que se utilizará para los parámetros `min_scale`, `max_scale` y `increment`. La distancia se medirá en el número de celdas o unidad especificada. El valor predeterminado es la unidad de mapa de la referencia espacial para el valor de `in_raster`. `CELLS`—La unidad de distancia será celdas. `METERS`—La unidad de distancia será metros. `CENTIMETERS`—La unidad de distancia será centímetros. `KILOMETERS`—La unidad de distancia será kilómetros. `INCHES`—La unidad de distancia será la pulgada internacional. `FEET`—La unidad de distancia será el pie internacional. `YARDS`—La unidad de distancia será la yarda internacional. `MILES`—La unidad de distancia será la milla internacional.	String
min_scale (Opcional)	Distancia que define la escala mínima de vecindad para la que se calculará la diferencia de elevación. Esta es la distancia desde el centro de la celda objetivo, creando un cuadrado de celdas alrededor de la celda objetivo. Este valor debe ser menor o igual que el valor del parámetro `max_scale` y mayor o igual que el tamaño de celda ráster de entrada o una celda. El valor predeterminado es cuatro veces el tamaño de celda del valor del parámetro `in_raster`, lo que da como resultado una vecindad de 9 por 9 celdas.	Double
max_scale (Opcional)	Distancia que define la escala máxima de vecindad para la que se calculará la diferencia de elevación. Esta es la distancia desde el centro de la celda objetivo, creando un cuadrado de celdas alrededor de la celda objetivo. Este valor debe ser mayor o igual que el valor del parámetro `min_scale` y el tamaño de celda ráster de entrada o una celda. El valor predeterminado es 13 veces el tamaño de celda del valor del parámetro `in_raster`, lo que da como resultado una vecindad de 27 por 27 celdas.	Double
increment (Opcional)	Incremento en la distancia de vecindad entre escalas. El valor de este parámetro no puede ser inferior al tamaño de celda de `in_raster` o a 1 celda. El valor predeterminado es el tamaño de celda del valor del parámetro `in_raster`.	Double
analysis_target_device (Opcional)	Especifica el dispositivo que se utilizará para realizar el cálculo. `GPU_THEN_CPU`—Si se encuentra una GPU compatible, se utilizará para realizar el cálculo; de lo contrario, se utilizará la CPU. Esta es la opción predeterminada. `CPU_ONLY`—El cálculo solo se realizará en la CPU. `GPU_ONLY`—El cálculo solo se realizará en la GPU.	String

Valor de retorno

Nombre	Explicación	Tipo de datos
out_difference_raster	Ráster que contiene la diferencia máxima respecto a la elevación media para cada celda. Será de tipo punto flotante.	Raster

Nombre

Explicación

Tipo de datos

out_difference_raster

Ráster que contiene la diferencia máxima respecto a la elevación media para cada celda.

Será de tipo punto flotante.

Raster

Muestra de código

MultiscaleSurfaceDifference ejemplo 1 (ventana de Python)

En el siguiente ejemplo se muestra cómo usar esta herramienta en la ventana de Python.

Este ejemplo genera el ráster de salida de diferencia a partir de un ráster de superficie de entrada utilizando los valores predeterminados para todos los parámetros opcionales.

from arcpy.sa import *
outMaxDifferences = MultiscaleSurfaceDifference("elevation.tif", "", "", "", "", "", "")
outMaxDifferences.save("C:/sapyexamples/output/outmaxdifferencs01.tif")

MultiscaleSurfaceDifference ejemplo 2 (script independiente)

En el siguiente ejemplo se muestra cómo usar esta herramienta en una secuencia de comandos independiente de Python.

Este ejemplo genera un ráster de diferencias para escalas que van desde 10 m hasta 100 m con incrementos de 1 m entre cada escala.

# Name: MultiscaleSurfaceDifference_standalone.py
# Description: Calculates the maximum difference for each cell from the mean
# over a range of spatial scales.
# Requirements: Spatial Analyst extension

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

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

# Set local variables
inRaster = "elevation.tif"
inDistanceUnits = "METERS"
inMinScale = 10
inMaxScale = 100
inIncrement = 1

# Run the tool
outMaxDifferences = MultiscaleSurfaceDifference(inRaster, "", inDistanceUnits, inMinScale,
                                                inMaxScale, inIncrement, "")

# Save the output
outMaxDifference.save("C:/sapyexamples/output/outmaxdifferences02.tif")

Entornos

Auto ejecución, Tamaño de celda, Método de proyección de tamaño de celda, Espacio de trabajo actual, Extensión, Transformaciones geográficas, Id. de GPU, Máscara, Palabra clave CONFIG de salida, Sistema de coordenadas de salida, Factor de procesamiento en paralelo, Tipo de procesador, Pirámide, Espacio de trabajo temporal, Alinear ráster, Tamaño de tesela

Información de licenciamiento

Basic: Requiere Spatial Analyst
Standard: Requiere Spatial Analyst
Avanzado: Requiere Spatial Analyst

Diferencia de superficie multiescala (Herramientas de Spatial Analyst)

Resumen

Uso

Parámetros

Valor de retorno

Entornos

Información de licenciamiento

Temas relacionados