Raster-Auswahl (Spatial Analyst Tools)

Zusammenfassung

Anhand des Wertes eines Positions-Rasters wird bestimmt, aus welchem Raster in einer Liste von Eingabe-Rastern der Ausgabe-Zellenwert bezogen wird.

Abbildung

Verwendung

Der Wert jeder Zelle des Eingabe-Positions-Rasters (in_position_raster in Python) bestimmt, welche Eingabe verwendet wird, um den Ausgabe-Raster-Wert zu erhalten. Wenn eine Zelle im Eingabe-Positions-Raster z. B. den Wert 1 aufweist, wird der Wert der ersten Eingabe in der Raster-Liste für den Ausgabezellenwert verwendet. Wenn die Positionseingabe den Wert 2 aufweist, stammt der Ausgabewert aus der zweiten Eingabe in der Raster-Liste usw.
Die Reihenfolge der Eingabe-Raster oder konstanten Werte (in_rasters_or_constants in Python) ist für dieses Werkzeug maßgeblich. Wenn sich die Reihenfolge der Raster ändert, ändern sich auch die Ergebnisse.
Wenn ein Zellenwert im Eingabe-Positions-Raster 0 oder negativ ist, ist das Ergebnis "NoData". Wenn der Positionswert größer ist als die Anzahl der Raster in der Liste, ist das Ergebnis "NoData".
Wenn das Eingabe-Positions-Raster vom Typ "Gleitkomma" ist, werden die Werte auf ganze Zahlen gekürzt, bevor sie verarbeitet werden.
Jede Zelle mit einem NoData-Wert im Positions-Raster erhält im Ausgabe-Raster den Wert "NoData".
Wenn es sich bei einem der Raster in der Eingabeliste um ein Gleitkomma-Raster handelt, ist das Ausgabe-Raster ebenfalls ein Gleitkomma-Raster. Wenn alle ganzzahlig sind, ist auch das Ausgabe-Raster ganzzahlig.
Wenn der Parameter Als Multiband verarbeiten deaktiviert ist (für process_as_multiband wurde in Python SINGLE_BAND festgelegt), wird nur das erste Band von Eingabe-Positions-Raster eines Multibands (in_position_raster in Python) verwendet. Jedes Band von Eingabe-Raster oder konstante Werte eines Multibands (in_rasters_or_constants in Python) wird gesondert als Einzelband-Raster verarbeitet.
Wenn der Parameter Als Multiband verarbeiten aktiviert (process_as_multiband in Python auf MULTI_BAND festgelegt) ist, wird jede Multiband-Raster-Eingabe als Multiband-Raster verarbeitet.

Die Anzahl an Bändern in der Ausgabe hängt vom Eingabe-Positions-Raster ab. Wenn das Eingabe-Positions-Raster ein Einzelband ist, entspricht die Anzahl an Bändern im Ausgabe-Raster der maximalen Anzahl an Bändern aller Multiband-Raster aus Eingabe-Raster oder konstante Werte. Wenn das Eingabe-Positions-Raster eine Multiband ist, verfügt das Ausgabe-Raster über dieselbe Anzahl an Bändern wie das Eingabe-Positions-Raster.

Wenn es sich bei einem Wert unter Eingabe-Raster oder konstante Werte um ein Raster mit einer geringeren Anzahl an Bändern als beim Ausgabe-Raster handelt, werden die fehlenden Bänder als ein Band mit NoData-Werten interpretiert. Wenn der Zellenwert des Eingabe-Positions-Rasters den Wert Eins aus dem fehlenden Band auswählt, erhält das Ausgabe-Raster den Wert "NoData". Handelt es sich bei einem der Eingabe-Raster oder konstanten Werte um einen konstanten Wert, wird dieser als Multiband-Raster interpretiert, in dem die Zellenwerte aller Bänder mit dem konstanten Wert übereinstimmen und über dieselbe Anzahl an Bändern wie das Ausgabe-Raster verfügen.
Ein Eingaberaster mit rechteckigen Zellen wird so verarbeitet, dass die Zellen des Ausgaberasters quadratisch sind und die Seiten gleich dem Durchschnitt der Länge und Breite des Rechtecks sind.
Weitere Informationen zu den Geoverarbeitungsumgebungen für dieses Werkzeug finden Sie unter "Analyseumgebungen und Spatial Analyst".

Beschriftung	Erläuterung	Datentyp
Eingabe-Positions-Raster	Das Eingabe-Raster, das die Position des Rasters definiert, das für den Ausgabewert verwendet werden soll. Die Eingabe kann ein ganzzahliges oder Gleitkomma-Raster sein.	Raster Layer
Eingabe-Raster oder konstante Werte	Die Liste der Eingaben, aus denen der Ausgabewert ausgewählt wird. Die Eingaben können ganzzahlige oder Gleitkomma-Raster sein. Eine Zahl kann ebenfalls als Eingabe verwendet werden.	Raster Layer; Constant
Als Multiband verarbeiten (Optional)	Legt fest, wie die Bänder von Eingabemultiband-Rastern verarbeitet werden. Aktiviert—Jede Multiband-Raster-Eingabe wird als Multiband verarbeitet. Der Vorgang wird für jedes Band aus einer Eingabe mit der entsprechenden Bandnummer aus den anderen Eingaben durchgeführt. Deaktiviert—Jedes Band aus einer Multiband-Raster-Eingabe wird gesondert als Einzelband-Raster verarbeitet. Dies ist die Standardeinstellung.	Boolean

Beschriftung

Erläuterung

Datentyp

Eingabe-Positions-Raster

