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
Esta herramienta modifica las entidades de puntos de entrada y puede cambiar su Id. de entidad interno, que puede denominarse ObjectID, FID u OID. Se recomienda tener un único campo de Id. in la tabla de atributos antes de realizar el análisis.
Los valores de celda se extraerán de todos los rásteres de entrada en cada ubicación. Se incorporará a la clase de entidad de puntos de entrada un nuevo campo que contiene los valores de celda para cada ráster de entrada.
En caso de que la tabla del ráster de entrada contuviera atributos adicionales, estos no se incorporarán a las entidades de puntos de entrada.
Los rásteres de entrada no se remuestrearán respetando el entorno de análisis. En su lugar, los valores de celda se extraen de todos los rásteres de entrada en su resolución y referencia espacial originales proyectando ubicaciones de entrada en la referencia espacial del ráster del que se extraen los valores.
Sin embargo, el entorno de análisis se aplica a las ubicaciones de entrada.
A las ubicaciones que extraen valores de celdas NoData en el ráster de entrada se les proporcionará un valor <null> en la tabla de salida. Para shapefiles, dado que los campos nulos no son compatibles, las celdas NoData se representan en la tabla con un valor de -9999.
El formato shapefile tiene un límite de 10 caracteres para la longitud máxima de los nombres de campo. Como resultado, se truncarán los nombres de los campos incorporados a la tabla de atributos de un shapefile de entrada y se harán únicos de forma predeterminada. Esto puede hacer que sea difícil distinguir entre los campos, especialmente si los nombres son largos o muy similares. En este caso, se sugiere que copie el shapefile de entrada a una geodatabase de archivos y utilice la clase de entidad para el análisis.
Si las Entidades de puntos de entrada (in_point_features en Python) se definen utilizando una capa de eventos XY, la tabla de eventos subyacente se actualiza directamente. La herramienta fallará si la tabla subyacente es de solo lectura.
La herramienta no se podrá ejecutar con entidades multipunto. Para realizar un análisis con entidades multipunto, primero conviértalas a entidades de puntos sencillas antes de usarlas en la herramienta de extracción. Consulte Procesar datos multipunto para obtener más información.
Cualquier combinación de rásteres (de banda única o multibanda) se puede especificar para el parámetro Rásteres de entrada (in_rasters en Python).
Cuando se especifica un ráster multibanda como uno de los Rásteres de entrada (in_rasters en Python), se utilizarán todas las bandas de esa entrada.
Para procesar una selección de bandas a partir de un ráster multibanda de entrada, cree primero un dataset ráster nuevo formado por esas bandas concretas con la herramienta Bandas compuestas. Utilice el resultado en la lista de rásteres de entrada.
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.
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.
La opción de interpolación determina cómo se obtendrán los valores desde el ráster. La opción predeterminada es extraer el valor de celda exacto en las ubicaciones de entrada. Para extraer valores interpolados con el método bilineal, active la opción Interpolación bilineal de valores en ubicaciones de puntos. En Python, establecería el parámetro bilinear_interpolate_values en BILINEAR.
Si se especifica una entidad en el entorno de Máscara, se crea un ráster interno con el tamaño de celda mínimo de los rásteres de entrada. Durante la extracción, el ráster de máscara interno se vuelve a remuestrear al tamaño de celda de cada ráster de entrada.
Consulte Entornos de análisis y Spatial Analyst para obtener detalles adicionales sobre los entornos de geoprocesamiento que se aplican a 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. | Extract Values |
bilinear_interpolate_values (Opcional) | Especifica si se utilizará la interpolación o no.
| Boolean |
Salida derivada
| Nombre | Explicación | Tipo de datos |
| out_point_features | Las entidades de puntos actualizadas. | Clase de entidad |
Muestra 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
- Basic: Requiere Spatial Analyst
- Standard: Requiere Spatial Analyst
- Advanced: Requiere Spatial Analyst