Equal To (Spatial Analyst)

Mit der Spatial Analyst-Lizenz verfügbar.

Mit der Image Analyst-Lizenz verfügbar.

Zusammenfassung

Führt auf Zellenbasis eine relationale "Equal To"-Operation für zwei Eingaben aus.

Gibt 1 für Zellen zurück, bei denen das erste Raster mit dem zweiten Raster identisch ist, andernfalls 0.

Weitere Informationen zur Funktionsweise von relationalen mathematischen Werkzeugen

Abbildung

Abbildung "Equal To (relational)"
OutRas = EqualTo(InRas1, Const2Ras)

Verwendung

  • Zwei Eingaben sind notwendig, damit diese relationale Auswertung stattfindet.

  • Für dieses Werkzeug ist die Reihenfolge der Eingaben irrelevant.

  • Wenn beide Eingaben Einzelband-Raster sind oder wenn eine der Eingaben eine Konstante ist, dann ist die Ausgabe ein Einzelband-Raster.

  • Wenn beide Eingaben Multiband-Raster sind, führt das Werkzeug den Vorgang für jedes Band aus einer Eingabe durch, und die Ausgabe ist ein Multiband-Raster. Die Anzahl an Bändern in jeder Multiband-Eingabe muss identisch sein.

  • Wenn eine der Eingaben ein Multiband-Raster und die andere Eingabe eine Konstante ist, führt das Werkzeug den Vorgang für jedes Band in der Multiband-Eingabe mit dem konstanten Wert durch. Die Ausgabe ist in diesem Fall ein Multiband-Raster.

  • Wenn in ArcPy beide Eingaben multidimensionale Raster mit derselben Anzahl an Variablen sind, führt das Werkzeug den Vorgang für alle Ausschnitte mit demselben Dimensionswert durch, und die Ausgabe ist ein multidimensionales Raster. Die Variablen in den Eingaben müssen gleiche Dimensionen oder eine gemeinsame Dimension, dürfen jedoch keine nicht gemeinsamen Dimensionen aufweisen.

    Wenn beide Eingaben eine Variable, aber unterschiedliche Namen aufweisen, legen Sie für die matchMultidimensionalVariable-Geoverarbeitungsumgebung False fest, um den Vorgang auszuführen.

    Wenn in ArcPy eine der Eingaben ein multidimensionales Raster und die andere Eingabe eine Konstante ist, führt das Werkzeug den Vorgang für alle Ausschnitte sämtlicher Variablen mit dem konstanten Wert durch, und die Ausgabe ist ein multidimensionales Raster.

  • In Map Algebra ist das entsprechende Operatorsymbol für dieses Werkzeug "==" (Link).

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

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Raster oder konstanter Wert 1

Die Eingabe, die mit der zweiten Eingabe auf Gleichheit verglichen wird.

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 2

Die Eingabe, die mit der ersten Eingabe auf Gleichheit verglichen wird.

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

Rückgabewert

BeschriftungErläuterungDatentyp
Ausgabe-Raster

Das Ausgabe-Raster.

Die Ausgabezellenwerte sind ein ganzzahliger Wert von 0 oder 1 oder "NoData", wenn einer der Eingabezellenwerte "NoData" lautet.

Raster

EqualTo(in_raster_or_constant1, in_raster_or_constant2)
NameErläuterungDatentyp
in_raster_or_constant1

Die Eingabe, die mit der zweiten Eingabe auf Gleichheit verglichen wird.

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_constant2

Die Eingabe, die mit der ersten Eingabe auf Gleichheit verglichen wird.

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

Rückgabewert

NameErläuterungDatentyp
out_raster

Das Ausgabe-Raster.

Die Ausgabezellenwerte sind ein ganzzahliger Wert von 0 oder 1 oder "NoData", wenn einer der Eingabezellenwerte "NoData" lautet.

Raster

Codebeispiel

EqualTo – Beispiel 1(Python-Fenster)

In diesem Beispiel wird eine relationale Operation mit "Equal To" für zwei Grid-Raster ausgeführt und das Ergebnis als TIFF-Raster ausgegeben.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outEqualTo = EqualTo("degs", "negs")
outEqualTo.save("C:/sapyexamples/output/outequalto.tif")
EqualTo – Beispiel 2 (eigenständiges Skript)

In diesem Beispiel wird eine relationale Operation mit "Equal To" für zwei Grid-Raster ausgeführt.

# Name: EqualTo_Ex_02.py
# Description: Performs a relational equal-to operation on two inputs
#              on a cell-by-cell basis within the Analysis window
# 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 = "degs"
inRaster2 = "negs"

# Execute EqualTo
outEqualTo = EqualTo(inRaster1, inRaster2)

# Save the output 
outEqualTo.save("C:/sapyexamples/output/outequalto")

Lizenzinformationen

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

Verwandte Themen