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

Abbildung "Test"
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:

  • 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

BeschriftungErläuterungDatentyp
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 SQL-Abfrage klicken. Im Modus "Klausel bearbeiten" 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

BeschriftungErläuterungDatentyp
Ausgabe-Raster

Das Ausgabe-Raster.

Die Ausgabezellenwerte sind entweder 0 oder 1.

Raster

Test(in_raster, where_clause)
NameErläuterungDatentyp
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

NameErläuterungDatentyp
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")

Lizenzinformationen

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

Verwandte Themen