Hilfe

Stichprobe

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 0 (null) 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})
ParameterErläuterungDatentyp
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 Ausdehnung angegeben wird, erfolgt die Ausgabe in einer INFO-Tabelle.

Table
resampling_type
(optional)

Verwendeter Resampling-Algorithmus bei der Entnahme eines Rasters.

  • NEAREST — Nächster-Nachbar-Resampling
  • BILINEAR — Bilineare Interpolation
  • CUBIC — Kubische Faltung
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.

  • ALL_SLICES — Stichproben werden für alle Dimensionen (z. B. Zeit oder Tiefe) eines mehrdimensionalen Datasets entnommen.
  • CURRENT_SLICE —Stichproben werden aus dem aktuellen Segment eines mehrdimensionalen Datasets entnommen. Dies ist die Standardeinstellung.
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)

Umgebung

Lizenzierungsinformationen

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

Verwandte Themen

Feedback zu diesem Thema?