Werte in Punkte extrahieren—Hilfe

Mit der Spatial Analyst-Lizenz verfügbar.

Zusammenfassung
Verwendung
Syntax
Codebeispiel
Umgebungen
Lizenzinformationen

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

Alle Felder aus der Eingabe-Point-Feature-Class werden in die Ausgabe-Point-Feature-Class übernommen.
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 Werte in Punkte extrahieren der Attributtabelle ein neues Feld hinzufügen (beispielsweise RASVAL1), die Werte dafür berechnen und anschließend das ursprüngliche Feld RASTERVALU löschen.
Um Attribute aus der Eingabe-Raster-Tabelle hinzuzufügen, aktivieren Sie die Option Alle Attribute des Eingabe-Rasters an die Ausgabe-Punkt-Features anhängen (ALL für den Parameter add_attributes in Python). Die Attribute werden unverändert und mit denselben Werten in die Ausgabe-Punkt-Features übernommen. Je nach den Merkmalen der Eigenschaft, die erfasst wird, müssen einige der Attributwerte möglicherweise neu berechnet werden.
Beim Shapefile-Format ist die Länge eines Feldnamens auf maximal 10 Zeichen beschränkt. Folglich werden die Namen von Feldern, die an die Attributtabelle eines Ausgabe-Shapefiles angehängt werden, standardmäßig gekürzt und eindeutig gemacht. Dies macht es möglicherweise schwierig, zwischen den Feldern zu unterscheiden, besonders wenn die Namen lang oder sehr ähnlich sind. In diesem Fall sollten Sie stattdessen die Ausgabe in eine File-Geodatabase in Erwägung ziehen.
Wenn ein Multiband-Raster als Eingabe-Raster (in_raster in Python) angegeben wird, wird nur das erste Band verwendet.
Wenn ein anderes Band verarbeitet werden soll, geben Sie dieses Band an.
Um Werte aus mehreren Rastern oder einem Multiband-Raster-Dataset zu extrahieren, verwenden Sie das Werkzeug Mehrfache Werte in Punkte extrahieren.
Positionen, an denen NoData-Zellen im Eingabe-Raster entnommen werden, erhalten einen <NULL>-Wert in einer Ausgabe-Database-Tabelle. Für die Ausgabe in Shapefiles wird der Wert -9999 angegeben, da das Konzept von NULL-Werten nicht unterstützt wird.
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.
Multipoint-Datasets werden nicht als Eingabe unterstützt.
Weitere Informationen zur Geoverarbeitung von Umgebungen mit diesem Werkzeug finden Sie unter Analyseumgebungen und Spatial Analyst.

Syntax

ExtractValuesToPoints (in_point_features, in_raster, out_point_features, {interpolate_values}, {add_attributes})

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 ganzzahliges oder 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. NONE — Es wird keine Interpolation angewendet; der Wert des Zellenmittelpunktes wird verwendet. Dies ist die Standardeinstellung. INTERPOLATE — Der Wert der Zelle wird mit bilinearer Interpolation von den benachbarten Zellen mit gültigen Werten berechnet. NoData-Werte werden in der Interpolation ignoriert, außer wenn alle benachbarten Zellen NoData sind.	Boolean
add_attributes (optional)	Bestimmt, ob die Raster-Attribute in das Ausgabe-Punkt-Feature-Dataset geschrieben werden. VALUE_ONLY — Den Punktattributen wird nur der Wert des Eingabe-Rasters hinzugefügt. Dies ist die Standardeinstellung. ALL — Den Punktattributen werden alle Felder des Eingabe-Rasters (außer Count) hinzugefügt.	Boolean

Codebeispiel

ExtractValuesToPoints – Beispiel 1 (Python-Fenster)

In diesem Beispiel werden die Zellenwerte auf Grundlage von durch ein 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")

ExtractValuesToPoints – Beispiel 2 (eigenständiges Skript)

In diesem Beispiel werden die Zellenwerte auf Grundlage von durch ein Punkt-Shapefile definierten Positionen aus einem Raster extrahiert, und es wird ein 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")

Lizenzinformationen

ArcGIS Desktop Basic: Erfordert Spatial Analyst
ArcGIS Desktop Standard: Erfordert Spatial Analyst
ArcGIS Desktop Advanced: Erfordert Spatial Analyst

ArcMap

Werte in Punkte extrahieren