Zellenstatistiken (Spatial Analyst)

Mit der Spatial Analyst-Lizenz verfügbar.

Mit der Image Analyst-Lizenz verfügbar.

Zusammenfassung

Berechnet eine Pro-Zellen-Statistik für mehrere Raster.

Die verfügbaren Statistiken sind: "Mehrheit", "Maximum", "Mittelwert", "Medianwert", "Minimum", "Minderheit", "Bereich", "Standardabweichung", "Summe" und "Varianz".

Weitere Informationen zur Funktionsweise des Werkzeugs "Zellenstatistiken"

Abbildung

OutRas = CellStatistics([InRas1, InRas2, InRas3], "SUM", "NODATA", "SINGLE_BAND")

Verwendung

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

• Für die Statistiktypen "Maximum", "Minimum", "Mittelwert", "Medianwert", "Mehrheit", "Minderheut" und "Summe" gilt: Wenn ein einzelnes Raster als Eingabe verwendet wird, sind die Ausgabenzellwerte gleich den Eingabezellenwerten. Für "Bereich" und "Standardabweichung" sind alle Ausgabezellenwerte gleich 0. Für "Varianz" beträgt er 1.

• Wenn der Parameter Als Multiband verarbeiten deaktiviert ist (process_as_multiband wurde in Python auf SINGLE_BAND festgelegt), wird jedes Band aus einer Multiband-Raster-Eingabe gesondert als Einzelband-Raster verarbeitet. Die Ausgabe ist in diesem Fall ein Einzelband-Raster.

  
  Mit dem Werkzeug "Zellenstatistiken" wird bei Verarbeitung als SINGLE_BAND eine Einzelband-Ausgabe erstellt.

• Wenn der Parameter Als Multiband verarbeiten aktiviert ist (process_as_multiband wurde in Python auf MULTI_BAND festgelegt), wird jede Multiband-Raster-Eingabe als Multiband-Raster verarbeitet. Die Ausgabe ist in diesem Fall ein Multiband-Raster. Das Ausgabe-Raster ist auch dann ein Multiband-Raster, wenn die Eingaben eine Kombination aus einem Multiband-Raster und Konstanten sind. Die Anzahl an Bändern in jeder Multiband-Eingabe muss identisch sein.

  Das Werkzeug führt den Vorgang für jedes Band aus einer Eingabe mit dem entsprechenden Band aus der anderen Eingabe durch. 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.

  
  Mit dem Werkzeug "Zellenstatistiken" wird bei Verarbeitung als MULTI_BAND eine Multiband-Ausgabe erstellt.

• 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	Eine Liste von Eingabe-Rastern, für die eine Statistik für jede Zelle innerhalb des Fensters "Analyse" berechnet wird. Eine Zahl kann als Eingabe verwendet werden, Sie müssen jedoch zunächst in der Umgebung die Zellengröße und die Ausdehnung festlegen. Wenn der Parameter Als Multiband verarbeiten aktiviert ist, müssen alle Multiband-Eingaben dieselbe Anzahl an Bändern aufweisen.	Raster Layer; Constant
Überlagerungsstatistik (optional)	Gibt den zu berechnenden Statistiktyp an. Der Standardstatistiktyp ist "Mittelwert". Mittelwert—Der Mittelwert (Durchschnitt) der Eingaben wird berechnet. Mehrheit—Die Mehrheit (der am häufigsten auftretende Wert) der Eingaben wird berechnet. Maximum—Das Maximum (der größte Wert) der Eingaben wird berechnet. Medianwert—Der Medianwert der Eingaben wird berechnet. Minimum—Das Minimum (der kleinste Wert) der Eingaben wird berechnet. Minderheit—Die Minderheit (der am seltensten auftretende Wert) der Eingaben wird berechnet. Bereich—Der Bereich (Differenz zwischen größtem und kleinstem Wert) der Eingaben wird berechnet. Standardabweichung—Die Standardabweichung der Eingaben wird berechnet. Summe—Die Summe (Gesamtwert aller Werte) der Eingaben wird berechnet. Varianz—Die Varianz (Anzahl der Einzelwerte) der Eingaben wird berechnet.	String
NoData-Werte in Berechnungen ignorieren (optional)	Gibt an, ob NoData-Werte bei der Statistikberechnung ignoriert werden. Aktiviert: Wenn an der Position der bearbeiteten Zelle eines der Eingabe-Raster den Wert "NoData" aufweist, wird dieser ignoriert. Die Statistik wird lediglich unter Berücksichtigung der Zellen mit gültigen Daten berechnet. Dies ist die Standardeinstellung. Deaktiviert: Wenn die Position der bearbeiteten Zelle für eines der Eingabe-Raster den Wert "NoData" aufweist, wird für diese Zelle "NoData" ausgegeben.	Boolean
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. Der Wert wird für jede Zelle ermittelt, indem der angegebene Statistiktyp auf die Eingabe-Raster an dieser Position angewendet wird.	Raster

