InList (Spatial Analyst)

Mit der Spatial Analyst-Lizenz verfügbar.

Mit der Image Analyst-Lizenz verfügbar.

Zusammenfassung

Ermittelt auf Zellenbasis die Werte der ersten Eingabe, die in einer Menge anderer Eingaben enthalten sind.

Für jede Zelle gilt: Wenn der Wert des ersten Eingabe-Rasters in irgendeiner der Listen der anderen Eingaben gefunden wird, wird dem Ausgabe-Raster dieser Wert zugewiesen. Wenn kein Wert gefunden wird, enthält die Ausgabezelle den Wert "NoData".

Abbildung

Abbildung "InList"
OutRas = InList(InRas1,[0, 2, 3, 7])

Verwendung

  • Wenn alle Eingabe-Raster ganzzahlig sind, ist auch das Ausgabe-Raster ganzzahlig. Wenn es sich bei irgendeiner Eingabe um ein Gleitkomma-Raster handelt, sind die Ausgabe-Raster ebenfalls Gleitkomma-Raster.

  • Die Reihenfolge in der Liste der Eingabe-Raster ist für das Ergebnis dieses Werkzeugs nicht relevant.

  • Wenn der Parameter Als Multiband verarbeiten deaktiviert ist (für process_as_multiband wurde in Python SINGLE_BAND festgelegt), wird nur das erste Band aus der Eingabe unter Eingabe-Raster oder konstanter Wert eines Multibands (input_raster_or_constant in Python) verwendet. Jedes Band einer Eingabe unter 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 ist (für process_as_multiband wurde in Python MULTI_BAND festgelegt), wird jede Multiband-Raster-Eingabe als Multiband-Raster verarbeitet.

    Die Anzahl an Bändern in der Ausgabe hängt vom Parameter Eingabe-Raster oder konstanter Wert ab. Wenn das Eingabe-Raster ein Einzelband oder ein konstanter Wert ist, entspricht die Anzahl an Bändern im Ausgabe-Raster der maximalen Anzahl an Bändern aller Multiband-Raster aus der Eingabe unter Eingabe-Raster oder konstante Werte. Wenn das Eingabe-Raster ein Multiband ist, verfügt das Ausgabe-Raster über dieselbe Anzahl an Bändern wie das Eingabe-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. Handelt es sich bei einem der Einträge in der Eingabeliste 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.

  • Weitere Informationen zur Geoverarbeitung von Umgebungen mit diesem Werkzeug finden Sie unter Analyseumgebungen und Spatial Analyst.

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Raster oder konstanter Wert

Die Eingabe, die den in einer Liste von Rastern gesuchten Wert zellenweise definiert.

Für diesen Parameter kann eine Zahl als Eingabe verwendet werden, vorausgesetzt für den anderen Parameter wird ein Raster angegeben. Um eine Zahl für beide Eingaben anzugeben, müssen Sie zunächst in der Umgebung die Zellengröße und die Ausdehnung festlegen.

Raster Layer; Constant
Eingabe-Raster oder konstanter Wert

Eine Liste von Eingabe-Rastern, anhand derer die erste Eingabe ausgewertet wird. Für jede Position gilt: Wenn der Zellenwert der ersten Eingabe in einem der anderen Raster gefunden wird, wird dem Ausgabe-Raster dieser Wert zugewiesen. Wenn der Wert nicht in einem der anderen Raster vorhanden ist, ist der Ausgabewert an dieser Position ein NoData-Wert.

Für diesen Parameter kann eine Zahl als Eingabe verwendet werden, vorausgesetzt für den anderen Parameter wird ein Raster angegeben. Um eine Zahl für beide Eingaben anzugeben, müssen Sie zunächst in der Umgebung die Zellengröße und die Ausdehnung festlegen.

Raster Layer; Constant
Als Multiband verarbeiten
(optional)

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

  • Deaktiviert: Jedes Band aus einer Multiband-Raster-Eingabe wird gesondert als Einzelband-Raster verarbeitet. Dies ist die Standardeinstellung.
  • 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.
Boolean

Rückgabewert

BeschriftungErläuterungDatentyp
Ausgabe-Raster

Das Ausgabe-Raster.

Raster

InList(in_raster_or_constant, in_raster_or_constants, {process_as_multiband})
NameErläuterungDatentyp
in_raster_or_constant

Die Eingabe, die den in einer Liste von Rastern gesuchten Wert zellenweise definiert.

Für diesen Parameter kann eine Zahl als Eingabe verwendet werden, vorausgesetzt für den anderen Parameter wird ein Raster angegeben. Um eine Zahl für beide Eingaben anzugeben, müssen Sie zunächst in der Umgebung die Zellengröße und die Ausdehnung festlegen.

Raster Layer; Constant
in_raster_or_constants
[in_raster_or_constant,...]

Eine Liste von Eingabe-Rastern, anhand derer die erste Eingabe ausgewertet wird. Für jede Position gilt: Wenn der Zellenwert der ersten Eingabe in einem der anderen Raster gefunden wird, wird dem Ausgabe-Raster dieser Wert zugewiesen. Wenn der Wert nicht in einem der anderen Raster vorhanden ist, ist der Ausgabewert an dieser Position ein NoData-Wert.

Für diesen Parameter kann eine Zahl als Eingabe verwendet werden, vorausgesetzt für den anderen Parameter wird ein Raster angegeben. Um eine Zahl für beide Eingaben anzugeben, müssen Sie zunächst in der Umgebung die Zellengröße und die Ausdehnung festlegen.

Raster Layer; Constant
process_as_multiband
(optional)

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

  • SINGLE_BANDJedes Band aus einer Multiband-Raster-Eingabe wird gesondert als Einzelband-Raster verarbeitet. Dies ist die Standardeinstellung.
  • MULTI_BANDJede 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.
Boolean

Rückgabewert

NameErläuterungDatentyp
out_raster

Das Ausgabe-Raster.

Raster

Codebeispiel

InList – Beispiel 1 (Python-Fenster)

In diesem Beispiel wird ermittelt, welche Zellenwerte in der ersten Eingabe in der Menge anderer Eingabe-Raster gefunden werden.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outInList = InList("redlandsc1", ["redlandsc2", "redlandsc3"])
outInList.save("C:/sapyexamples/output/outinlist.tif")
InList – Beispiel 2 (eigenständiges Skript)

In diesem Beispiel wird ermittelt, welche Zellenwerte in der ersten Eingabe in der Menge anderer Eingabe-Raster gefunden werden.

# Name: InList_Ex_02.py
# Description: Determines which values from the first input are
#              contained in the other inputs
# 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
inRaster1 = "redlandsc1"
inRaster2 = "redlandsc2"
inRaster3 = "redlandsc3"

# Execute InList
outInList = InList(inRaster1, [inRaster2, inRaster3])

# Save the output 
outInList.save("C:/sapyexamples/output/outinlist")

Lizenzinformationen

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

Verwandte Themen