Zellenstatistiken (Image Analyst)

Zusammenfassung

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

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

Weitere Informationen zur Funktionsweise des Werkzeugs "Zellenstatistiken"

Abbildung

Beispiel für Ein- und Ausgabewerte des Werkzeugs "Zellenstatistiken"
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", "Minderheit", "Perzentil" 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 ist in Python auf SINGLE_BAND festgelegt), dann wird jedes Band aus einer Multiband-Raster-Eingabe gesondert als Einzelband-Raster verarbeitet und die Ausgabe ist ein Einzelband-Raster.

    Einzelbandausgabe bei der Verarbeitung als SINGLE_BAND
    Das Werkzeug "Zellenstatistiken" erstellt eine Einzelbandausgabe bei der Verarbeitung als SINGLE_BAND.
  • Wenn der Parameter Als Multiband verarbeiten aktiviert ist (process_as_multiband ist in Python auf MULTI_BAND festgelegt), dann wird jede Multiband-Raster-Eingabe als Multiband-Raster verarbeitet und die Ausgabe ist ein Multiband-Raster. Das Ausgabe-Raster ist auch ein Multiband-Raster, wenn es sich bei den Eingaben um eine Kombination aus einem Multiband-Raster und Konstanten handelt. 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.

    Multiband-Ausgabe bei der Verarbeitung als MULTI_BAND.
    Das Werkzeug "Zellenstatistiken" erstellt eine Multiband-Ausgabe bei der Verarbeitung als MULTI_BAND.
  • 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.

  • Bei Mehrheits- und Minderheitsberechnungen wird bei einem Gleichstand der niedrigste der beiden Werte ausgegeben.

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Raster oder konstante Werte

Eine Liste von Eingabe-Rastern, für die ein statistischer Vorgang für jede Zelle im Fenster "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.

  • MittelwertDer Mittelwert (Durchschnitt) der Eingaben wird berechnet. Dies ist die Standardeinstellung.
  • MehrheitDie Mehrheit (der am häufigsten auftretende Wert) der Eingaben wird ermittelt.
  • MaximumDas Maximum (der größte Wert) der Eingaben wird ermittelt.
  • MedianwertDer Medianwert der Eingaben wird berechnet.
  • MinimumDas Minimum (der kleinste Wert) der Eingaben wird ermittelt.
  • MinderheitDie Minderheit (der am seltensten auftretende Wert) der Eingaben wird ermittelt.
  • PerzentilDas Perzentil der Eingaben wird berechnet. Standardmäßig wird das 90. Perzentil berechnet. Sie können andere Werte (von 0 bis 100) mit dem Parameter Perzentilwert angeben.
  • BereichDer Bereich (Differenz zwischen größtem und kleinstem Wert) der Eingaben wird berechnet.
  • StandardabweichungDie Standardabweichung der Eingaben wird berechnet.
  • SummeDie Summe (Gesamtwert aller Werte) der Eingaben wird berechnet.
  • VarianzDie 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
Perzentilwert
(optional)

Der zu berechnende Perzentilwert. Der Standardwert ist 90 und steht für das 90. Perzentil.

Zulässiger Wert kann zwischen 0 und 100 liegen. Grundsätzlich entspricht der Perzentilwert 0 statistisch gesehen dem Minimum und der Perzentilwert 100 dem Maximum. Der Wert 50 ergibt im Wesentlichen dasselbe Ergebnis wie der Medianwert der Statistik.

Dieser Parameter ist nur verfügbar, wenn für den Parameter Überlagerungsstatistik die Option Perzentil festgelegt wurde.

Double
Perzentil-Interpolationstyp
(optional)

Gibt die Interpolationsmethode an, die verwendet wird, wenn der angegebene Perzentilwert zwischen zwei Eingabezellenwerten liegt.

  • Automatisch erkennenWeisen die Eingabe-Raster einen ganzzahligen Pixeltyp auf, wird die Methode Nächster Nachbar verwendet. Weisen die Eingabe-Raster einen Gleitkomma-Pixeltyp auf, wird die Methode Linear verwendet. Dies ist die Standardeinstellung.
  • Nächster NachbarEs wird der dem gewünschten Perzentil am nächsten liegende verfügbare Wert verwendet. In diesem Fall entspricht der Ausgabepixeltyp dem der Eingabe-Raster.
  • LinearEs wird der gewichtete Durchschnitt der beiden umgebenden Werte aus dem Perzentil verwendet. In diesem Fall ist der Ausgabepixeltyp "Gleitkomma".
