| 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 volumen.
| Boolean |
Disponible con una licencia de Spatial Analyst.
Resumen
Crea curvas de nivel que delimitan el área más pequeña que encierra el p por ciento de la magnitud total (valor × área de la celda) mediante la acumulación de celdas clasificadas hasta el umbral de volumen.
Obtener más información sobre cómo funciona Curvas de nivel de percentil de volumen
Ilustración
Uso
Los valores percentiles pueden ser cualquier valor entre 0 y 100. Un valor de 0 puede dar lugar a un resultado vacío o trivial. Un valor de 100 devuelve toda la huella válida.
La herramienta clasifica las celdas por sus valores en orden descendente y acumula el volumen por celda (volumen × área de celda) hasta que el total acumulado alcanza el p por ciento del volumen total del ráster. El área se calcula con el valor del parámetro Método de Planar o Geodésico. El umbral de volumen percentil es el valor en el punto de corte. La salida selecciona las celdas que cumplen o superan este umbral.
El área delimitada por el polígono de la curva de nivel de salida indica el área delimitada por el porcentaje de la suma total del volumen calculado utilizando los valores percentiles. El área de los polígonos de salida indica la huella física; no es igual al volumen, pero es el área donde reside el p por ciento del volumen
En el caso de valores repetidos en el umbral de volumen, la herramienta incluye todos los valores en ese umbral. Como resultado, el volumen de producción no será inferior al percentil especificado. Una consecuencia de ello es que los percentiles adyacentes pueden ser similares.
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.
El área de la forma del polígono indica cuánto terreno hay en esa banda extrema.
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 análisis. Esto puede influir en la suma acumulada del cálculo del volumen.
El ráster de superficie de entrada debe ser un ráster de banda única.
Si el objetivo es crear polígonos basados únicamente en valores celulares clasificados, utilice la herramienta Curvas de nivel de percentil de valor.
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
VolumePercentileContours(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 volumen.
| 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"
VolumePercentileContours("CrimeEventsDensity.tif", "VolP_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: VolumePercentileContours_Ex_standalone.py
## Description: Delineate areas of different magnitudes 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 = [25, 50, 75, 90, 95, 99]
method = "Planar"
ignore_negative_values = "USE_ALL_VALUES"
out_volP_contour = "VolumeP_CrimeDensity_Out.shp"
## Execute: Create Volume Percentile Contours
VolumP_out_contours = VolumePercentileContours(in_surface_raster,
out_volP_contour,
percentile_values, method,
ignore_negative_values)Entornos
Información de licenciamiento
- Basic: Requiere Spatial Analyst
- Standard: Requiere Spatial Analyst
- Advanced: Requiere Spatial Analyst