Disponible con una licencia de Spatial Analyst.
Resumen
Extrae los valores de celda basados en un conjunto de entidades de punto y registra los valores en la tabla de atributos de una clase de entidad de salida.
Uso
Todos los campos de la clase de entidad de puntos de entrada se incluirán en la clase de entidad de puntos de salida.
Se agrega un nuevo campo llamado RASTERVALU a la salida para almacenar los valores extraídos. Si ya existe un campo con este nombre en la tabla de atributos de las entidades de entrada, la herramienta fallará al ejecutarla.
El ráster de entrada no se remuestreará respetando el entorno de análisis. En su lugar, los valores de celda se extraen del ráster de entrada en su resolución y referencia espacial originales proyectando las 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 salida 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, recomendamos que la salida se envíe a una geodatabase de archivos.
La herramienta no se podrá ejecutar con entidades multipunto. Para realizar un análisis con entidades multipunto, 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.
Cuando se especifica un ráster multibanda como el Ráster de entrada (in_raster en Python), solamente se utilizará la primera banda.
Para procesar otra banda, especifique la banda que se debe utilizar.
Para extraer valores desde varios rásteres en un dataset ráster multibanda, utilice la herramienta Extraer valores múltiples a puntos.
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 el valor interpolado con el método bilineal, active la opción Interpolar valores en ubicaciones de puntos (interpolate_values en Python).
Para agregar todos los atributos de la tabla del ráster de entrada, active la opción Incorporar todos los atributos del ráster de entrada a las entidades de puntos de salida (ALL para el parámetro add_attributes en Python). Los atributos se incluirán tal cual en las entidades de puntos de salida y conservarán los mismos valores. Tenga en cuenta que, en función de la naturaleza de la propiedad que se va a registrar, es posible que haya que recalcular los valores de algunos atributos.
Si el entorno de Sistema de coordenadas de salida no se ha especificado explícitamente, la referencia espacial de la clase de entidad de salida se deriva de las entidades de puntos de entrada. Sin embargo, si la salida se escribe en un dataset de entidades, con o sin entorno de Sistema de coordenadas de salida especificado, la referencia espacial de salida será la misma que la del dataset de entidades.
Si se especifica una entidad en el entorno de Máscara, se convertirá a un ráster internamente, con el tamaño de celda y la alineación de celdas del 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
ExtractValuesToPoints(in_point_features, in_raster, out_point_features, {interpolate_values}, {add_attributes})| Parámetro | Explicación | Tipo de datos |
in_point_features | Las entidades de puntos de entrada que definen las ubicaciones desde donde desea extraer los valores de celda ráster. | Feature Layer |
in_raster | El dataset ráster cuyos valores se extraerán. El ráster puede ser de tipo entero o punto flotante. | Raster Layer |
out_point_features | El dataset de entidades de puntos de salida incluye los valores de ráster extraídos. | Feature Class |
interpolate_values (Opcional) | Especifica si se utilizará la interpolación lineal.
| Boolean |
add_attributes (Opcional) | Determina si los atributos de ráster se escriben en el dataset de entidades de puntos de salida.
| Boolean |
Muestra de código
Este ejemplo extrae los valores de celda desde un ráster en función de las ubicaciones definidas por un shapefile de puntos, y crea una clase de entidad de puntos de aquellos valores.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
ExtractValuesToPoints("rec_sites.shp", "elevation",
"C:/sapyexamples/output/outValPnts","INTERPOLATE",
"VALUE_ONLY")Este ejemplo extrae los valores de celda desde un ráster en función de las ubicaciones definidas por un shapefile de puntos, y crea un shapefile de puntos de salida de aquellos valores.
# Name: ExtractValuesToPoints_Ex_02.py
# Description: Extracts the cells of a raster based on a set of points.
# 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 = "rec_sites.shp"
inRaster = "elevation"
outPointFeatures = "C:/sapyexamples/output/extractvaluespts.shp"
# Execute ExtractValuesToPoints
ExtractValuesToPoints(inPointFeatures, inRaster, outPointFeatures,
"INTERPOLATE", "VALUE_ONLY")Entornos
Información de licenciamiento
- Basic: Requiere Spatial Analyst
- Standard: Requiere Spatial Analyst
- Advanced: Requiere Spatial Analyst