Das Eingabe-Raster, das die Position des Rasters definiert, das für den Ausgabewert verwendet werden soll.

Die Eingabe kann ein ganzzahliges oder Gleitkomma-Raster sein.

Raster Layer

Eingabe-Raster oder konstante Werte

Die Liste der Eingaben, aus denen der Ausgabewert ausgewählt wird.

Die Eingaben können ganzzahlige oder Gleitkomma-Raster sein. Eine Zahl kann ebenfalls als Eingabe verwendet werden.

Raster Layer; Constant

Als Multiband verarbeiten

(Optional)

Legt fest, wie die Bänder von Eingabemultiband-Rastern verarbeitet werden.

Aktiviert—Jede Multiband-Raster-Eingabe wird als Multiband verarbeitet. Der Vorgang wird für jedes Band aus einer Eingabe mit der entsprechenden Bandnummer aus den anderen Eingaben durchgeführt.
Deaktiviert—Jedes Band aus einer Multiband-Raster-Eingabe wird gesondert als Einzelband-Raster verarbeitet. Dies ist die Standardeinstellung.

Boolean

Rückgabewert

Beschriftung	Erläuterung	Datentyp
Ausgabe-Raster	Das Ausgabe-Raster.	Raster

Pick(in_position_raster, in_rasters_or_constants, {process_as_multiband})

Name Erläuterung Datentyp

Name	Erläuterung	Datentyp
in_position_raster	Das Eingabe-Raster, das die Position des Rasters definiert, das für den Ausgabewert verwendet werden soll. Die Eingabe kann ein ganzzahliges oder Gleitkomma-Raster sein.	Raster Layer
in_rasters_or_constants [in_raster_or_constant,...]	Die Liste der Eingaben, aus denen der Ausgabewert ausgewählt wird. Die Eingaben können ganzzahlige oder Gleitkomma-Raster sein. Eine Zahl kann ebenfalls als Eingabe verwendet werden.	Raster Layer; Constant
process_as_multiband (Optional)	Legt fest, wie die Bänder von Eingabemultiband-Rastern verarbeitet werden. `MULTI_BAND`—Jede Multiband-Raster-Eingabe wird als Multiband verarbeitet. Der Vorgang wird für jedes Band aus einer Eingabe mit der entsprechenden Bandnummer aus den anderen Eingaben durchgeführt. `SINGLE_BAND`—Jedes Band aus einer Multiband-Raster-Eingabe wird gesondert als Einzelband-Raster verarbeitet. Dies ist die Standardeinstellung.	Boolean

in_position_raster

Das Eingabe-Raster, das die Position des Rasters definiert, das für den Ausgabewert verwendet werden soll.

Die Eingabe kann ein ganzzahliges oder Gleitkomma-Raster sein.

Raster Layer

in_rasters_or_constants [in_raster_or_constant,...]

Die Liste der Eingaben, aus denen der Ausgabewert ausgewählt wird.

Die Eingaben können ganzzahlige oder Gleitkomma-Raster sein. Eine Zahl kann ebenfalls als Eingabe verwendet werden.

Raster Layer; Constant

process_as_multiband

(Optional)

Legt fest, wie die Bänder von Eingabemultiband-Rastern verarbeitet werden.

MULTI_BAND—Jede Multiband-Raster-Eingabe wird als Multiband verarbeitet. Der Vorgang wird für jedes Band aus einer Eingabe mit der entsprechenden Bandnummer aus den anderen Eingaben durchgeführt.
SINGLE_BAND—Jedes Band aus einer Multiband-Raster-Eingabe wird gesondert als Einzelband-Raster verarbeitet. Dies ist die Standardeinstellung.

Boolean

Rückgabewert

Name	Erläuterung	Datentyp
out_raster	Das Ausgabe-Raster.	Raster

Codebeispiel

Pick Beispiel 1 (Python-Fenster)

In diesem Beispiel wird der Ausgabewert auf Grundlage der Reihenfolge mehrerer Eingabe-Raster zugewiesen.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outPick = Pick("cost", ["degs", "negs", "fourgrd"], "SINGLE_BAND")
outPick.save("C:/sapyexamples/output/outpick.tif")

Pick Beispiel 2 (eigenständiges Skript)

In diesem Beispiel wird der Ausgabewert auf Grundlage der Reihenfolge mehrerer Eingabe-Raster zugewiesen.

# Name: Pick_Ex_02.py
# Description: Assigns output values using one of a list of rasters
#              determined by the value of an input raster.
# 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
inPositionRas = "inzone_MB"
inRas01 = "Ras1_MB"
inRas02 = "Ras2_MB"
inRas03 = "Ras3_MB"

# Run Pick
outPick = Pick(inPositionRaster, [inRas01, inRas02, inRas03], "MULTI_BAND")

# Save the output
outPick.save("C:/sapyexamples/output/outpick")

Umgebungen

Auto-Commit, Zellengröße, Projektionsmethode für Zellengröße, Komprimierung, Aktueller Workspace, Ausdehnung, Geographische Transformationen, Maske, Ausgabe-CONFIG-Schlüsselwort, Ausgabe-Koordinatensystem, Scratch-Workspace, Fang-Raster, Kachelgröße

Lizenzierungsinformationen

Basic: Erfordert Spatial Analyst oder Image Analyst
Standard: Erfordert Spatial Analyst oder Image Analyst
Advanced: Erfordert Spatial Analyst oder Image Analyst

Raster-Auswahl (Spatial Analyst Tools)

Zusammenfassung

Abbildung

Verwendung

Parameter

Rückgabewert

Umgebungen

Lizenzierungsinformationen

Verwandte Themen