Test (Spatial Analyst)

Mit der Spatial Analyst-Lizenz verfügbar.

Mit der Image Analyst-Lizenz verfügbar.

Zusammenfassung

Führt mittels eines logischen Ausdrucks eine boolesche Auswertung des Eingabe-Rasters aus.

Wenn der Ausdruck als TRUE ausgewertet wird, ist der Ausgabezellenwert 1. Wenn der Ausdruck als FALE ausgewertet wird, ist der Ausgabezellenwert 0.

Abbildung

OutRas = Test(InRas1,"Value >= 2")

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 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.

• Wenn die Eingabe ein Multiband-Raster ist, dann ist auch die Ausgabe ein Multiband-Raster. Das Werkzeug führt den Vorgang für jedes Band in der Eingabe durch.

• Wenn in ArcPy die Eingabe ein multidimensionales Raster ist, werden alle Ausschnitte sämtlicher Variablen verarbeitet, und die Ausgabe ist ein multidimensionales Raster.

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

Parameter

Dialogfeld

Beschriftung	Erläuterung	Datentyp
Eingabe-Raster	Das Eingabe-Raster, in dem die boolesche Auswertung auf Grundlage eines logischen Ausdrucks durchgeführt wird.	Raster Layer
Where-Klausel	Der logische Ausdruck, der bestimmt, welche Eingabezellen den Wert (1) zurückgeben und welche falsch (0) 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. Die Ausgabezellenwerte sind entweder 0 oder 1.	Raster

Python

Test(in_raster, where_clause)

Name	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 Ausgabezellenwerte 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"

# Execute Test
outTest = Test(inRaster, inWhereClause)

# Save the output 
outTest.save("C:/sapyexamples/output/outtest")

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

Sonderfälle

Lizenzinformationen

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