Curvas de nivel de percentil de valor (Herramientas de Spatial Analyst)

Resumen

Crea curvas de nivel que delimitan el p % superior de un ráster mediante la clasificación de los valores de las celdas, la selección de las celdas en el umbral percentil y la producción de huellas de las áreas extremas.

Más información sobre cómo funciona Curvas de nivel de percentil de valor

Ilustración

Uso

Los valores percentiles pueden ser cualquier valor entre 0 y 100. Un valor de 100 puede dar lugar a un resultado vacío o trivial. Un valor de 0 devuelve toda la huella válida.
La herramienta clasifica las celdas por sus valores en orden ascendente y devuelve el p por ciento superior de las celdas ráster. El umbral percentil se calcula a partir de los valores de las celdas clasificadas. La salida selecciona las celdas que cumplen o superan el valor umbral.
La huella del polígono de la curva de nivel de salida indica el área delimitada por el porcentaje de la suma total de los valores extremos por encima del percentil especificado.
En caso de valores repetidos en el umbral, se seleccionarán todos los valores repetidos. Como resultado, los percentiles adyacentes pueden producir el mismo umbral y polígono de curva de nivel de salida. Sin embargo, la herramienta no seleccionará valores inferiores al percentil especificado.
Cuando se especifican varios valores percentiles, los polígonos resultantes se anidarán. El polígono más interno corresponde a los valores más altos y el polígono más externo cubre los valores más pequeños.
La opción Planar del parámetro Método resulta adecuada si el análisis se realiza a escala local con una proyección que mantiene el área y la distancia correctas de manera precisa.

Utilice la opción Geodésica para realizar análisis a escala regional o a gran escala (por ejemplo, utilizando Web Mercator o cualquier sistema de coordenadas geográficas). Esta opción tiene en cuenta la curvatura del esferoide y trata correctamente los datos cercanos a los polos y a la línea internacional de cambio de fecha.
Si el parámetro Ignorar valores negativos no está marcado, la herramienta incluirá los valores negativos de las celdas de entrada en el cálculo.
El ráster de superficie de entrada debe ser un ráster de banda única.
Si el objetivo es crear polígonos basados en la magnitud acumulativa de los valores de las celdas, utilice la herramienta Curvas de nivel de percentil de volumen.
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	El ráster de entrada para la que se calcularán los polígonos de curvas de nivel. Debe ser un ráster continua. El tipo de datos ráster de entrada puede ser entero o de punto flotante.	Raster Layer
Polígonos de curvas de nivel de salida	Las entidades del polígono de curvas de salida. El resultado incluye polígonos de contorno para todos los valores percentiles especificados.	Feature Class
Valores de percentil (Opcional)	Los valores percentiles para los que se calcularán las curvas de nivel. El valor predeterminado es 90 e indica el percentil 90^o. Los valores pueden variar de 0 a 100.	Double
Método (Opcional)	Especifica si el cálculo se basará en un método planar (Tierra plana) o geodésico (elipsoide). El método planar es adecuado para utilizarlo en áreas locales en una proyección que mantiene la distancia y el área correctas. Es adecuado para análisis que cubren áreas como ciudades, condados o estados con áreas más pequeñas. El método geodésico produce un resultado más exacto, con el posible coste de un incremento del tiempo de procesamiento. Planar—El cálculo se realizará sobre un plano proyectado usando un sistema de coordenadas cartesianas 2D. Esta es la opción predeterminada. Geodésica—El cálculo se realizará en un sistema de coordenadas cartesianas 3D teniendo en cuenta la forma de la Tierra como un elipsoide.	String
Ignorar valores negativos (Opcional)	Especifica si se ignorarán los valores negativos en el cálculo del percentil de valor. Activado—Se ignorarán los valores negativos en el cálculo del percentil. Desactivado—Los valores negativos no se ignorarán en el cálculo del percentil, sino que se incluirán. Esta es la opción predeterminada.	Boolean
Salidas suaves (Opcional)	Determina si los polígonos de salida se suavizarán a formas más simples o ajustarán a los ejes de celda del ráster. Activado—Los polígonos se suavizarán a formas más simples. El suavizado se lleva a cabo de tal forma que los polígonos contienen un número mínimo de segmentos mientras permanecen tan cerca como sea posible a los ejes originales de celda ráster. Esta es la opción predeterminada. Desactivado—El eje de los polígonos se ajustará exactamente a los ejes de celda del ráster de entrada. Con esta opción, volver a convertir la clase de entidad de polígonos resultantes en un ráster produciría un ráster igual al original.	Boolean

