ArcMap

Extraer valores según puntos

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.

  • La clase de entidad de salida tendrá agregado un nuevo campo, llamado RASTERVALU.

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

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

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

  • A las ubicaciones que muestran celdas NoData en el ráster de entrada se les proporcionará un valor <null> en una tabla de geodatabases de salida. Para la salida a shapefiles, se asignará un valor de -9999, ya que el concepto de nulo no está admitido.

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

ExtractValuesToPoints (in_point_features, in_raster, out_point_features, {interpolate_values}, {add_attributes})
ParámetroExplicaciónTipo 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 o no.

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

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Execute ExtractValuesToPoints
ExtractValuesToPoints(inPointFeatures, inRaster, outPointFeatures,
                      "INTERPOLATE", "VALUE_ONLY")

Entornos

Información sobre licencias

  • ArcGIS Desktop Basic: Requiere Spatial Analyst
  • ArcGIS Desktop Standard: Requiere Spatial Analyst
  • ArcGIS Desktop Advanced: Requiere Spatial Analyst

Temas relacionados