ArcMap

Extraer valores múltiples a puntos

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 puede modificar el número Id. de los puntos de entrada durante su funcionamiento. Así pues, le recomendamos disponer de un campo de identificador único explícito en la tabla de atributos de su dataset de puntos, en lugar de basarse únicamente en el campo de Id. de objeto proporcionado por el dataset original (que puede ser FID, OID u ObjectID, dependiendo del formato). Una forma fácil de tener uno es agregar un nuevo campo de entero y calcular este valor en él. Esto garantizará que será capaz de volver a relacionar los resultados con la entrada original.

  • 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 ubicaciones que muestran celdas NoData en los rásteres de entrada se les proporcionará un valor <null> cuando las entidades de puntos de entrada estén en una geodatabase. Si la entrada es un shapefile, se asignará un valor de -9999, ya que el concepto de nulo no está admitido.

  • 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ámetroExplicaciónTipo 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.

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

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

  • ArcGIS Desktop Basic: Requiere Análisis espacial
  • ArcGIS Desktop Standard: Requiere Análisis espacial
  • ArcGIS Desktop Advanced: Requiere Análisis espacial

Temas relacionados