Stichprobe (Spatial Analyst)
Zusammenfassung
Erstellt eine Tabelle, die für definierte Positionen die Werte der Zellen aus einem Raster oder einer Gruppe von Rastern anzeigt. Die Positionen werden durch Raster-Zellen oder eine Menge von Punkten definiert.
Weitere Informationen zur Funktionsweise des Werkzeugs "Stichprobe"
Verwendung
-
Wenn die Eingabeposition ein Raster ist, besteht die Menge der Positionszellen aus allen Zellen, die einen Wert von größer oder gleich 0 aufweisen. Zellen mit NoData-Werten sind nicht in der Positionsmenge enthalten. Ein Positions-Raster kann problemlos mit den Extraktionswerkzeugen erstellt werden.
-
Positionen, an denen NoData-Zellen im Eingabe-Raster bzw. in den Eingabe-Rastern entnommen werden, erhalten einen <NULL>-Wert. Für die Ausgabe in INFO oder DBF wird der Wert 0 (null) angegeben, da das Konzept von NULL-Werten nicht unterstützt wird.
-
Der Feldtyp der entnommenen Werte in der Tabelle ist immer ein Gleitkommawert. Dies dient dazu, sicherzustellen, dass der entsprechende Genauigkeitswert beibehalten wird, wenn die Optionen "Bilinear" oder "Kubisch" als Resampling-Methode ausgewählt werden müssen.
-
Wenn die Positionseingabe Raster ist, sollten Zellengröße und Registrierung von Eingabe-Rastern und Positions-Raster identisch sein, um optimale Ergebnisse zu erzielen.
-
Die Ausgabe bei diesem Werkzeug erfolgt in Form einer Tabelle.
Multipoint-Datasets werden nicht als Eingabe unterstützt.
Syntax
| Parameter | Erläuterung | Datentyp |
in_rasters [in_raster,...] |
Die Liste der Raster, deren Werte auf der Grundlage der Eingabepositionsdaten entnommen werden. | Raster Layer |
in_location_data |
Daten, die Positionen identifizieren, an denen eine Stichprobe entnommen werden soll. Hierbei kann es sich um ein Raster oder ein Punkt-Feature-Dataset handeln. | Raster Layer | Feature Layer |
out_table |
Ausgabetabelle, die die entnommenen Zellenwerte enthält. Das Format der Tabelle wird durch das Ausgabeverzeichnis und den Ausgabepfad bestimmt. Wenn keine Ausdehnung angegeben wird, ist es eine INFO-Tabelle. Wenn die Position sich in einer Geodatabase befindet, wird die Ausgabetabelle im entsprechenden Typ (z. B. Datei oder ArcSDE-Geodatabase) erstellt. Wenn der Name die Erweiterung .dbf beinhaltet, erfolgt die Ausgabe im dBASE-Format. | Table |
resampling_type (optional) |
Verwendeter Resampling-Algorithmus bei der Entnahme eines Rasters.
| String |
Codebeispiel
Extrahieren der Zellenwerte aus mehreren Rastern in eine Tabelle, die auf Eingabepositionen beruht.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
Sample(["elevation", "costraster"], "observers.shp",
"c:/sapyexamples/output/samptable","NEAREST")
Extrahieren der Zellenwerte aus mehreren Rastern in eine Tabelle, die auf Eingabepositionen beruht.
# Name: Sample_Ex_02.py
# Description: Creates a table that shows the values of cells from
# a raster, or set of rasters, for defined locations.
# The locations are defined by raster cells or by 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
inRasters = ["elevation",
"costraster"]
locations = "observers.shp"
outTable = "c:/sapyexamples/output/samptable02"
sampMethod = "NEAREST"
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute Sample
Sample(inRasters, locations, outTable, sampMethod)