Häufigkeit gleicher Werte (Spatial Analyst)

Mit der Spatial Analyst-Lizenz verfügbar.

Zusammenfassung

Wertet auf Zellenbasis aus, wie häufig die Werte in einer Gruppe von Rastern gleich einem anderen Raster ist.

Abbildung

OutRas = EqualToFrequency(ValRas, [InRas1, InRas2, InRas3])

Verwendung

• In der Liste der Eingabe-Raster kann eine beliebige Anzahl von Rastern angegeben werden.

• Wenn eine Zellenposition für eines der Eingabe-Raster den Wert "NoData" enthält, wird dieser Position auch in der Ausgabe der Wert "NoData" zugewiesen.

• Das Ausgabe-Raster ist immer ganzzahlig.

• Wenn alle 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, damit dieses Werkzeug erfolgreich ausgeführt werden kann. Andernfalls tritt ein Fehler auf.

  Wenn alle Eingaben eine Variable, aber unterschiedliche Namen aufweisen, deaktivieren Sie vor dem Ausführen der Operation die Einstellung Multidimensionale Variable abgleichen für die Geoverarbeitungsumgebung (durch Festlegen von arcpy.env.matchMultidimensionalVariable = False in Python).

  Wenn mindestens eine der Eingaben ein multidimensionales Raster und die anderen Eingaben Konstanten sind, 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.

• Weitere Informationen zu den Geoverarbeitungsumgebungen für dieses Werkzeug finden Sie unter Analyseumgebungen und Spatial Analyst.

Parameter

Dialogfeld

Beschriftung	Erläuterung	Datentyp
Eingabe-Werte-Raster	Für jede Zellenposition im Eingabe-Wert-Raster wird die Anzahl von Vorkommen (Häufigkeit) gezählt, bei der ein Raster in der Eingabeliste über einen gleichen Wert verfügt.	Raster Layer
Eingabe-Raster	Die Liste der Raster, die mit dem Wert-Raster verglichen werden.	Raster Layer
Als Multiband verarbeiten (optional)	Legt fest, wie die Bänder von Eingabemultiband-Rastern verarbeitet werden. Deaktiviert: Jedes Band aus einer Multiband-Raster-Eingabe wird gesondert als Einzelband-Raster verarbeitet. Dies ist die Standardeinstellung. Aktiviert: Jede Multiband-Raster-Eingabe wird als Multiband verarbeitet. Der Vorgang wird für jedes Band aus einer Eingabe mit der entsprechenden Bandnummer aus den anderen Eingaben durchgeführt.	Boolean

Rückgabewert

Beschriftung	Erläuterung	Datentyp
Ausgabe-Raster	Das Ausgabe-Raster. Für jede Zelle im Ausgabe-Raster stellt der Wert die Häufigkeit dar, mit der die entsprechenden Zellen in der Liste der Raster gleich dem Wert-Raster sind.	Raster

Python

EqualToFrequency(in_value_raster, in_rasters, {process_as_multiband})

Name	Erläuterung	Datentyp
in_value_raster	Für jede Zellenposition im Eingabe-Wert-Raster wird die Anzahl von Vorkommen (Häufigkeit) gezählt, bei der ein Raster in der Eingabeliste über einen gleichen Wert verfügt.	Raster Layer
in_rasters [in_raster,...]	Die Liste der Raster, die mit dem Wert-Raster verglichen werden.	Raster Layer
process_as_multiband (optional)	Legt fest, wie die Bänder von Eingabemultiband-Rastern verarbeitet werden. SINGLE_BAND—Jedes Band aus einer Multiband-Raster-Eingabe wird gesondert als Einzelband-Raster verarbeitet. Dies ist die Standardeinstellung. MULTI_BAND—Jede Multiband-Raster-Eingabe wird als Multiband verarbeitet. Der Vorgang wird für jedes Band aus einer Eingabe mit der entsprechenden Bandnummer aus den anderen Eingaben durchgeführt.	Boolean

Rückgabewert

Name	Erläuterung	Datentyp
out_raster	Das Ausgabe-Raster. Für jede Zelle im Ausgabe-Raster stellt der Wert die Häufigkeit dar, mit der die entsprechenden Zellen in der Liste der Raster gleich dem Wert-Raster sind.	Raster

Codebeispiel

EqualToFrequency – Beispiel (Python-Fenster)

Dieses Beispiel prüft, wie oft ein Satz von Eingabe-Rastern einem anderen Raster gleicht. Das Ergebnis wird als TIFF-Raster ausgegeben.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outETF = EqualToFrequency("cost", ["degs", "negs", "fourgrd"])
outETF.save("C:/sapyexamples/output/outetf.tif")

EqualToFrequency – Beispiel 2 (eigenständiges Skript)

Dieses Beispiel prüft, wie oft ein Satz von Eingabe-Rastern einem anderen Raster gleicht. Das Ergebnis wird als Grid-Raster ausgegeben.

# Name: EqualToFrequency_Ex_02.py
# Description: Evaluates the number of times a set of rasters is
#              equal to another raster on a cell-by-cell basis
# 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
inValueRaster = "cost"
inRaster01 = "degs"
inRaster02 = "negs"
inRaster03 = "fourgrd"

# Execute EqualToFrequency
outETF = EqualToFrequency(inValueRaster, [inRaster01, inRaster02, inRaster03])

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

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 Spatial Analyst
• Standard: Erfordert Spatial Analyst
• Advanced: Erfordert Spatial Analyst