Mit der Spatial Analyst-Lizenz verfügbar.
Zusammenfassung
Führt mittels eines logischen Ausdrucks eine boolesche Auswertung des Eingabe-Rasters aus.
Wenn der Ausdruck als "true" (wahr) ausgewertet wird, ist der Wert der Ausgabezelle 1. Wenn der Ausdruck "false" (falsch) ist, ist der Wert der Ausgabezelle 0.
Abbildung
Verwendung
Der Test wird durch einen SQL-Ausdruck in der Where-Klausel angegeben.
Die Where-Klausel verwendet eine SQL-Abfrage. Weitere Informationen zum Erstellen von Abfragen im Abfrage-Builder finden Sie in den folgenden Themen:
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.
Weitere Informationen zur Geoverarbeitung von Umgebungen mit diesem Werkzeug finden Sie unter Analyseumgebungen und Spatial Analyst.
Syntax
Test (in_raster, where_clause)
Parameter | Erläuterung | Datentyp |
in_raster | Das Eingabe-Raster, in dem die boolesche Auswertung auf Grundlage eines logischen Ausdrucks durchgeführt wird. | Raster Layer |
where_clause | Der logische Ausdruck, der bestimmt, welche Eingabezellen den Wert (1) zurückgeben und welche falsch (0) 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. Die Ausgabewerte sind entweder 0 oder 1. | Raster |
Codebeispiel
Test – Beispiel 1 (Python-Fenster)
In diesem Beispiel wird mithilfe einer Where-Klausel eine boolesche Operation in einem Eingabe-Raster ausgeführt.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outTest = Test("degs", "VALUE > 100")
outTest.save("C:/sapyexamples/output/outest.img")
Test – Beispiel 2 (eigenständiges Skript)
In diesem Beispiel wird mithilfe einer Where-Klausel eine boolesche Operation in einem Eingabe-Raster ausgeführt.
# Name: Test_Ex_02.py
# Description: Perform a Boolean evaluation of the input raster based
# on a where clause
# 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
inRaster = "degs"
inWhereClause = "VALUE > 100"
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute Test
outTest = Test(inRaster, inWhereClause)
# Save the output
outTest.save("C:/sapyexamples/output/outtest")
Umgebungen
Lizenzinformationen
- ArcGIS Desktop Basic: Erfordert Spatial Analyst
- ArcGIS Desktop Standard: Erfordert Spatial Analyst
- ArcGIS Desktop Advanced: Erfordert Spatial Analyst