Extraer valores múltiples a puntos (Spatial Analyst)
Resumen
Extrae valores de celda en ubicaciones especificadas en una clase de entidad de punto desde uno o más rásteres y registra los valores en la tabla de atributos de la clase de entidad de punto.
Uso
-
Cualquier combinación de rásteres (de banda única o multibanda) se puede especificar como una entrada.
-
Se extraerá un valor de celda por cada ráster de entrada y se incorpora un nuevo campo que contiene los valores de celda para cada ráster de entrada a la clase de entidad de punto de entrada.
-
Los nombres del campo de salida se crean a partir del nombre del ráster de entrada por defecto. De lo contrario, puede especificar un nombre único para cada campo para almacenar los valores del ráster.
-
Cuando la entrada es un ráster multibanda, se agregará un campo para todas la bandas con un prefijo "b1_, b2_, …bn" agregado en el nombre del campo de salida que denota el número de la banda.
-
La opción de interpolación determina cómo se obtendrán los valores desde el ráster. La opción predeterminada es utilizar el valor en el centro de la celda que se está mostrando. La opción de interpolación utilizará la interpolación bilineal para interpolar un valor para el centro de la celda.
-
Los formatos shapefile tienen un límite de campo de un máximo de 10 caracteres. Los campos de salida incorporados en el shapefile de entrada se truncarán y se harán únicos por defecto. Esto puede hacer que sea difícil distinguir entre rásteres de entrada si los nombres son largos o muy similares. En este caso, se sugiere que convierta las entidades a una geodatabase de archivos.
-
A las celdas NoData del ráster de valor se les otorgará un valor NULL. Los shapefiles no son compatibles con el valor NULL y se asignará un valor de 0 (cero).
Los datasets multipunto no están admitidos como entrada.
Precaución:Esta herramienta modifica los datos de entrada. Consulte Herramientas sin salida para obtener más información y estrategias para evitar la modificación de datos no deseada.
Sintaxis
| Parámetro | Explicación | Tipo de datos |
in_point_features |
Las entidades de punto de entrada a las que desea agregarle los valores de ráster. | Feature Layer |
in_rasters [[Raster, {Output Field Name}],...] |
Los valores del ráster (o rásteres) de entrada que desea extraer según la ubicación de la entidad de punto de entrada. Opcionalmente, puede suministrar el nombre del campo para almacenar el valor del ráster. Por defecto, se creará un nombre de campo único según el nombre del dataset ráster de entrada. | Value Table |
bilinear_interpolate_values (Opcional) |
Especifica si se utilizará la interpolación o no.
| Boolean |
Ejemplo de código
Extrae los valores de celda desde varios rásteres a atributos en una clase de entidad de shapefile de punto.
import arcpy
from arcpy.sa import *
from arcpy import env
env.workspace = "c:/sapyexamples/data"
ExtractMultiValuesToPoints("observers.shp", [["elevation", "ELEV"],
["costraster", "COST"], ["flowdir", "DIR"]], "NONE")
Extrae los valores de celda desde varios rásteres a atributos en una clase de entidad de shapefile de punto mediante la interpolación.
# Name: ExtractMultiValuesToPoints_Ex_02.py
# Description: Extracts the cells of multiple rasters as attributes in
# an output point feature class. This example takes a multiband IMG
# and two GRID files as input.
# 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 = "poi.shp"
inRasterList = [["doqq.img", "doqqval"], ["redstd", "focalstd"],
["redmin", "focalmin"]]
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute ExtractValuesToPoints
ExtractMultiValuesToPoints(inPointFeatures, inRasterList, "BILINEAR")