ValuePercentileContours(in_surface_raster, out_contour_polygons, {percentile_values}, {method}, {ignore_negative_values}, {smooth_outputs})

Nombre	Explicación	Tipo de datos
in_surface_raster	El ráster de entrada para la que se calcularán los polígonos de curvas de nivel. Debe ser un ráster continua. El tipo de datos ráster de entrada puede ser entero o de punto flotante.	Raster Layer
out_contour_polygons	Las entidades del polígono de curvas de salida. El resultado incluye polígonos de contorno para todos los valores percentiles especificados.	Feature Class
percentile_values [percentile_values,...] (Opcional)	Los valores percentiles para los que se calcularán las curvas de nivel. El valor predeterminado es 90 e indica el percentil 90^o. Los valores pueden variar de 0 a 100.	Double
method (Opcional)	Especifica si el cálculo se basará en un método planar (Tierra plana) o geodésico (elipsoide). El método planar es adecuado para utilizarlo en áreas locales en una proyección que mantiene la distancia y el área correctas. Es adecuado para análisis que cubren áreas como ciudades, condados o estados con áreas más pequeñas. El método geodésico produce un resultado más exacto, con el posible coste de un incremento del tiempo de procesamiento. `PLANAR`—El cálculo se realizará sobre un plano proyectado usando un sistema de coordenadas cartesianas 2D. Esta es la opción predeterminada. `GEODESIC`—El cálculo se realizará en un sistema de coordenadas cartesianas 3D teniendo en cuenta la forma de la Tierra como un elipsoide.	String
ignore_negative_values (Opcional)	Especifica si se ignorarán los valores negativos en el cálculo del percentil de valor. `IGNORE_NEGATIVE_VALUES`—Se ignorarán los valores negativos en el cálculo del percentil. `USE_ALL_VALUES`—Los valores negativos no se ignorarán en el cálculo del percentil, sino que se incluirán. Esta es la opción predeterminada.	Boolean
smooth_outputs (Opcional)	Determina si los polígonos de salida se suavizarán a formas más simples o ajustarán a los ejes de celda del ráster. `SMOOTH`—Los polígonos se suavizarán a formas más simples. El suavizado se lleva a cabo de tal forma que los polígonos contienen un número mínimo de segmentos mientras permanecen tan cerca como sea posible a los ejes originales de celda ráster. Esta es la opción predeterminada. `NO_SMOOTH`—El eje de los polígonos se ajustará exactamente a los ejes de celda del ráster de entrada. Con esta opción, volver a convertir la clase de entidad de polígonos resultantes en un ráster produciría un ráster igual al original.	Boolean

Muestra de código

ValuePercentileContours ejemplo 1 (ventana de Python)

En el siguiente ejemplo se muestra el uso de esta herramienta en la ventana de Python.

import arcpy
from arcpy import env
from arcpy.sa import *

env.workspace = "C:/sapyexamples/data"
ValuePercentileContours("CrimeEventsDensity.tif", "ValP_CrimeDensity_Out.shp",
                        [50, 75, 90, 95, 99], method = "Planar",
                        ignore_negative_values = "USE_ALL_VALUES",
                        smooth_outputs="SMOOTH")

ValuePercentileContours ejemplo 2 (script independiente)

El siguiente ejemplo muestra cómo el uso de esta herramienta en una secuencia de comandos independiente de Python:

## Name: ValuePercentileContours_Ex_standalone.py
## Description: Identify different local intensity zones from density 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"
# To allow overwriting outputs change overwriteOutput option to True.
env.overwriteOutput = False

## Set local variables
in_surface_raster = "CrimeEventsDensity.tif"
percentile_values = [50, 75, 90, 95, 99]
method = "Planar"
ignore_negative_values = "USE_ALL_VALUES"
smooth_outputs="SMOOTH"
out_volueP_contour = "ValueP_CrimeDensity_Out.shp"

## Run: Create Value Percentile Contours
ValueP_out_contours = ValuePercentileContours(in_surface_raster,
                                              out_volueP_contour,
                                              percentile_values,
                                              method, ignore_negative_values, smooth_outputs)

Entornos

Auto ejecución, Espacio de trabajo actual, Valor Z de salida predeterminado, Extensión, Transformaciones geográficas, Resolución M, Tolerancia M, Factor de procesamiento en paralelo, 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, Resolución XY, Tolerancia XY, Resolución Z, Tolerancia Z

Información de licenciamiento

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