Python

CellStatistics(in_rasters_or_constants, {statistics_type}, {ignore_nodata}, {process_as_multiband})

Name	Erläuterung	Datentyp
in_rasters_or_constants [in_raster_or_constant,...]	Eine Liste von Eingabe-Rastern, für die eine Statistik für jede Zelle innerhalb des Fensters "Analyse" berechnet wird. Eine Zahl kann als Eingabe verwendet werden, Sie müssen jedoch zunächst in der Umgebung die Zellengröße und die Ausdehnung festlegen. Wenn der Parameter processing_as_multiband auf MULTI_BAND eingestellt ist, dürften alle Multiband-Eingaben dieselbe Anzahl an Bändern aufweisen.	Raster Layer; Constant
statistics_type (optional)	Gibt den zu berechnenden Statistiktyp an. MEAN—Der Mittelwert (Durchschnitt) der Eingaben wird berechnet. MAJORITY—Die Mehrheit (der am häufigsten auftretende Wert) der Eingaben wird berechnet. MAXIMUM—Das Maximum (der größte Wert) der Eingaben wird berechnet. MEDIAN—Der Medianwert der Eingaben wird berechnet. MINIMUM—Das Minimum (der kleinste Wert) der Eingaben wird berechnet. MINORITY—Die Minderheit (der am seltensten auftretende Wert) der Eingaben wird berechnet. RANGE—Der Bereich (Differenz zwischen größtem und kleinstem Wert) der Eingaben wird berechnet. STD—Die Standardabweichung der Eingaben wird berechnet. SUM—Die Summe (Gesamtwert aller Werte) der Eingaben wird berechnet. VARIETY—Die Varianz (Anzahl der Einzelwerte) der Eingaben wird berechnet. Der Standardstatistiktyp ist "Mittelwert".	String
ignore_nodata (optional)	Gibt an, ob NoData-Werte bei der Statistikberechnung ignoriert werden. DATA—Wenn an der Position der bearbeiteten Zelle eines der Eingabe-Raster den Wert "NoData" aufweist, wird dieser ignoriert. Die Statistik wird lediglich unter Berücksichtigung der Zellen mit gültigen Daten berechnet. Dies ist die Standardeinstellung. NODATA—Wenn die Position der bearbeiteten Zelle für eines der Eingabe-Raster den Wert "NoData" aufweist, wird für diese Zelle "NoData" ausgegeben.	Boolean
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. Der Wert wird für jede Zelle ermittelt, indem der angegebene Statistiktyp auf die Eingabe-Raster an dieser Position angewendet wird.	Raster

Codebeispiel

CellStatistics – Beispiel 1 (Python-Fenster)

In diesem Beispiel wird die Standardabweichung pro Zelle bei mehreren Eingabe-Grid-Rastern berechnet, und das Ergebnis wird als IMG-Raster ausgegeben.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outCellStats = CellStatistics(["degs", "negs", "cost"], "STD", "DATA")
outCellStats.save("C:/sapyexamples/output/outcellstats.img")

CellStatistics – Beispiel 2 (eigenständiges Skript)

In diesem Beispiel wird der Bereich pro Zelle pro Band für mehrere Eingabemultiband-Raster berechnet, und es wird ein Multiband-Ausgabe-Raster erstellt.

# Name: CellStatistics_Ex_standalone.py
# Description: Calculates a per-cell statistic from multiple multiband rasters
#               and process as multiband.
# Requirements: Spatial Analyst Extension

# Import system modules
import arcpy
from arcpy.sa import *

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Set the analysis environments
arcpy.env.workspace = "C:/sapyexamples/data"

# Set the local variables
inRaster01 = "degs_MB"
inRaster02 = "negs_MB"
inRaster03 = "cost_MB"

# Execute CellStatistics
outCellStatistics = CellStatistics([inRaster01, inRaster02, inRaster03], "RANGE", "NODATA", "MULTI_BAND")

# Save the output 
outCellStatistics.save("C:/sapyexamples/output/cellstats_MB.tif")

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