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 punto de entrada se incluirán en la clase de entidad de punto de salida.

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

  Nota:

  Este campo no puede existir de antemano en la tabla de atributos de las entidades de entrada. Si este es el caso, se producirá un error. Si desea mantener la información original, antes de llevar a cabo Extraer valores según puntos puede agregar un nuevo campo (por ejemplo, RASVAL1) a la tabla de atributos, calcular los valores para él y eliminar luego el campo RASTERVALUE original.

• Cuando se utiliza Extraer valores según puntos en un ráster multibanda, el campo RASTERVALU incluirá valores desde la última banda del ráster de entrada. 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.

• Si el ráster de entrada es del tipo punto flotante, el dataset de puntos de salida resultante solo incluirá atributos de los datos de entidad de entrada y el valor de la celda, como determina la opción de interpolación.

• Cuando agrega los atributos desde el ráster de entrada, si el dataset de entidad de punto de salida es un shapefile, no puede haber ningún campo en el ráster de entrada con un nombre que tenga más de 10 caracteres de longitud. Si existen, se debe cambiar el nombre de estos campos antes de ejecutar la herramienta.

• 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á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 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 Cuenta) 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

• 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
• Dominio M de salida
• Dominio XY de salida
• Dominio Z de salida
• Nombres de campos calificados
• Espacio de trabajo temporal
• Alinear ráster
• Descripciones de dominio de campo de transferencia
• Resolución XY
• Tolerancia XY
• Resolución Z
• Tolerancia Z

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