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

Beispiel für Eingabe- und Ausgabewerte des Werkzeugs "Häufigkeit gleicher Werte"
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 zur Geoverarbeitung von Umgebungen mit diesem Werkzeug finden Sie unter Analyseumgebungen und Spatial Analyst.

Parameter

BeschriftungErläuterungDatentyp
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

BeschriftungErläuterungDatentyp
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

EqualToFrequency(in_value_raster, in_rasters, {process_as_multiband})
NameErläuterungDatentyp
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_BANDJedes Band aus einer Multiband-Raster-Eingabe wird gesondert als Einzelband-Raster verarbeitet. Dies ist die Standardeinstellung.
  • MULTI_BANDJede 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

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

In diesem Beispiel wird die Häufigkeit ausgewertet, mit der ein Satz von Eingabe-Rastern gleich einem anderen Raster ist, und 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)

In diesem Beispiel wird die Häufigkeit ausgewertet, mit der ein Satz von Eingabe-Rastern gleich einem anderen Raster ist, und 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")

Lizenzinformationen

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

Verwandte Themen