Disponible con una licencia de 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 de los campos de salida se crean de forma predeterminada a partir del nombre del ráster de entrada, pero también puede especificar un nombre único para cada campo a fin de 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 al nombre del campo de salida que indica 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 máximo de 10 caracteres. Los campos de salida incorporados al 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 de entrada en una geodatabase de archivos y que la utilice como entrada en su lugar.
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.
Consulte Entornos de análisis y Spatial Analyst para obtener detalles adicionales sobre los entornos de geoprocesamiento válidos para esta herramienta.
Sintaxis
ExtractMultiValuesToPoints (in_point_features, in_rasters, {bilinear_interpolate_values})| 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
Ejemplo 1 de ExtractMultiValuesToPoints (ventana de Python)
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")
Ejemplo 2 de ExtractMultiValuesToPoints (secuencia de comandos independiente)
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")
Entornos
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