If-Else-Bedingungen (Image Analyst)—ArcGIS Pro

Mit der Spatial Analyst-Lizenz verfügbar.

Mit der Image Analyst-Lizenz verfügbar.

Zusammenfassung

Wertet die einzelnen Eingabezellen eines Eingabe-Rasters anhand von If-Else-Bedingungen aus.

Weitere Informationen zum Durchführen von Bedingungsauswertungen mit "If-Else-Bedingungen"

Abbildung

Verwendung

Wenn das True-Raster oder das optionale False-Raster den Typ "Gleitkomma" aufweist, werden auch für das Ausgabe-Raster Gleitkommazahlen verwendet. Wenn sowohl der True-Ausdruck als auch das optionale False-Raster ganzzahlig sind, ist das Ausgabe-Raster ganzzahlig.
Wenn das Eingabe-Bedingungs-Raster (in_conditional_raster in Python) ein Einzelband-Raster ist und das Raster in Eingabe-Raster oder Eingabe-Wert, wenn Bedingung WAHR (in_true_raster_or_constant in Python) oder das optionale Raster in Eingabe-Raster oder Eingabe-Wert, wenn Bedingung FALSCH (in_false_raster_or_constant in Python) ein konstanter Wert ist, ist die Ausgabe ein Einzelband-Raster.
Wenn alle Eingaben Multiband-Raster sind, dann ist auch die Ausgabe ein Multiband-Raster. Das Ausgabe-Raster ist ebenfalls ein Multiband-Raster, wenn die True-Raster-Eingabe oder die optionale False-Raster-Eingabe ein konstanter Wert ist. Die Anzahl an Bändern in jeder Multiband-Eingabe muss identisch sein.
Das Werkzeug führt den Vorgang für jedes Band aus dem Bedingungs-Raster mit dem entsprechenden Band aus den anderen Eingaben durch. Wenn die Eingabe-Bedingung ein Multiband-Raster ist und die True-Raster-Eingabe oder die optionale False-Raster-Eingabe ein konstanter Wert ist, führt das Werkzeug den Vorgang für jedes Band in der Multiband-Eingabe mit dem konstanten Wert durch.
Wenn die Auswertung für den Ausdruck ungleich 0 ist, wird er als "true" behandelt.
Wenn für Eingabe-Raster oder Eingabe-Wert, wenn Bedingung FALSCH kein Raster bzw. kein konstanter Wert angegeben wurde, wird den Zellen, die auf Basis dieses Ausdrucks nicht "true" ergeben, der Wert "NoData" zugewiesen.
Wenn "NoData" den Ausdruck nicht erfüllt, erhält er nicht den Wert des False-Eingabe-Rasters; es bleibt bei "NoData".
Der Ausdruck verwendet eine SQL-Abfrage. Weitere Informationen zum Erstellen von Abfragen finden Sie in den folgenden Themen:
- Erstellen einer SQL-Abfrage
- SQL-Referenz für in ArcGIS verwendete Abfrageausdrücke
Um eine "{where_clause}" in Python verwenden zu können, muss diese in Anführungszeichen eingeschlossen werden. Zum Beispiel "Value > 5000".
In der Hilfe erhalten Sie weitere Informationen zum Festlegen einer Abfrage in Python.
In Python können Sie die Verwendung einer WHERE-Klausel ({where_clause}) zur Angabe des Value-Feldes vermeiden, indem Sie stattdessen einen Map Algebra-Ausdruck als in_conditional_raster verwenden.
Beispielsweise kann der folgende Ausdruck:
- Con("elev", 0, 1, "value > 1000")
wie folgt neu geschrieben werden:
- Con(Raster("elev") > 1000, 0, 1)
Weitere Informationen finden Sie in den unten aufgeführten Codebeispielen oder unter Erstellen von komplexen Anweisungen in Map Algebra.
Die maximale Länge des logischen Ausdrucks ist 4.096 Zeichen.
Wenn beide Eingaben multidimensionale Raster-Daten mit derselben Anzahl an Variablen sind, führt das Werkzeug den Vorgang für alle Ausschnitte mit demselben Dimensionswert durch. Die Ausgabe ist ein multidimensionales Raster im CRF-Format. Die Variablen in den Eingaben müssen mindestens eine gemeinsame Dimension und einen gemeinsamen Dimensionswert enthalten, die von diesem Werkzeug verarbeitet werden sollen. Andernfalls tritt ein Fehler auf.
Wenn zwei Eingaben multidimensionale Raster mit einer gemeinsamen Variablen, aber unterschiedlichen Namen sind, deaktivieren Sie vor dem Ausführen des Werkzeugs die Einstellung Multidimensionale Variable abgleichen für die Geoverarbeitungsumgebung (durch Festlegen von arcpy.env.matchMultidimensionalVariable = False in Python).
Wenn der Wert des Eingabe-Bedingungs-Rasters ein multidimensionales Raster ist und die Parameter Eingabe-Raster oder Eingabe-Wert, wenn Bedingung WAHR und Eingabe-Raster oder Eingabe-Wert, wenn Bedingung FALSCH auf konstante Werte festgelegt sind, führt das Werkzeug den Vorgang für alle Ausschnitte und alle Variablen mit den konstanten Werten durch, und die Ausgabe ist ein multidimensionales Raster.

