Percentil de superficie multiescala (Spatial Analyst)

Disponible con una licencia de Spatial Analyst.

Resumen

Calcula el percentil más extremo en todo un rango de escalas espaciales.

Más información sobre el funcionamiento de Percentil de superficie multiescala

Uso

• El valor del parámetro Ráster de superficie de entrada (in_raster de Python) puede ser cualquier tipo de ráster de superficie. Cuando se utiliza un ráster de superficie distinto de una superficie de elevación, esta herramienta calcula el percentil de los valores de las celdas del ráster.

• Cuando se utiliza una superficie de elevación como entrada, el percentil de elevación (PE) es el percentil calculado. El PE es una medida de Posición topográfica local (LTP). Expresa la posición vertical de una celda como el percentil de la distribución de elevación dentro de una ventana de filtro, o vecindad. El PE multiescala es altamente variable a escalas menores y cambia más gradualmente a escalas mayores. También se ve relativamente poco afectado por las distribuciones irregulares de elevación y los valores atípicos, lo que lo convierte en una medida robusta de la LTP.

• Tanto si se utiliza una superficie de elevación como otro tipo de superficie como entrada, el percentil se calcula en varias escalas. Estas escalas son el valor de distancia de vecindad utilizado para el cálculo. Son las distancias desde el centro de la celda objetivo, creando un cuadrado de celdas alrededor de la celda objetivo. Por ejemplo, una escala de 4 celdas es una vecindad de 9 por 9 celdas.

• El parámetro Ráster de percentiles de salida (out_percentile_raster de Python) es la salida principal. Se trata de un ráster que contiene los percentiles más extremos de cada celda en un rango de escalas espaciales. Los valores pueden oscilar entre 0 y 100. El valor más extremo es el percentil más alejado de 50 (por ejemplo, los percentiles más cercanos a 0 o 100).

• El parámetro Ráster de escala de salida (out_scale_raster de Python) proporciona más información sobre la salida principal. Contiene la escala en la que se encontró el percentil más extremo 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.

• Los parámetros Distancia mínima de vecindad (min_scale de Python) y Distancia máxima de vecindad (max_scale de Python) definen los tamaños mínimo y máximo de la vecindad, o escalas, para los que se calculará el percentil. Estos valores representan la menor y la mayor distancia a la celda objetivo. Por ejemplo, un valor de 1 crea una vecindad de celdas de 3 por 3, y un valor de 2 crea una vecindad de celdas de 5 por 5.

  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 parámetro Incremento de distancia base (base_increment de Python) es el incremento inicial de la distancia de vecindad entre escalas. Este incremento se altera cuando se utiliza un valor superior a 1 para el parámetro Factor de no linealidad (nonlinearity de Python).

  El valor de este parámetro no puede ser inferior al tamaño de celda del ráster de entrada ni a 1 celda. El valor predeterminado es el tamaño de la celda ráster de entrada.

• El parámetro Factor de no linealidad controla el incremento de la distancia de vecindad, o escala. Un valor de 1,0 crea un incremento lineal de la escala en que el incremento entre escalas será el mismo (el valor del parámetro Incremento de distancia base). Si incrementa este valor, la escala aumentará más rápidamente y disminuirá el número de escalas para una escala mínima y máxima determinadas.

  Utilice un valor superior a 1,0 para este parámetro si desea una densidad de muestreo de escala alta para las escalas más pequeñas y una densidad de muestreo de escala más baja para las escalas más grandes.

  Este parámetro acepta valores mayores o iguales a 1,0. En general, se utilizan con frecuencia valores entre 1,0 y 2,0 para este parámetro cuando se busca un incremento no lineal de la distancia de vecindad.

  Más información sobre el funcionamiento de Percentil de superficie multiescala

• Se ignorarán las celdas NoData del valor Ráster de superficie de entrada y a esas celdas se les asignará NoData en los valores de los parámetros Ráster de percentil de salida 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.

• Si se ejecuta con la GPU, se obtiene una mayor precisión en comparación con la CPU.

