Höchster Zellenwert (Spatial Analyst)

Mit der Spatial Analyst-Lizenz verfügbar.

Zusammenfassung

Ermittelt auf Zellenbasis in einer Gruppe von Rastern die Position des Rasters mit dem Maximalwert.

Abbildung

Beispiel für Eingabe- und Ausgabewerte des Werkzeugs "Höchster Zellenwert"
OutRas = HighestPosition([InRas1, InRas2, InRas3])

Verwendung

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

  • Die Reihenfolge der Eingabe-Raster ist für dieses Werkzeug von Bedeutung.

  • Wenn ein Multiband-Raster als einer der Parameterwerte Eingabe-Raster oder konstante Werte (in_rasters_or_constants in Python) angegeben wird, werden alle Bänder verwendet.

    Wenn eine Auswahl von Bändern aus einem Multiband-Raster verarbeitet werden soll, erstellen Sie zunächst mit dem Werkzeug Bänder zusammensetzen ein neues Raster-Dataset, das aus den betreffenden Bändern besteht, und verwenden Sie dann das Ergebnis in der Liste für die Parameter Eingabe-Raster oder konstante Werte (in_rasters_or_constants in Python).

  • 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 zwei oder mehr Eingabe-Raster den Maximalwert für eine bestimmte Zellenposition enthalten, wird die Position des ersten im Ausgabe-Raster zurückgegeben.

  • 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

BeschriftungErläuterungDatentyp
Eingabe-Raster oder konstante Werte

Die Liste der Eingabe-Raster, für die die Position der Eingabe mit dem höchsten Wert ermittelt wird.

Eine Zahl kann als Eingabe verwendet werden, Sie müssen jedoch zunächst in der Umgebung die Zellengröße und die Ausdehnung festlegen.

Raster Layer; Constant

Rückgabewert

BeschriftungErläuterungDatentyp
Ausgabe-Raster

Das Ausgabe-Raster.

Für jede Zelle im Ausgabe-Raster stellt der Wert die Position des Rasters mit dem höchsten Wert dar.

Raster

HighestPosition(in_rasters_or_constants)
NameErläuterungDatentyp
in_rasters_or_constants
[in_raster_or_constant,...]

Die Liste der Eingabe-Raster, für die die Position der Eingabe mit dem höchsten Wert ermittelt wird.

Eine Zahl kann als Eingabe verwendet werden, Sie müssen jedoch zunächst in der Umgebung die Zellengröße und die Ausdehnung festlegen.

Raster Layer; Constant

Rückgabewert

NameErläuterungDatentyp
out_raster

Das Ausgabe-Raster.

Für jede Zelle im Ausgabe-Raster stellt der Wert die Position des Rasters mit dem höchsten Wert dar.

Raster

Codebeispiel

HighestPosition – Beispiel 1 (Python-Fenster)

Dieses Beispiel prüft einen Satz von Eingabe-Rastern und gibt als Ausgabewert die Position in der Raster-Liste mit dem Maximalwert zurück.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outHighestPosition = HighestPosition(["degs", "negs", "fourgrd"])
outHighestPosition.save("C:/sapyexamples/output/outhp.img")
HighestPosition – Beispiel 2 (eigenständiges Skript)

Dieses Beispiel prüft einen Satz von Eingabe-Rastern und gibt als Ausgabewert die Position in der Raster-Liste mit dem Maximalwert zurück.

# Name: HighestPosition_Ex_02.py
# Description: Determines the position of a raster with the maximum
#              value in a set of rasters
# 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
inRaster01 = "degs"
inRaster02 = "negs"
inRaster03 = "fourgrd"

# Execute HighestPosition
outHighestPosition = HighestPosition([inRaster01, inRaster02, inRaster03])

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

Lizenzinformationen

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

Verwandte Themen