ArcMap

Mehrfache Werte in Punkte extrahieren

Mit der Spatial Analyst-Lizenz verfügbar.

Zusammenfassung

Extrahiert Zellenwerte an Positionen, die in einer Point-Feature-Class angeben sind, aus einem oder mehreren Rastern und zeichnet die Werte in der Attributtabelle der Point-Feature-Class auf.

Verwendung

  • Mit diesem Werkzeug kann die ID-Nummer für die Eingabepunkte während der Operation geändert werden. Aus diesem Grund sollte ein explizites eindeutiges Kennungsfeld in der Attributtabelle des Eingabe-Punkt-Datasets vorhanden sein, anstatt sich nur auf das vom ursprünglichen Dataset bereitgestellte Objekt-ID-Feld (das je nach Format ein FID-, OID- oder ObjectID-Feld sein kann) zu verlassen. Eine einfache Möglichkeit hierzu besteht darin, ein neues ganzzahliges Feld hinzuzufügen und diesen Wert darin zu berechnen. Dadurch wird sichergestellt, dass Sie die Ergebnisse auf die ursprüngliche Eingabe verweisen können.

  • Jede beliebige Kombination von Rastern (Einzelband- oder Multiband-Raster) kann als Eingabe angegeben werden.

  • Für jedes Eingabe-Raster wird ein Zellenwert extrahiert, und ein neues Feld, das die Zellenwerte für jedes Eingabe-Raster enthält, wird an die Eingabe-Point-Feature-Class angefügt.

  • Die Namen von Ausgabefeldern werden standardmäßig aus dem Namen des Eingabe-Rasters erstellt. Andernfalls können Sie einen eindeutigen Namen für jedes Feld angeben, in dem Rasterwerte gespeichert werden sollen.

  • Wenn die Eingabe ein Multiband-Raster ist, wird für alle Bänder ein Feld hinzugefügt. Dabei wird dem Namen des Ausgabefeldes das Präfix b1_, b2_, …bn hinzugefügt, das die Bandnummer angibt.

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

  • Shapefile-Formate weisen eine Längenbeschränkung von maximal 10 Zeichen für Felder auf. An das Eingabe-Shapefile angefügte Ausgabefelder werden standardmäßig abgeschnitten und eindeutig gemacht. Dies macht es möglicherweise schwierig, zwischen Eingabe-Rastern zu unterscheiden, wenn die Namen lang oder sehr ähnlich sind. In diesem Fall sollten Sie die Features am besten in eine File-Geodatabase konvertieren und diese stattdessen als Eingabe verwenden.

  • Positionen, an denen NoData-Zellen im Eingabe-Raster bzw. in den Eingabe-Rastern entnommen werden, erhalten einen <NULL>-Wert, wenn die Eingabe-Punkt-Features sich in einer Geodatabase befinden. Wenn die Eingabe ein Shapefile ist, wird der Wert -9999 angegeben, da das Konzept von NULL-Werten nicht unterstützt wird.

  • 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

ExtractMultiValuesToPoints (in_point_features, in_rasters, {bilinear_interpolate_values})
ParameterErläuterungDatentyp
in_point_features

Die Eingabe-Punkt-Features, zu denen Sie Raster-Werte hinzufügen möchten.

Feature Layer
in_rasters
[[Raster, {Output Field Name}],...]

Die Werte des Eingabe-Rasters (bzw. der Eingabe-Raster), die auf der Grundlage der Eingabe-Punkt-Feature-Position extrahiert werden sollen.

Optional können Sie den Namen für das Feld angeben, in dem der Raster-Wert gespeichert werden soll. Standardmäßig wird ein eindeutiger Feldname auf der Grundlage des Namens des Eingabe-Raster-Datasets erstellt.

Value Table
bilinear_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.
  • BILINEAR — 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

Codebeispiel

ExtractMultiValuesToPoints – Beispiel 1 (Python-Fenster)

Extrahieren der Zellenwerte aus mehreren Rastern in Attribute in einer Point-Shapefile-Feature-Class.

import arcpy
from arcpy.sa import *
from arcpy import env 
env.workspace = "c:/sapyexamples/data"
ExtractMultiValuesToPoints("observers.shp", [["elevation", "ELEV"], 
                           ["costraster", "COST"], ["flowdir", "DIR"]], "NONE")
ExtractMultiValuesToPoints – Beispiel 2 (eigenständiges Skript)

Extrahieren der Zellenwerte aus mehreren Rastern mittels Interpolation in Attribute in einer Point-Shapefile-Feature-Class.

# Name: ExtractMultiValuesToPoints_Ex_02.py
# Description: Extracts the cells of multiple rasters as attributes in
#    an output point feature class.  This example takes a multiband IMG
#    and two GRID files as input.
# 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 = "poi.shp"
inRasterList = [["doqq.img", "doqqval"], ["redstd", "focalstd"], 
                ["redmin", "focalmin"]]

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

# Execute ExtractValuesToPoints
ExtractMultiValuesToPoints(inPointFeatures, inRasterList, "BILINEAR")

Umgebungen

Lizenzinformationen

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

Verwandte Themen