• 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 contiene detalles acerca de 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 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
Ráster de escala de salida (Opcional)	El ráster de salida que contiene la escala en la que se encontró el percentil más extremo 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 base. La distancia se medirá en el número de celdas o la unidad especificada. Por defecto, es la unidad de mapa de la referencia espacial para el valor 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á pulgadas. Pies—La unidad de distancia será pies. Yarda—La unidad de distancia será yardas. Millas—La unidad de distancia será millas.	String
Distancia mínima de vecindad (Opcional)	La distancia que define la escala mínima de vecindad para la que se calculará el percentil de elevación. 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 4 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 máxima de vecindad (Opcional)	La distancia que define la escala máxima de vecindad para la que se calculará el percentil de elevación. 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 base (Opcional)	El incremento inicial de la distancia de vecindad entre las escalas. El valor de este parámetro no puede ser inferior al tamaño de celda de Ráster de superficie de entrada ni a 1 celda. El valor predeterminado es el tamaño de celda del valor del parámetro Ráster de superficie de entrada.	Double
Factor de no linealidad (Opcional)	El factor que puede introducir la no linealidad en el aumento de la escala en cada incremento. Esto hace que el incremento entre escalas aumente en lugar de permanecer constante. Generalmente, se utilizan valores entre 1,0 y 2,0. Este parámetro debe ser mayor o igual a 1. El valor predeterminado es 1, que crea un incremento lineal de las distancias de vecindades (donde el incremento entre escalas permanece constante).	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 percentiles de salida	El ráster de salida que contiene el valor de percentil más extremo de cada celda. El valor más extremo es el percentil más alejado de 50 (como los percentiles más cercanos a 0 o 100). Será de tipo punto flotante.	Raster

Python

MultiscaleSurfacePercentile(in_raster, {out_scale_raster}, {distance_units}, {min_scale}, {max_scale}, {base_increment}, {nonlinearity}, {analysis_target_device})

Nombre	Explicación	Tipo de datos
in_raster	Ráster de entrada de superficie.	Raster Layer
out_scale_raster (Opcional)	El ráster de salida que contiene la escala en la que se encontró el percentil más extremo 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 las unidades de distancia que se utilizarán para los parámetros min_scale, max_scale y base_increment. La distancia se medirá en el número de celdas o la unidad especificada. Por defecto, es la unidad de mapa de la referencia espacial para el valor 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á pulgadas. FEET—La unidad de distancia será pies. YARDS—La unidad de distancia será yardas. MILES—La unidad de distancia será millas.	String
min_scale (Opcional)	La distancia que define la escala mínima de vecindad para la que se calculará el percentil de elevación. 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 4 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)	La distancia que define la escala máxima de vecindad para la que se calculará el percentil de elevación. 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
base_increment (Opcional)	El incremento inicial de la distancia de vecindad entre las escalas. Este parámetro no puede ser inferior al tamaño de celda de in_raster ni a 1 celda. El valor predeterminado es el tamaño de celda del valor del parámetro in_raster.	Double
nonlinearity (Opcional)	El factor que puede introducir la no linealidad en el aumento de la escala en cada incremento. Esto hace que el incremento entre escalas aumente en lugar de permanecer constante. Generalmente, se utilizan valores entre 1,0 y 2,0. Este parámetro debe ser mayor o igual a 1. El valor predeterminado es 1, que crea un incremento lineal de las distancias de vecindades (donde el incremento entre escalas permanece constante).	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_percentile_raster	El ráster de salida que contiene el valor de percentil más extremo de cada celda. El valor más extremo es el percentil más alejado de 50 (como los percentiles más cercanos a 0 o 100). Será de tipo punto flotante.	Raster

Muestra de código

Ejemplo 1 de MultiscaleSurfacePercentile (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 percentiles a partir de un ráster de superficie de entrada utilizando los valores predeterminados para todos los parámetros opcionales.

from arcpy.sa import *
outPercentiles = MultiscaleSurfacePercentile("elevation.tif", "", "", "", "", "", "", "")
outPercentiles.save("C:/sapyexamples/output/outpercentiles01.tif")

Ejemplo 2 de MultiscaleSurfacePercentile (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 percentiles para escalas que van desde los 10 metros hasta los 100 metros con incrementos de 10 metros entre cada escala.

# Name: MultiscaleSurfacePercentile_standalone.py
# Description: Calculates the most extreme percentiles 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"

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

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

# Execute the tool
outPercentiles = MultiscaleSurfacePercentile(inRaster, "", inDistanceUnits, inMinScale,
                                             inMaxScale, inIncrement, inNonlinearity, "")

# Save the output 
outPercentiles.save("C:/sapyexamples/output/outpercentiles02.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, Máscara, Palabra clave CONFIG de salida, Sistema de coordenadas de salida, Pirámide, Factor de procesamiento en paralelo, 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