Extraer valores según puntos (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.

La herramienta Extraer valores múltiples a puntos proporciona una funcionalidad o rendimiento mejorados.

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 denominado 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 no se ejecutará.

• 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 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 valor de 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 consiste en extraer el valor de celda exacto en las ubicaciones de entrada. Para extraer el valor interpolado mediante un método bilineal, active la opción Interpolar valores en las ubicaciones de los 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 no se ha especificado explícitamente el entorno del sistema de coordenadas de salida, la referencia espacial de la clase de entidad de salida se obtiene de las entidades de punto de entrada. Sin embargo, si la salida se escribe en un conjunto de datos de entidades, con o sin especificar el entorno del sistema de coordenadas de salida, la referencia espacial de salida será la misma que la del conjunto de datos de entidades.

• Si se especifica una entidad en el entorno Máscara, se convertirá internamente a un ráster utilizando el tamaño de celda y la alineación de celda del ráster de entrada.

• Consulte Entornos de análisis y Spatial Analyst para obtener detalles adicionales sobre los entornos de geoprocesamiento válidos para esta herramienta.

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Entidades de puntos de entrada	Las entidades de puntos de entrada que definen las ubicaciones desde donde desea extraer los valores de celda ráster.	Feature Layer
Ráster de entrada	El dataset ráster cuyos valores se extraerán. El ráster puede ser de tipo entero o punto flotante.	Raster Layer
Entidades de puntos de salida	El dataset de entidades de puntos de salida incluye los valores de ráster extraídos.	Feature Class
Interpolar valores en las ubicaciones de los puntos (Opcional)	Especifica si se utilizará la interpolación lineal. Desactivado: no se aplica interpolación; se utilizará el valor del centro de la celda. Esta es la opción predeterminada. Activado: el valor de la celda se calcula a partir de las celdas adyacentes con valores válidos utilizando la interpolación bilineal. Los valores NoData se ignorarán en la interpolación a menos que todas las celdas adyacentes sean NoData.	Boolean
Incorporar todos los atributos del ráster de entrada a las entidades de puntos de salida (Opcional)	Determina si los atributos de ráster se escriben en el dataset de entidades de puntos de salida. Desactivado: solo se agrega el valor del ráster de entrada a los atributos de puntos. Esta es la opción predeterminada. Activado: todos los campos del ráster de entrada (excepto Count) se agregarán a los atributos de puntos.	Boolean

Python

ExtractValuesToPoints(in_point_features, in_raster, out_point_features, {interpolate_values}, {add_attributes})

Nombre	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. NONE—No se aplica interpolación; se utilizará el valor del centro de la celda. Esta es la opción predeterminada. INTERPOLATE—El valor de la celda se calcula a partir de las celdas adyacentes con valores válidos utilizando la interpolación bilineal. Los valores NoData se ignorarán en la interpolación a menos que todas las celdas adyacentes sean NoData.	Boolean
add_attributes (Opcional)	Determina si los atributos de ráster se escriben en el dataset de entidades de puntos de salida. VALUE_ONLY—Solo se agrega el valor del ráster de entrada a los atributos de puntos. Esta es la opción predeterminada. ALL—Todos los campos del ráster de entrada (excepto Count) se agregarán a los atributos de puntos.	Boolean

Muestra de código

Ejemplo 1 de ExtractValuesToPoints (ventana de Python)

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")

Ejemplo 2 de ExtractValuesToPoints (secuencia de comandos independiente)

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

Auto ejecución, Espacio de trabajo actual, Valor Z de salida predeterminado, Extensión, Transformaciones geográficas, Máscara, Resolución M, Tolerancia M, Mantener el índice espacial, Palabra clave CONFIG de salida, Sistema de coordenadas de salida, La salida tiene valores M, La salida tiene valores Z, Palabra clave CONFIG de salida, Dominio XY de salida, Dominio Z de salida, Nombres de campos calificados, Espacio de trabajo temporal, Transferir descripciones de dominio de campo, Resolución XY, Tolerancia XY, Resolución Z, Tolerancia Z