Parameter

Beschriftung	Erläuterung	Datentyp
Eingabe-Bedingungs-Raster	Das Eingabe-Raster, das das Ergebnis der gewünschten Bedingung als wahr (true) oder falsch (false) darstellt. Das Raster kann ein Ganzzahl- oder Gleitkomma-Raster sein.	Raster Layer
Eingabe-Raster oder Eingabe-Wert, wenn Bedingung WAHR	Die Eingabe, deren Werte als Ausgabezellenwerte verwendet werden, wenn die Bedingung wahr (true) ist. Das Raster kann ein Integer- oder Gleitkomma-Raster oder ein konstanter Wert sein.	Raster Layer; Constant
Eingabe-Raster oder Eingabe-Wert, wenn Bedingung FALSCH (optional)	Die Eingabe, deren Werte als Ausgabezellenwerte verwendet werden, wenn die Bedingung falsch (false) ist. Das Raster kann ein Integer- oder Gleitkomma-Raster oder ein konstanter Wert sein.	Raster Layer; Constant
Ausdruck (optional)	Ein logischer Ausdruck, der bestimmt, welche der Eingabezellen wahr (true) oder falsch (false) sind. Die Where-Klausel entspricht der allgemeinen Form eines SQL-Ausdrucks. Er kann direkt eingegeben werden, z. B. VALUE > 100, indem Sie auf die Schaltfläche SQL-Bearbeitungsmodus klicken. Im Modus "Klausel bearbeiten" können Sie mit dem Erstellen des Ausdrucks beginnen, indem Sie auf die Schaltfläche Modus "Klausel hinzufügen" klicken.	SQL Expression

Rückgabewert

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

Con(in_conditional_raster, in_true_raster_or_constant, {in_false_raster_or_constant}, {where_clause})

Name	Erläuterung	Datentyp
in_conditional_raster	Das Eingabe-Raster, das das Ergebnis der gewünschten Bedingung als wahr (true) oder falsch (false) darstellt. Das Raster kann ein Ganzzahl- oder Gleitkomma-Raster sein.	Raster Layer
in_true_raster_or_constant	Die Eingabe, deren Werte als Ausgabezellenwerte verwendet werden, wenn die Bedingung wahr (true) ist. Das Raster kann ein Integer- oder Gleitkomma-Raster oder ein konstanter Wert sein.	Raster Layer; Constant
in_false_raster_or_constant (optional)	Die Eingabe, deren Werte als Ausgabezellenwerte verwendet werden, wenn die Bedingung falsch (false) ist. Das Raster kann ein Integer- oder Gleitkomma-Raster oder ein konstanter Wert sein.	Raster Layer; Constant
where_clause (optional)	Ein logischer Ausdruck, der bestimmt, welche der Eingabezellen wahr (true) oder falsch (false) sind. Der Ausdruck entspricht der allgemeinen Form eines SQL-Ausdrucks. Ein Beispiel einer where_clause ist "VALUE > 100".	SQL Expression

Rückgabewert

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

Codebeispiel

Con: Beispiel 1 (Python-Fenster)

In diesem Beispiel wird der ursprüngliche Wert in der Ausgabe beibehalten, wenn das Eingabe-Bedingungs-Raster größer als der Wert 2.000 ist, andernfalls wird der Wert "NoData" verwendet.

import arcpy
from arcpy import env
from arcpy.ia import *
env.workspace = "C:/output/data"
outCon = Con("elevation", "elevation", "", "VALUE > 2000")
outCon.save("C:/output/outcon.img")

# Execute Con using a map algebra expression instead of a where clause
outCon2 = Con(Raster("elevation") > 2000, "elevation")
outCon2.save("C:/output/outcon2")

Con: Beispiel 2 (Python-Fenster)

In diesem Beispiel wird der ursprüngliche Wert in der Ausgabe beibehalten. Eine Ausnahme ist der NoData-Wert, der durch den Wert 0 ersetzt wird.

# Name: Con_Ex_02.py
# Description: Performs a conditional if/else evaluation 
#              on each pixel of an input raster.
# Requirements: Image Analyst Extension

# Import system modules
import arcpy
from arcpy import env
from arcpy.ia import *

# Set environment settings
env.workspace = "C:/output"

# Set local variables
inRaster = Raster("elevation")
inTrueRaster = 1
inFalseConstant = 0
whereClause = "VALUE >= 1500"

# Check out the ArcGIS Image Analyst extension license
arcpy.CheckOutExtension("ImageAnalyst")

# Execute Con and save the output
outCon = Con(inRaster, inTrueRaster, inFalseConstant, whereClause)
outCon.save("C:/output/outcon.tif")

# Execute Con using a map algebra expression instead of a where clause, and save the output.
outCon2 = Con(inRaster >= 1500, inTrueRaster, inFalseConstant)
outCon2.save("C:/output/outcon2.tif")

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

Lizenzinformationen

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

Zusammenfassung

Abbildung

Verwendung

Parameter

Rückgabewert

Rückgabewert

Codebeispiel

Umgebungen

Lizenzinformationen

Verwandte Themen

In diesem Thema