String

Rückgabewert

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

CellStatistics(in_rasters_or_constants, {statistics_type}, {ignore_nodata}, {process_as_multiband}, {percentile_value}, {percentile_interpolation_type})
NameErläuterungDatentyp
in_rasters_or_constants
[in_raster_or_constant,...]

Eine Liste von Eingabe-Rastern, für die ein statistischer Vorgang für jede Zelle im Fenster "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 festgelegt ist, sollten alle Multiband-Eingaben dieselbe Anzahl an Bändern aufweisen.

Raster Layer; Constant
statistics_type
(optional)

Gibt den zu berechnenden Statistiktyp an.

  • MEANDer Mittelwert (Durchschnitt) der Eingaben wird berechnet. Dies ist die Standardeinstellung.
  • MAJORITYDie Mehrheit (der am häufigsten auftretende Wert) der Eingaben wird ermittelt.
  • MAXIMUMDas Maximum (der größte Wert) der Eingaben wird ermittelt.
  • MEDIANDer Medianwert der Eingaben wird berechnet.
  • MINIMUMDas Minimum (der kleinste Wert) der Eingaben wird ermittelt.
  • MINORITYDie Minderheit (der am seltensten auftretende Wert) der Eingaben wird ermittelt.
  • PERCENTILEDas Perzentil der Eingaben wird berechnet. Standardmäßig wird das 90. Perzentil berechnet. Sie können andere Werte (von 0 bis 100) mit dem Parameter percentile_value angeben.
  • RANGEDer Bereich (Differenz zwischen größtem und kleinstem Wert) der Eingaben wird berechnet.
  • STDDie Standardabweichung der Eingaben wird berechnet.
  • SUMDie Summe (Gesamtwert aller Werte) der Eingaben wird berechnet.
  • VARIETYDie Varianz (Anzahl der Einzelwerte) der Eingaben wird berechnet.

Der Standardstatistiktyp ist MEAN.

String
ignore_nodata
(optional)

Gibt an, ob NoData-Werte bei der Statistikberechnung ignoriert werden.

  • DATAWenn 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.
  • NODATAWenn 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_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
percentile_value
(optional)

Der zu berechnende Perzentilwert. Der Standardwert ist 90 und steht für das 90. Perzentil.

Zulässiger Wert kann zwischen 0 und 100 liegen. Grundsätzlich entspricht der Perzentilwert 0 statistisch gesehen dem Minimum und der Perzentilwert 100 dem Maximum. Der Wert 50 ergibt im Wesentlichen dasselbe Ergebnis wie der Medianwert der Statistik.

Dieser Parameter wird nur unterstützt, wenn der Parameter statistics_type auf PERCENTILE festgelegt wurde.

Double
percentile_interpolation_type
(optional)

Gibt die Interpolationsmethode an, die verwendet wird, wenn der angegebene Perzentilwert zwischen zwei Eingabezellenwerten liegt.

  • AUTO_DETECTWeisen die Eingabe-Raster einen ganzzahligen Pixeltyp auf, wird die Methode NEAREST verwendet. Weisen die Eingabe-Raster einen Gleitkomma-Pixeltyp auf, wird die Methode LINEAR verwendet. Dies ist die Standardeinstellung.
  • NEARESTEs wird der dem gewünschten Perzentil am nächsten liegende verfügbare Wert verwendet. In diesem Fall entspricht der Ausgabepixeltyp dem der Eingabe-Raster.
  • LINEAREs wird der gewichtete Durchschnitt der beiden umgebenden Werte aus dem Perzentil verwendet. In diesem Fall ist der Ausgabepixeltyp "Gleitkomma".
String

Rückgabewert

NameErläuterungDatentyp
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_02.py
# Description: Calculates a per-cell statistic from multiple 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 = "cost"

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

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

Verwandte Themen