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.
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 y luego eliminar 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.
-
Para el campo RASTERVALU de la tabla de atributos, las celdas NoData en el ráster de valor recibirán un valor de -9999.
-
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 sólo 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.
Sintaxis
| 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.
| Boolean |
add_attributes (Opcional) |
Determina si los atributos de ráster se escriben en el dataset de entidades de puntos de salida.
| Boolean |
Ejemplo de código
Este ejemplo extrae los valores de celda desde un ráster en base a 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")
Este ejemplo extrae los valores de celda desde un ráster en base a 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")