Disponible con una licencia de Spatial Analyst.
Resumen
Interpola una superficie de ráster a partir de puntos utilizando una técnica de vecinos naturales.
Uso
Si el centro de celda de las celdas del perímetro del ráster de salida cae fuera de la envoltura convexa (definida por los puntos de entrada), entonces a esas celdas se le asignarán valores NoData. Si un punto de entrada cae dentro de una de estas celdas del perímetro y el centro de la celda cae fuera de la envoltura convexa, aún se le asignará un valor de NoData a la celda.
-
Algunos datasets de entrada pueden tener algunos puntos con las mismas coordenadas x,y. Si los valores de los puntos de una ubicación común son los mismos, se consideran duplicados y no afectan a la salida. Si los valores son diferentes, se consideran puntos coincidentes.
Las distintas herramientas de interpolación pueden manejar esta condición de datos de maneras distintas. Por ejemplo, en algunos casos el primer punto coincidente encontrado se utiliza para el cálculo; en otros casos, se utiliza el último punto encontrado. Esto puede causar que algunas ubicaciones del ráster de entrada tengan valores distintos a los que puede esperar. La solución es preparar los datos quitando estos puntos coincidentes. La herramienta Capturar eventos de la caja de herramientas de Estadística espacial es útil para identificar cualquier punto coincidente en los datos.
Esta herramienta tiene un límite de aproximadamente 15 millones de puntos de entrada. Si la clase de entidad de entrada contiene una cantidad extremadamente grande de puntos (alrededor de 15 millones o más), la herramienta puede fallar al crear un resultado.
Puede evitar este límite procesando el área de estudio en varias secciones y creando un mosaico de los resultados para generar un sólo dataset ráster grande. Asegúrese de que haya alguna superposición entre las secciones. Alternativamente, puede utilizar un Dataset de terreno para almacenar y visualizar puntos y superficies comprimidos de mil millones de puntos de medición.
Se recomienda que los datos de entrada estén en un sistema de coordenadas proyectadas en vez de en un sistema de coordenadas geográficas.
Si ArcGIS 3D Analyst extension está disponible, se puede utilizar un dataset de TIN. Primero, cree un TIN desde los datos de origen. Luego, convierta el TIN resultante a un ráster con la herramienta De TIN a ráster mediante la opción Vecinos naturales. Esto es particularmente útil si tiene líneas de corte o un área de datos con formas irregulares.
Consulte Entornos de análisis y Spatial Analyst para obtener detalles adicionales sobre los entornos de geoprocesamiento válidos para esta herramienta.
Sintaxis
NaturalNeighbor (in_point_features, z_field, {cell_size})| Parámetro | Explicación | Tipo de datos |
in_point_features | Entidades de puntos de entrada que contienen los valores z que se interpolarán en un ráster de superficie. | Feature Layer |
z_field | Campo que contiene un valor de altura o magnitud para cada punto. Puede ser un campo numérico o el campo Forma si las entidades de punto de entrada contienen valores z. | Field |
cell_size (Opcional) | El tamaño de celda con el que se creará el ráster de salida. Este será el valor del entorno si se establece explícitamente; de lo contrario, será el valor más bajo del ancho o de la altura de la extensión de las entidades de punto de entrada, en la referencia espacial de entrada, dividido por 250. | Analysis Cell Size |
Valor de retorno
| Nombre | Explicación | Tipo de datos |
| out_raster | Ráster de superficie interpolado de salida. Siempre es un ráster de punto flotante. | Raster |
Ejemplo de código
Ejemplo 1 de NaturalNeighbor (ventana de Python)
En este ejemplo se introduce un shapefile de punto y se interpola la superficie de salida como ráster TIFF.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outNaturalNeighbor = NaturalNeighbor("ozone_pts.shp", "ozone", 2000)
outNaturalNeighbor.save("C:/sapyexamples/output/nnout.tif")
Ejemplo 2 de NaturalNeighbor (secuencia de comandos independiente)
En este ejemplo se introduce un shapefile de punto y se interpola la superficie de salida como ráster de cuadrícula.
# Name: NaturalNeighbor_Ex_02.py
# Description: Interpolate a series of point features onto a
# rectangular raster using Natural Neighbor interpolation.
# 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
inPointFeatures = "ca_ozone_pts.shp"
zField = "ozone"
cellSize = 40000
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute NaturalNeighbor
outNatNbr = NaturalNeighbor(inPointFeatures, zField, cellSize)
# Save the output
outNatNbr.save("C:/sapyexamples/output/nnout02")
Entornos
Información sobre licencias
- ArcGIS for Desktop Basic: Requiere Spatial Analyst o 3D Analyst
- ArcGIS for Desktop Standard: Requiere Spatial Analyst o 3D Analyst
- ArcGIS for Desktop Advanced: Requiere Spatial Analyst o 3D Analyst