Mit der Spatial Analyst-Lizenz verfügbar.
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.
Die Eingabe-Raster können zwei- oder mehrdimensional sein. Wenn die Eingabe-Raster mehrdimensional sind, ändert sich die Struktur der Ausgabe-Tabelle.
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 -9999 angegeben, da das Konzept von NULL-Werten nicht unterstützt wird.
Wenn mehr als ein mehrdimensionales Raster bereitgestellt wird, müssen die Dimensionen aller Raster auf die gleiche Weise benannt sein.
Als mehrdimensionale Raster werden ausschließlich NetCDF-Raster-Layer unterstützt.
Enthalten die Eingabe-Raster sowohl zweidimensionale als auch mehrdimensionale Raster, wird nur das aktuelle Segment eines der mehrdimensionalen Raster für die Stichprobe verwendet.
Sind die Eingabe-Raster zweidimensional, ist der Feldtyp der entnommenen Werte in der Tabelle 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.
Weitere Informationen zur Geoverarbeitung von Umgebungen mit diesem Werkzeug finden Sie unter Analyseumgebungen und Spatial Analyst.
Syntax
Sample (in_rasters, in_location_data, out_table, {resampling_type}, {unique_id_field}, {process_as_multidimensional})
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. Die Ausgabe ist standardmäßig eine Geodatabase-Tabelle. Wenn der Pfad sich nicht in einer Geodatabase befindet, wird das Format durch die Erweiterung bestimmt. Wenn die Erweiterung .dbf lautet, erfolgt die Ausgabe im dBASE-Format. Wenn keine Erweiterung angegeben wird, ist die Ausgabe eine INFO-Tabelle. | Table |
resampling_type (optional) | Verwendeter Resampling-Algorithmus bei der Entnahme eines Rasters.
| String |
unique_id_field (optional) | Ein Feld, das für jede Position im Eingabe-Positions-Raster bzw. jedes Feature in den Eingabe-Punkt-Features einen anderen Wert enthält. | Field |
process_as_multidimensional (optional) | Legt fest, wie die Eingabe-Raster verarbeitet werden.
| Boolean |
Codebeispiel
Sample – Beispiel 1 (Python-Fenster)
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")
Sample – Beispiel 2 (eigenständiges Skript)
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)
Umgebungen
Lizenzinformationen
- ArcGIS Desktop Basic: Erfordert Spatial Analyst
- ArcGIS Desktop Standard: Erfordert Spatial Analyst
- ArcGIS Desktop Advanced: Erfordert Spatial Analyst