| 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 90o. 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.
| String |
Ignorar valores negativos (Opcional) | Especifica si se ignorarán los valores negativos en el cálculo del percentil de valor.
| Boolean |
Disponible con una licencia 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.
Obtener 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 que se aplican a esta herramienta.
Parámetros
ValuePercentileContours(in_surface_raster, out_contour_polygons, {percentile_values}, {method}, {ignore_negative_values})| 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 90o. 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.
| String |
ignore_negative_values (Opcional) | Especifica si se ignorarán los valores negativos en el cálculo del percentil de valor.
| Boolean |
Muestra de código
En el siguiente ejemplo se muestra cómo usar 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")En el siguiente ejemplo se muestra cómo usar 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 *
## Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
## 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"
out_volueP_contour = "ValueP_CrimeDensity_Out.shp"
## Execute: Create Volume Percentile Contours
ValueP_out_contours = ValuePercentileContours(in_surface_raster,
out_volueP_contour,
percentile_values,
method, ignore_negative_values)Entornos
Información de licenciamiento
- Basic: Requiere Spatial Analyst
- Standard: Requiere Spatial Analyst
- Advanced: Requiere Spatial Analyst