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

  • Esta herramienta modifica las entidades de punto de entrada y puede cambiar su Id. de entidad interna, que puede denominarse ObjectID, FID u OID. Se recomienda incluir un campo de Id. único en 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 extraerán 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.

  • En el formato shapefile, la longitud máxima de un nombre de campo está limitada a 10 caracteres. 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 recomienda copiar el shapefile de entrada en una geodatabase de archivos y utilizar la clase de entidad para el análisis.

  • Si los valores de Entidades de punto de entrada (in_point_features en Python) se definen mediante una capa de eventos XY, la tabla de eventos subyacente se actualiza directamente. La herramienta fallará si la tabla subyacente es de solo lectura.

  • Si el valor de Entidades de puntos de entrada es una clase de entidad de puntos sin ningún índice espacial, se emitirá una advertencia. Para mejorar el rendimiento de la herramienta para una entrada con un gran número de puntos, cree un índice espacial. Consulte la herramienta Agregar índice espacial para obtener más información.

  • 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.

  • Se puede especificar cualquier combinación de rásteres (de banda única o multibanda) para el parámetro Rásteres de entrada (in_rasters en Python).

  • Cuando se especifica un ráster multibanda como uno de los valores de 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 formado por esas bandas concretas con la herramienta Bandas compuestas. A continuación, 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 las 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.

  • El parámetro Interpolación bilineal de valores en ubicaciones de punto (bilinear_interpolate_values en Python) especifica si se va a utilizar la interpolación para obtener valores del ráster. La opción predeterminada consiste en extraer el valor de celda exacto en las ubicaciones de entrada. Para extraer valores interpolados mediante el método bilineal, active este parámetro (bilinear_interpolate_values = "BILINEAR" en Python).

  • Si se especifica una entidad en el entorno 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 válidos para esta herramienta.

Parámetros

EtiquetaExplicaciónTipo de datos
Entidades de puntos de entrada

Las entidades de punto de entrada a las que se agregarán los valores de ráster.

Feature Layer
Rásteres de entrada

Los valores del ráster (o rásteres) de entrada que se van a 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
Interpolación bilineal de valores en ubicaciones de punto
(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

Salida derivada

EtiquetaExplicaciónTipo de datos
Entidades de puntos actualizadas

Las entidades de punto actualizadas.

Feature Class

ExtractMultiValuesToPoints(in_point_features, in_rasters, {bilinear_interpolate_values})
NombreExplicaciónTipo de datos
in_point_features

Las entidades de punto de entrada a las que se agregarán los valores de ráster.

Feature Layer
in_rasters
[Raster, {Output Field Name}]

Los valores del ráster (o rásteres) de entrada que se van a 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 lineal.

  • NONENo se aplica interpolación; se utilizará el valor del centro de la celda. Esta es la opción predeterminada.
  • BILINEAREl 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

Salida derivada

NombreExplicaciónTipo de datos
out_point_features

Las entidades de punto actualizadas.

Feature Class

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

# Execute ExtractValuesToPoints
ExtractMultiValuesToPoints(inPointFeatures, inRasterList, "BILINEAR")