| Beschriftung | Erläuterung | Datentyp |
Eingabe-Raster | Die Raster mit Werten, die auf der Grundlage der Eingabepositionsdaten entnommen werden. Der Parameter Als multidimensional verarbeiten ist nur verfügbar, wenn die Eingabe ein einzelnes multidimensionales Raster ist. | Raster Layer |
Eingabe-Positions-Raster oder -Features | Daten, die Positionen identifizieren, an denen eine Stichprobe entnommen wird. Die Eingabe kann ein Raster oder eine Feature-Class sein. | Raster Layer; Feature Layer |
Ausgabetabelle oder -Feature-Class | Die Ausgabetabelle oder -Feature-Class mit den entnommenen Zellenwerten. Das Ausgabeformat wird durch die Ausgabeposition und den Ausgabepfad bestimmt. Die Ausgabe ist standardmäßig eine Geodatabase-Tabelle oder eine Geodatabase-Feature-Class in einem Geodatabase-Workspace oder eine dBASE-Tabelle oder eine Shapefile-Feature-Class in einem Ordner-Workspace. Der Ausgabedatentyp zum Generieren einer Tabelle oder einer Feature-Class wird durch den Parameter Feature-Class generieren gesteuert. | Table; Point feature class |
Resampling-Methode (optional) | Der Resampling-Algorithmus, mit dem eine Stichprobe aus einem Raster entnommen wird, um zu bestimmen, wie die Werte aus dem Raster abgerufen werden.
| String |
Feld für die eindeutige ID (optional) | Ein Feld, das für jede Position oder jedes Feature im Eingabe-Positions-Raster oder den Eingabe-Features einen anderen Wert enthält. | Field |
Als multidimensional verarbeiten (optional) | Gibt an, wie die Eingabe-Raster verarbeitet werden. Dieser Parameter ist nur verfügbar, wenn die Eingabe ein einzelnes multidimensionales Raster ist.
| Boolean |
Erfassungsinformationen zu Positionsdaten (optional) | Gibt die Zeit, Tiefe oder andere Erfassungsdaten im Zusammenhang mit den Positions-Features an. Es werden nur die folgenden Kombinationen unterstützt:
Für Relativer Wert oder Tage vorher und Relativer Wert oder Tage danach werden nur nicht negative Werte unterstützt. Für Variablen in diesem Dimensionsbereich werden mithilfe des Parameters Statistiktyp Statistiken berechnet. | Value Table |
Statistiktyp (optional) | Gibt den zu berechnenden Statistiktyp an.
| String |
Perzentilwert (optional) | Dieser Wert kann im Bereich von 0 bis 100 liegen. Der Standardwert ist 90. | Double |
Feld oder Wert für Pufferabstand (optional) | Der Abstand um die Positionsdaten-Features. Der Pufferabstand wird in der linearen Einheit des Raumbezugs des Positions-Features angegeben. Wenn für das Feature ein geographischer Bezug verwendet wird, ist die Einheit Grad. Die Statistiken werden in diesem Pufferbereich berechnet. | Double; Field |
Layout als Spalten (optional) | Gibt an, ob die Stichprobenwerte in der Ausgabetabelle in Zeilen oder Spalten angezeigt werden.
| Boolean |
Feature-Class generieren (optional) | Gibt an, ob eine Point-Feature-Class mit Stichprobenwerten in der Attributtabelle oder nur eine Tabelle mit Stichprobenwerten generiert wird.
| Boolean |
Mit der Spatial Analyst-Lizenz verfügbar.
Mit der Image Analyst-Lizenz verfügbar.
Zusammenfassung
Erstellt eine Tabelle oder eine Point-Feature-Class, die für definierte Positionen die Werte der Zellen aus einem Raster oder einer Gruppe von Rastern anzeigt. Die Positionen werden durch Raster-Zellen, Punkte, Polylinien oder Polygone definiert.
Weitere Informationen zur Funktionsweise des Werkzeugs "Stichprobe"
Verwendung
Aus allen Eingabe-Rastern (in_rasters in Python) werden an jeder Position Zellenwerte extrahiert. Es wird eine Tabelle oder eine Point-Feature-Class mit Feldern erstellt, die die Zellenwerte für die einzelnen Eingabe-Raster enthalten.
Zusätzliche Attribute aus der Eingabe-Raster-Tabelle, sofern vorhanden, werden nicht in die Ausgabetabelle übernommen.
Jede beliebige Kombination von Rastern (Einzelband- oder Multiband-Raster) kann als Eingabe-Raster angegeben werden. Wenn die Eingabe-Raster multidimensional sind, ändert sich die Struktur der Ausgabe-Tabelle automatisch.
Wenn ein Multiband-Raster als eines der Eingabe-Raster angegeben wird, werden alle Bänder in dieser Eingabe verwendet.
Folgendes kann als Parameterwert für Eingabe-Positions-Raster oder -Features (in_location_data in Python) verwendet werden:
- Raster: Zellen, die gültige Werte (keine NoData-Werte) enthalten, werden verwendet, um die Zellenwerte aus allen Eingabe-Rastern zu extrahieren, und der Mittelpunkt der Zelle wird als Punktposition verwendet.
- Punkt: Stichproben werden an jeder Punktposition genommen.
- Polylinie oder Polygon: Es wird der Mittelwert aller Zellen berechnet, die die einzelnen Polylinien oder Polygone schneiden, wenn es sich bei der Eingabe um ein zweidimensionales Raster oder um mehrere Raster handelt. Es können zusätzliche Statistiktypen angegeben werden, wenn die Eingabe ein multidimensionales Raster ist und als solches verarbeitet wird.
Positionen, mit denen Werte aus NoData-Zellen im Eingabe-Raster extrahiert werden, erhalten in der Ausgabetabelle einen <NULL>-Wert. Da für Shapefiles NULL-Felder nicht unterstützt werden, werden NoData-Zellen stattdessen mit dem Wert -9999 in der Tabelle dargestellt.
Dem Eingabe-Raster werden Stichproben mit dem ursprünglichen Raumbezug und der ursprünglichen Auflösung entnommen. Wenn mehrere Eingabe-Raster mit unterschiedlichen Raumbezügen vorhanden sind, werden die Eingabepositionen zunächst einzeln auf die Raumbezüge jedes Rasters projiziert; anschließend werden die Werte extrahiert. Das bedeutet, dass die entsprechenden Umgebungen auf die Eingabepositionen angewendet werden, obwohl die Umgebungseinstellungen für die Analyse in den Eingabe-Rastern nicht berücksichtigt werden.
Standardmäßig ist der Raumbezug der XY-Koordinaten im Parameter Ausgabetabelle oder Feature-Class (out_table in Python) derselbe wie der des Parameters Eingabe-Positions-Raster oder -Features, sofern in der Umgebung "Ausgabekoordinatensystem" kein anderer angegeben ist. Ist der Raumbezug der Eingabepositionsdaten unbekannt, ist der Raumbezug der XY-Koordinaten ebenfalls unbekannt.
Der Raumbezug der XY-Koordinaten wird am Ende der Werkzeugausführung in einer Geoverarbeitungsmeldung angezeigt.
Wenn es sich bei dem Eingabe-Positions-Raster oder -Feature um eine Point-Feature-Class ohne räumlichen Index handelt, wird eine Warnung ausgegeben. Erstellen Sie einen räumlichen Index, um die Performance des Werkzeugs für eine Eingabe mit einer großen Anzahl Punkte zu verbessern. Weitere Informationen finden Sie unter Räumlichen Index hinzufügen.
Das Werkzeug kann nicht mit Multipoint-Features ausgeführt werden. Für die Analyse mit Multipoint-Features müssen Sie diese in Singlepoint-Features konvertieren, bevor Sie sie im Extraktionswerkzeug verwenden können. Weitere Informationen finden Sie unter Verarbeiten von Multipoint-Daten.
Wenn der Parameter Resampling-Methode auf Nächster festgelegt wurde (resampling_type = "NEAREST" in Python), stimmt der Feldtyp in der Ausgabetabelle mit dem des Raster-Typs überein. Bei der Resampling-Option Bilinear oder Kubisch ist der Feldtyp stets "Gleitkomma", um die Genauigkeit der interpolierten Werte zu erhalten.
Der Ausgabetabelle wird ein Feld hinzugefügt, um die Werte zu speichern, die im Parameter Eindeutiges ID-Feldangegeben sind (unique_id_field in Python). Standardmäßig stimmt der Name des Feldes mit dem des Datasets mit der Eingabeposition überein. Es wird für die weitere Analyse empfohlen, ein Feld mit Einzelwerten als Kennung für die Positionen zu verwenden.
Wenn der Parameter Als multidimensional verarbeiten deaktiviert ist (process_as_multidimensional = "CURRENT_SLICE" in Python), gelten die folgenden Bedingungen:
- Wenn die Eingabe ein multidimensionales Raster ist, wird nur der aktuelle Ausschnitt für die Stichprobe verwendet.
- Wenn die Eingabe ein multivariates Raster ist, wird nur die aktuelle Variable für die Stichprobe verwendet.
Wenn der Parameter Als multidimensional verarbeiten aktiviert ist (process_as_multidimensional = "ALL_SLICES" in Python), gelten die folgenden Bedingungen:
- Wenn die Eingabe ein multidimensionales Raster ist, werden alle Ausschnitte für die Stichprobe verwendet.
- Wenn die Eingabe ein multivariates Raster ist, werden alle Variablen für die Stichprobe verwendet.
- Wenn die Eingabe ein multidimensionales Raster mit mehreren Variablen ist, werden alle Ausschnitte aus allen Variablen für die Stichprobe verwendet. Die Variablen müssen dieselben Dimensionen aufweisen.
Wenn der Parameter Als multidimensional verarbeiten aktiviert ist (process_as_multidimensional = "ALL_SLICES" in Python), findet das entsprechende folgende Szenario Anwendung:
Der Parameter Erfassungsinformationen zu Positionsdaten angeben (acquisition_definition in Python) wird verwendet, um die Teilmenge des Eingabe-Rasters anzugeben, die für Stichproben verwendet werden soll.
Wenn Dimension, Startwert und Endwert angegeben werden, dann werden die Ausschnitte innerhalb des Start- und Endwertes verarbeitet. Der Standardendwert ist der maximale Dimensionswert. Geben Sie den Wert für eine Zeitdimension im Standardformat an. Geben Sie den Wert für andere Dimensionen in der Einheit an, die auch für das Eingabe-Raster verwendet wird.
Wenn Dimension, Startfeld und Endfeld angegeben werden (Startfeld und Endfeld stammen aus den Positionsdaten), dann werden Werte aus diesen Feldern verwendet, um eine Teilmenge des Eingabe-Rasters während der Entnahme von Stichprobenwerten an dieser Position anzugeben.
Die Werte für Relativer Wert oder Tage vorher und Relativer Wert oder Tage danach können verwendet werden, um eine Teilmenge in Bezug auf den Startwert anzugeben, wobei der Vorher-Wert den Anfang der Teilmenge und der Nachher-Wert das Ende der Teilmenge definiert. Die Zeitwerte werden in Tagen und die anderen Dimensionswerte in derselben Einheit angegeben, die auch für das Eingabe-Raster verwendet wird.
Der Parameter Statistiktyp (statistics_type in Python) aggregiert die Werte des Parameters Eingabe-Raster gemäß der Teilmenge im Parameter Erfassungsinformationen zu Positionsdaten.
Wenn der Parameter Layout in Spalten deaktiviert ist (layout = "ROW_WISE" in Python), werden die extrahierten Werte in einem Feld mit dem Namen der Variablen gespeichert. Es werden zusätzliche Felder erstellt, um die nichträumlichen Dimensionswerte zu speichern. Dazu wird der Name der Dimension verwendet.
Wenn der Parameter Layout in Spalten deaktiviert ist (layout = "COLUMN_WISE" in Python), werden die extrahierten Werte in Feldern mit Namen gespeichert, die einer <variable_name>_<dimension_name>_<dimension_value>-Konvention folgen. Der Parameter Layout in Spalten wird unterstützt, wenn das multidimensionale Raster nur eine Variable, die Variable nur eine Dimension und jedes Segment ein Einzelband enthält. Ist dies nicht der Fall, wird eine Fehlermeldung generiert.
Wenn das multidimensionale Raster mehrere Bänder enthält, wird für jedes Band ein zusätzliches Feld erstellt, in dem der aus dem jeweiligen Band extrahierte Wert gespeichert wird.
Positionen, mit denen Werte aus NoData-Zellen extrahiert werden, wird der NoData-Wert aus dem multidimensionalen Eingabe-Raster zugewiesen.
Ein multidimensionales Raster kann ein netCDF-Raster-Layer, ein multidimensionaler Raster-layer, ein multidimensionales Mosaik-Dataset, ein multidimensionales CRF, ein multidimensionaler Image-Service oder eine netCDF-Datei sein. Sie können vom Werkzeugdialogfeld nicht zu einer netCDF-Datei navigieren, aber Sie können den Pfad zu der Datei angeben.
Wenn der Parameter Feature-Class generieren aktiviert ist (generate_feature_class = "FEATURE_CLASS" in Python), ist die Ausgabe eine Point-Feature-Class mit den Stichprobenwerten in der Attributtabelle. Im Folgenden sind die möglichen Positionstypen mit einer Beschreibung, wie die Stichprobenwerte genommen werden, aufgeführt:
- Raster: Punkte werden unter Verwendung der Position des Zellenmittelpunktes erstellt.
- Punkt: An jeder Punktposition wird ein Punkt erstellt.
- Polylinie oder Polygon: An jedem Polygon- oder Polylinien-Schwerpunkt wird ein Punkt erstellt.
Der Raumbezug der Ausgabe-Feature-Class entspricht dem der Eingabe-Positions-Raster oder -Features, sofern der Raumbezug nicht in der Umgebung "Ausgabekoordinatensystem" angegeben wurde.
Die Umgebungseinstellung "Faktor für parallele Verarbeitung" wird nur unterstützt, wenn der Parameter Als multidimensional verarbeiten aktiviert ist.
Wenn in der Umgebungseinstellung Maske ein Feature angegeben wurde, wird mit der minimalen Zellengröße der Eingabe-Raster ein internes Raster erstellt. Während der Extraktion wird für das interne Masken-Raster ein Resampling auf die Zellengröße jedes Eingabe-Rasters durchgeführt.
Weitere Informationen zu den Geoverarbeitungsumgebungen für dieses Werkzeug finden Sie unter Analyseumgebungen und Spatial Analyst.
Parameter
Sample(in_rasters, in_location_data, out_table, {resampling_type}, {unique_id_field}, {process_as_multidimensional}, {acquisition_definition}, {statistics_type}, {percentile_value}, {buffer_distance}, {layout}, {generate_feature_class})| Name | Erläuterung | Datentyp |
in_rasters [in_raster,...] | Die Raster mit Werten, die auf der Grundlage der Eingabepositionsdaten entnommen werden. Der Parameter process_as_multidimensional wird nur unterstützt, wenn die Eingabe ein einzelnes multidimensionales Raster ist. | Raster Layer |
in_location_data | Daten, die Positionen identifizieren, an denen eine Stichprobe entnommen wird. Die Eingabe kann ein Raster oder eine Feature-Class sein. | Raster Layer; Feature Layer |
out_table | Die Ausgabetabelle oder -Feature-Class mit den entnommenen Zellenwerten. Das Ausgabeformat wird durch die Ausgabeposition und den Ausgabepfad bestimmt. Die Ausgabe ist standardmäßig eine Geodatabase-Tabelle oder eine Geodatabase-Feature-Class in einem Geodatabase-Workspace oder eine dBASE-Tabelle oder eine Shapefile-Feature-Class in einem Ordner-Workspace. Der Ausgabedatentyp zum Generieren einer Tabelle oder einer Feature-Class wird durch den Parameter generate_feature_class gesteuert. | Table; Point feature class |
resampling_type (optional) | Der Resampling-Algorithmus, mit dem eine Stichprobe aus einem Raster entnommen wird, um zu bestimmen, wie die Werte aus dem Raster abgerufen werden.
| String |
unique_id_field (optional) | Ein Feld, das für jede Position oder jedes Feature im Eingabe-Positions-Raster oder den Eingabe-Features einen anderen Wert enthält. | Field |
process_as_multidimensional (optional) | Gibt an, wie die Eingabe-Raster verarbeitet werden. Dieser Parameter ist nur verfügbar, wenn die Eingabe ein einzelnes multidimensionales Raster ist.
| Boolean |
acquisition_definition [acquisition_definition,...] (optional) | Gibt die Zeit, Tiefe oder andere Erfassungsdaten im Zusammenhang mit den Positions-Features an. Es werden nur die folgenden Kombinationen unterstützt:
Für Relative value or days before und Relative value or days after werden nur nicht negative Werte unterstützt. Für Variablen in diesem Dimensionsbereich werden mithilfe des Parameters statistics_type Statistiken berechnet. | Value Table |
statistics_type (optional) | Gibt den zu berechnenden Statistiktyp an.
| String |
percentile_value (optional) | Das Perzentil, das berechnet wird, wenn der Parameter Statistiktyp auf Perzentil festgelegt wurde. Das Perzentil, das berechnet wird, wenn der Parameter statistics_type auf PERCENTILE festgelegt wurde. Dieser Wert kann im Bereich von 0 bis 100 liegen. Der Standardwert ist 90. | Double |
buffer_distance (optional) | Der Abstand um die Positionsdaten-Features. Der Pufferabstand wird in der linearen Einheit des Raumbezugs des Positions-Features angegeben. Wenn für das Feature ein geographischer Bezug verwendet wird, ist die Einheit Grad. Die Statistiken werden in diesem Pufferbereich berechnet. | Double; Field |
layout (optional) | Gibt an, ob die Stichprobenwerte in der Ausgabetabelle in Zeilen oder Spalten angezeigt werden.
| Boolean |
generate_feature_class (optional) | Gibt an, ob eine Point-Feature-Class mit Stichprobenwerten in der Attributtabelle oder nur eine Tabelle mit Stichprobenwerten generiert wird.
| Boolean |
Codebeispiel
Extrahieren der Zellenwerte aus mehreren Rastern in eine Tabelle, die auf Eingabepositionen beruht.
import arcpy
from arcpy import env
from arcpy.ia import *
env.workspace = "C:/iapyexamples/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: Image Analyst Extension
# Import system modules
import arcpy
from arcpy import env
from arcpy.ia import *
# Set environment settings
env.workspace = "C:/iapyexamples/data"
# Set local variables
inRasters = ["elevation",
"costraster"]
locations = "observers.shp"
outTable = "c:/sapyexamples/output/samptable02"
sampMethod = "NEAREST"
# Check out the ArcGIS Image Analyst extension license
arcpy.CheckOutExtension("ImageAnalyst")
# Execute Sample
Sample(inRasters, locations, outTable, sampMethod)Extrahieren der Zellenwerte aus mehreren Rastern in eine Tabelle, die auf Eingabepositionen beruht.
# Name: Sample_Ex_03.py
# Description: Creates a table that shows the temperature values from
# a multidimensional raster, for defined locations.
# The locations are defined by a set
# of points.
# Requirements: Image Analyst Extension
# Import system modules
import arcpy
from arcpy import env
from arcpy.ia import *
# Set environment settings
env.workspace = "C:/iapyexamples/data"
# Set local variables
inRasters = "temperature_1990_2019.nc"
locations = "observers.shp"
outTable = "C:/iapyexamples/output/samptable_03"
sampMethod = ""
uniqueIDField = "FID"
process_as_multidimensional = True
# Check out the ArcGIS Image Analyst extension license
arcpy.CheckOutExtension("ImageAnalyst")
# Execute Sample
# the temperature value at each slice in temperature_1990_2019.nc will be extracted for each point
Sample(inRasters, locations, outTable, sampMethod, uniqueIDField, process_as_multidimensional)Extrahieren der Zellenwerte aus mehreren Rastern in eine Tabelle, die auf Eingabepositionen beruht.
# Name: Sample_Ex_04.py
# Description: Creates a table that shows, for each polygon, the average temperature value within the period [1999-01-01T00:00:00 , 2019-01-01-T00:00:00]
# Requirements: Image Analyst Extension
# Import system modules
import arcpy
from arcpy import env
from arcpy.ia import *
# Set environment settings
env.workspace = "C:/iapyexamples/data"
# Set local variables
inRasters = "temperature_1990_2019.nc"
locations = "observers_polygons.shp"
outTable = "C:/iapyexamples/output/samptable_04"
sampMethod = "BILINEAR"
uniqueIDField = "FID"
process_as_multidimensional = True
# StdTime in acquisition_definition is the name of the dimension in inRasters that are related with time
# 1999-01-01T00:00:00 in acquisition_definition is the start time of the period
# 2019-01-01-T00:00:00 in acquisition_definition is the end time of the period
acquisition_definition = "StdTime 1999-01-01T00:00:00 2019-01-01-T00:00:00 # #"
statistic_method = ""
# Check out the ArcGIS Image Analyst extension license
arcpy.CheckOutExtension("ImageAnalyst")
# Execute Sample
# for each polygon in locations, the average temperature value within the period [1999-01-01T00:00:00 , 2019-01-01-T00:00:00] will be extracted
Sample(inRasters, locations, outTable, sampMethod, uniqueIDField, process_as_multidimensional, acquisition_definition, statistic_method)Umgebungen
Lizenzinformationen
- Basic: Erfordert Image Analyst oder Spatial Analyst
- Standard: Erfordert Image Analyst oder Spatial Analyst
- Advanced: Erfordert Image Analyst oder Spatial Analyst