Extract Values to Points (Spatial Analyst)
Zusammenfassung
Extrahiert die Zellenwerte von einem Raster auf Grundlage einer Reihe von Punkt-Features und zeichnet die Werte in der Attributtabelle einer Ausgabe-Feature-Class auf.
Verwendung
Die Ausgabe-Punkt-Feature-Class enthält alle Felder aus der Eingabe-Punkt-Feature-Class.
-
Der Ausgabe-Feature-Class wird ein neues Feld namens RASTERVALU hinzugefügt.
Hinweis:Dieses Feld darf nicht bereits in der Attributtabelle der Eingabe-Features vorhanden sein. Andernfalls tritt ein Fehler auf. Wenn Sie die ursprünglichen Informationen beibehalten möchten, können Sie vor Ausführung von Extract Values to Points der Attributtabelle ein neues Feld hinzufügen (beispielsweise RASVAL1), die Werte dafür berechnen und anschließend das ursprüngliche Feld RASTERVALUE löschen.
-
Wenn Extract Values to Points mit einem Multiband-Raster verwendet wird, enthält das Feld RASTERVALU Werte vom letzten Band des Eingabe-Rasters. Um Werte aus mehreren Rastern oder einem Multiband-Raster-Dataset zu extrahieren, verwenden Sie das Werkzeug Extract Multi Values to Points.
-
Für das Feld RASTERVALU der Attributtabelle erhalten NoData-Zellen im Wert-Raster den Wert -9999.
-
Die Interpolationsoption bestimmt, wie die Werte aus dem Raster abgerufen werden. Standardmäßig wird der Wert im Mittelpunkt der berechneten Zelle verwendet. Die Interpolationsoption interpoliert einen Wert für den Zellenmittelpunkt mithilfe bilinearer Interpolation.
-
Wenn das Eingabe-Raster ein Gleitkomma-Raster ist, enthält das resultierende Ausgabepunkt-Dataset nur Attribute von den Eingabe-Feature-Daten und den Wert der Zelle, wie durch die Interpolationsoption bestimmt.
-
Wenn die Attribute aus dem Eingabe-Raster hinzugefügt werden, kann es keine Felder im Eingabe-Raster mit einem Namen von mehr als 10 Zeichen geben, wenn das Ausgabe-Punkt-Feature-Dataset ein Shapefile ist. Wenn solche Namen vorliegen, müssen diese Felder vor dem Ausführen des Werkzeugs umbenannt werden.
Syntax
| Parameter | Erläuterung | Datentyp |
in_point_features |
Die Eingabe-Punkt-Features, die die Positionen definieren, von denen Sie die Raster-Zellenwerte extrahieren möchten. | Feature Layer |
in_raster |
Das Raster-Dataset, dessen Werte extrahiert werden. Das Raster kann ein Ganzzahl- oder ein Gleitkomma-Raster sein. | Raster Layer |
out_point_features |
Das Ausgabe-Punkt-Feature-Dataset, das die extrahierten Raster-Werte enthält. | Feature Class |
interpolate_values (optional) |
Gibt an, ob die Interpolation verwendet wird.
| Boolean |
add_attributes (optional) |
Bestimmt, ob die Raster-Attribute in das Ausgabe-Punkt-Feature-Dataset geschrieben werden.
| Boolean |
Codebeispiel
In diesem Beispiel werden die Zellenwerte auf Grundlage von durch einen Punkt-Shapefile definierten Positionen aus einem Raster extrahiert, und es wird eine Ausgabe-Point-Feature-Class dieser Werte erstellt.
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")
In diesem Beispiel werden die Zellenwerte auf Grundlage von durch einen Punkt-Shapefile definierten Positionen aus einem Raster extrahiert, und es wird eine Ausgabe-Punkt-Shapefile dieser Werte erstellt.
# 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")