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

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 in ArcPy alle 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 die gleichen Dimensionen oder gemeinsame Dimensionen aufweisen.

  Wenn alle Eingaben multidimensionale Raster mit einer Variablen, aber unterschiedlichen Namen sind, legen Sie für die matchMultidimensionalVariable-Geoverarbeitungsumgebung False fest, um den Vorgang auszuführen.

  Wenn in ArcPy mindestens 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.

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

Parameter

Dialogfeld

Beschriftung	Erläuterung	Datentyp
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

Beschriftung	Erläuterung	Datentyp
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

Python

HighestPosition(in_rasters_or_constants)

Name	Erläuterung	Datentyp
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

Name	Erläuterung	Datentyp
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)

In diesem Beispiel werden mehrere Eingabe-Raster ausgewertet, und die Position des Rasters mit dem Maximalwert in der Liste wird als Ausgabewert zurückgegeben.

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)

In diesem Beispiel werden mehrere Eingabe-Raster ausgewertet, und die Position des Rasters mit dem Maximalwert in der Liste wird als Ausgabewert zurückgegeben.

# 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")

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

Sonderfälle

Lizenzinformationen

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