Densidad kernel (Spatial Analyst)

Nivel de licencia:BasicStandardAdvanced

Resumen

Calcula una magnitud por unidad de área a partir de entidades de punto o polilínea mediante una función kernel para adaptar una superficie suavemente estrechada a cada punto o polilínea.

Más información sobre cómo funciona Densidad kernel

Uso

Sintaxis

KernelDensity (in_features, population_field, {cell_size}, {search_radius}, {area_unit_scale_factor})
ParámetroExplicaciónTipo de datos
in_features

Las entidades de entrada (punto o línea) para las que se calculará la densidad.

Feature Layer
population_field

Campo que denota los valores de población para cada entidad. El campo de población es el conteo o la cantidad que se expandirá a lo largo del paisaje para crear una superficie continua.

Los valores del campo de población pueden ser enteros o de punto flotante.

A continuación se enumeran las opciones y los comportamientos predeterminados para los campos.

  • Use Ninguno si no se utilizará un elemento o valor especial y cada entidad se contará una sola vez.

  • Puede usar la Forma si las entidades de entrada contienen Z.

  • De lo contrario, el campo predeterminado es POPULATION. Además, pueden aplicarse las siguientes condiciones.

    • Si no hay campo de POPULATION, pero hay un campo de POPULATIONxxxx, este se usa de manera predeterminada. "xxxx" puede ser cualquier carácter válido, como POPULATION6, POPULATION1974 o POPULATIONROADTYPE.
    • Si no hay campo de POPULATION o de POPULATIONxxxx, pero hay un campo de POP, este se usa de manera predeterminada.
    • Si no hay campo de POPULATION, de POPULATIONxxxx o de POP, pero hay un campo POPxxxx, este se usa de manera predeterminada.
    • Si no hay campo de POPULATION, de POPULATIONxxxx de POP o de POPxxxx, NONE se usa de manera predeterminada.
Field
cell_size
(Opcional)

El tamaño de celda para el dataset ráster de salida.

Este es el valor del entorno si se lo establece específicamente. Si el entorno no se establece, entonces el tamańo de celda es menor que el ancho o la altura de la extensión de la salida en la referencia espacial de la salida, dividido entre 250.

Analysis Cell Size
search_radius
(Opcional)

The search radius within which to calculate density. Las unidades están basadas en la unidad lineal de la proyección de la referencia espacial de salida.

Por ejemplo, si las unidades están expresadas en metros, para incluir a todas las entidades dentro de una vecindad de una milla, establezca el radio de búsqueda como 1609,344 (1 milla = 1609,344 metros).

El valor predeterminado es el menor del ancho o de la altura de la extensión de la salida en la referencia espacial de la salida, divido entre 30.

Double
area_unit_scale_factor
(Opcional)

Las unidades de área deseadas de los valores de densidad de salida.

Una unidad predeterminada se selecciona según la unidad lineal de la proyección de la referencia espacial de salida. Puede cambiarla a la unidad adecuada si desea convertir la salida de densidad. Los valores de la densidad de línea convierten las unidades de longitud y área.

Por ejemplo, si las unidades de entrada son metros, las unidades de densidad de área de salida predeterminadas serán kilómetros cuadrados para las entidades de punto o kilómetros por kilómetros cuadrados para las entidades de polilínea.

Las unidades de densidad predeterminadas basadas en las unidades de entidad de entrada son:

  • SQUARE_MAP_UNITS Si no se conocen las unidades, puntos o grados decimales.
  • SQUARE_MILES Para pies, yardas, millas o millas náuticas.
  • SQUARE_KILOMETERS Para metros o kilómetros.
  • SQUARE_INCHES Para pulgadas.
  • SQUARE_CENTIMETERS Para centímetros.
  • SQUARE_MILLIMETERS Para milímetros.
String

Valor de retorno

NombreExplicaciónTipo de datos
out_raster

El ráster de densidad kernel de salida.

Siempre es un ráster de punto flotante.

Raster

Ejemplo de código

Ejemplo 1 de KernelDensity (ventana de Python)

En este ejemplo se calcula un ráster de densidad suavizado a partir de un archivo de forma de puntos.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outKDens = KernelDensity("rec_sites.shp", "NONE", 45, 1200, "SQUARE_KILOMETERS")
outKDens.save("C:/sapyexamples/output/kdensout")
Ejemplo 2 de KernelDensity (secuencia de comandos independiente)

En este ejemplo se calcula un ráster de densidad suavizado a partir de un archivo de forma de puntos.

# Name: KernelDensity_Ex_02.py
# Description: Calculates a magnitude per unit area from point or polyline 
#    features using a kernel function to fit a smoothly tapered 
#    surface to each point or polyline.
# 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"

# Set local variables
inFeatures = "rec_sites.shp"
populationField = "NONE"
cellSize = 60
searchRadius = 2500


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

# Execute KernelDensity
outKernelDensity = KernelDensity(inFeatures, populationField, cellSize,
                                 searchRadius, "SQUARE_KILOMETERS")

# Save the output 
outKernelDensity.save("C:/sapyexamples/output/kerneldout")

Entornos

Temas relacionados

Información sobre licencias

ArcGIS for Desktop Basic: Requiere Spatial Analyst
ArcGIS for Desktop Standard: Requiere Spatial Analyst
ArcGIS for Desktop Advanced: Requiere Spatial Analyst
9/11/2013