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

Resumen

Crea curvas de nivel que delimitan el área más pequeña que encierra el % superior de la magnitud total (valor * área de la celda) mediante la acumulación de celdas clasificadas hasta el umbral de volumen.

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 basándose solo en los valores de las celdas según su clasificación, utilice en su lugar 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 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 volumen. Activado—Se ignorarán los valores negativos en el cálculo del percentil de volumen. Desactivado—Los valores negativos no se ignorarán en el cálculo del percentil de volumen, 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

VolumePercentileContours(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 volumen. `IGNORE_NEGATIVE_VALUES`—Se ignorarán los valores negativos en el cálculo del percentil de volumen. `USE_ALL_VALUES`—Los valores negativos no se ignorarán en el cálculo del percentil de volumen, 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

VolumePercentileContours 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"
VolumePercentileContours("CrimeEventsDensity.tif", "VolP_CrimeDensity_Out.shp",
                         [50, 75, 90, 95, 99], method = "Planar",
                         ignore_negative_values = "USE_ALL_VALUES",
                         smooth_outputs="SMOOTH")

VolumePercentileContours ejemplo 2 (script independiente)

El siguiente ejemplo muestra el uso de 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 *

## 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"
smooth_outputs="SMOOTH"
out_volP_contour = "VolumeP_CrimeDensity_Out.shp"

## Run: Create Volume Percentile Contours
VolumP_out_contours = VolumePercentileContours(in_surface_raster,
                                               out_volP_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