Focal Statistics (Image Analyst)

Mit der Spatial Analyst-Lizenz verfügbar.

Mit der Image Analyst-Lizenz verfügbar.

Zusammenfassung

Berechnet für jede Eingabezellenposition eine Statistik der Werte innerhalb einer angegebenen Nachbarschaft.

Weitere Informationen zur Funktionsweise des Werkzeugs "Focal Statistics"

Abbildung

Eingabe- und Ausgabewerte des Werkzeugs "Focal Statistics" mit dem festgelegten Statistiktyp "Summe"
OutRas = FocalStatistics(InRas1, NbrRectangle(3,3,MAP), "SUM", "")

Verwendung

  • Wenn das Eingabe-Raster ein Ganzzahl-Raster ist, sind alle Statistiktypen verfügbar. Wenn das Eingabe-Raster ein Gleitkomma-Raster ist, sind nur die Statistiken für Mittelwert, Maximum, Median, Minimum, Perzentil, Bereich, Standardabweichung und Summe verfügbar. Die Statistiken für Mehrheit, Minderheit und Varianz sind nicht zulässig.

  • Wenn eine kreisförmige, kreisringförmige oder keilförmige Nachbarschaft angegeben wird, werden einige der äußeren diagonalen Zellen möglicherweise nicht in den Berechnungen berücksichtigt, da der Mittelpunkt der Zelle innerhalb der Nachbarschaft liegen muss.

  • Für eine Nachbarschaft vom Typ "Unregelmäßig" und "Gewichtung" muss eine Kernel-Datei angegeben werden. Kernel-Dateien müssen die Dateierweiterung .txt haben.

    Informationen zum Erstellen und Verwenden von Kernel-Dateien finden Sie unter Weitere Informationen zur Funktionsweise des Werkzeugs "Focal Statistics" in den Abschnitten "Unregelmäßig" und "Gewichtung".

  • Beim Typ Nachbarschaft kann die Option Gewichtung nur für die Statistiktypen "Mittelwert", "Standardabweichung" und "Summe" festgelegt werden.

  • NoData-Zellen in der Eingabe können in der Ausgabe einen Wert erhalten, wenn der Parameter NoData in Berechnungen ignorieren aktiviert ist, vorausgesetzt, dass mindestens eine Zelle in der Nachbarschaft einen gültigen Wert aufweist.

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Raster

Das Raster, für das die Focal Statistics für jede Eingabezelle berechnet werden sollen.

Raster Layer
Nachbarschaft
(optional)

Die Zellen um eine Verarbeitungszelle, die bei der Statistikberechnung verwendet werden. Es stehen verschiedene vordefinierte Nachbarschaftstypen zur Auswahl. Alternativ kann ein benutzerdefinierter Kernel definiert werden.

Nach Auswahl des Nachbarschaftstyps können weitere Parameter festgelegt werden, um die endgültige Definition von Form, Größe und Maßeinheiten vorzunehmen. Die Standardnachbarschaft ist ein Quadrat mit einer Breite und Höhe von drei Zellen.

Im Folgenden sind die Formen der verfügbaren Nachbarschaftstypen beschrieben:

  • Kreisring, Innerer Radius, Äußerer Radius, Einheitentyp

    Eine kreisringförmige Nachbarschaft, die durch einen inneren und äußeren Radius definiert ist. Der Standardkreisring ist ein innerer Radius von einer Zelle und ein äußerer Radius von drei Zellen.

  • Kreis, Radius, Einheitentyp

    Eine kreisförmige Nachbarschaft mit dem gegebenen Radius. Der Standardradius ist drei Zellen.

  • Rechteck, Höhe, Breite, Einheitentyp

    Eine rechteckige Nachbarschaft, die durch Höhe und Breite definiert ist. Die Standardeinstellung ist ein Quadrat mit einer Höhe und Breite von drei Zellen.

  • Keil, Radius, Anfangswinkel, Endwinkel, Einheitentyp

    Eine keilförmige Nachbarschaft, die durch einen Radius, den Anfangswinkel und den Endwinkel definiert wird. Der Keil dehnt sich gegen den Uhrzeigersinn vom Anfangswinkel zum Endwinkel aus. Die Winkel werden in Grad angegeben, wobei 0 bzw. 360 Grad Osten darstellt. Es können negative Winkel verwendet werden. Der Standardkeil reicht von 0 bis 90 Grad mit einem Radius von drei Zellen.

  • Unregelmäßig, Kernel-Datei

    Eine benutzerdefinierte Nachbarschaft, deren Spezifikationen durch die angegebene Kernel-Textdatei festgelegt werden.

  • Gewichtung, Kernel-Datei

    Eine benutzerdefinierte Nachbarschaft, deren Spezifikationen durch die angegebene Kernel-Textdatei festgelegt werden, die Gewichtungen auf die Elemente der Nachbarschaft anwenden kann.

Für die Nachbarschaftstypen "Kreisring", "Kreis", "Rechteck" und "Keil" können die Entfernungseinheiten der Parameter als Einheiten der Zelle oder der Karte angegeben werden. Die Standardeinstellung sind Zelleneinheiten.

Bei Kernel-Nachbarschaften definiert die erste Zelle in der Kernel-Datei die Breite und Höhe der Nachbarschaft als Anzahl von Zellen. In den darauffolgenden Zeilen ist angegeben, wie der Eingabewert verarbeitet wird, der der jeweiligen Position im Kernel entspricht. Ist beim Nachbarschaftstyp "Unregelmäßig" oder "Gewichtung" ein Wert von 0 in der Kernel-Datei angegeben, wird die entsprechende Position nicht in die Berechnung einbezogen. Bei einer unregelmäßigen Nachbarschaft bedeutet ein Wert von 1, dass die entsprechende Eingabezelle in die Berechnung einbezogen wird. Bei einer gewichteten Nachbarschaft gibt der Wert für die jeweilige Position an, mit welchem Faktor der Eingabezellenwert multipliziert wird. Es können positive, negative sowie Dezimalwerte verwendet werden.

Neighborhood
Statistiktyp
(optional)

Gibt den zu berechnenden Statistiktyp an.

Der Standardstatistiktyp ist Mittelwert.

Wenn das Eingabe-Raster ein Ganzzahl-Raster ist, sind alle Statistiktypen verfügbar. Wenn das Eingabe-Raster ein Gleitkomma-Raster ist, sind nur die Statistiktypen Mittelwert, Maximum, Medianwert, Minimum, Perzentil, Bereich, Standardabweichung und Summe verfügbar.

  • MittelwertDer Mittelwert (Durchschnittswert) der Zellen innerhalb der Nachbarschaft wird berechnet.
  • MehrheitDie Mehrheit (der am häufigsten auftretende Wert) der Zellen innerhalb der Nachbarschaft wird berechnet.
  • MaximumDer Maximalwert (der höchste Wert) der Zellen innerhalb der Nachbarschaft wird berechnet.
  • MedianwertDer Medianwert der Zellen innerhalb der Nachbarschaft wird berechnet.
  • MinimumDer Minimalwert (der kleinste Wert) der Zellen innerhalb der Nachbarschaft wird berechnet.
  • MinderheitDie Minderheit (der am seltensten auftretende Wert) der Zellen innerhalb der Nachbarschaft wird berechnet.
  • PerzentilEin Perzentil der Zellen innerhalb der Nachbarschaft 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 Zellen in der Nachbarschaft wird berechnet.
  • StandardabweichungDie Standardabweichung der Zellen innerhalb der Nachbarschaft wird berechnet.
  • SummeDie Summe der Zellen innerhalb der Nachbarschaft wird berechnet.
  • VarianzDie Varianz (die Anzahl der Einzelwerte) der Zellen innerhalb der Nachbarschaft wird berechnet.
String
NoData-Werte in Berechnungen ignorieren
(optional)

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

  • Aktiviert: Ein NoData-Wert innerhalb einer Nachbarschaft wird ignoriert, falls vorhanden. Nur Zellen innerhalb der Nachbarschaft, die Datenwerte aufweisen, werden bei der Ermittlung des Ausgabewertes verwendet. Handelt es sich beim Wert der bearbeiteten Zelle um einen NoData-Wert, bedeutet dies, dass die bearbeitete Zelle einen Wert im Ausgabe-Raster erhalten kann, wenn dieser Parameter aktiviert ist. Voraussetzung ist jedoch, dass mindestens eine Zelle in der Nachbarschaft über einen gültigen Wert verfügt. Dies ist die Standardeinstellung.
  • Deaktiviert: Wenn eine Zelle in der Nachbarschaft einschließlich der bearbeiteten Zelle den Wert "NoData" aufweist, erhält auch die Ausgabe für die bearbeitete Zelle den Wert "NoData". Ist dieser Parameter nicht aktiviert, bedeutet das Vorhandensein eines NoData-Wertes, dass nicht genügend Informationen verfügbar sind, um den statistischen Wert für die Nachbarschaft zu bestimmen.
Boolean
Perzentilwert
(optional)

Das zu berechnende Perzentil. Der Standardwert ist 90 für das 90. Perzentil.

Zulässige Werte können 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.

Diese Option wird nur unterstützt, wenn für den Parameter Statistiktyp die Option Perzentil festgelegt wurde. Wenn ein anderer Statistiktyp angegeben wurde, wird dieser Parameter ignoriert.

Double

Rückgabewert

BeschriftungErläuterungDatentyp
Ausgabe-Raster

Das Ausgabe-Raster für "Focal Statistics".

Raster

FocalStatistics(in_raster, {neighborhood}, {statistics_type}, {ignore_nodata}, {percentile_value})
NameErläuterungDatentyp
in_raster

Das Raster, für das die Focal Statistics für jede Eingabezelle berechnet werden sollen.

Raster Layer
neighborhood
(optional)

Die Zellen um eine Verarbeitungszelle, die bei der Statistikberechnung verwendet werden. Es stehen verschiedene vordefinierte Nachbarschaftstypen zur Auswahl. Alternativ kann ein benutzerdefinierter Kernel definiert werden.

Nach Auswahl des Nachbarschaftstyps können weitere Parameter festgelegt werden, um die endgültige Definition von Form, Größe und Maßeinheiten vorzunehmen. Die Standardnachbarschaft ist ein Quadrat mit einer Breite und Höhe von drei Zellen.

Die Form der Nachbarschaften bestimmt sich aus der Klasse Neighborhood. Die verfügbaren Nachbarschaftstypen sind NbrAnnulus, NbrCircle, NbrRectangle, NbrWedge, NbrIrregular, und NbrWeight.

Im Folgenden sind die Formen der verfügbaren Nachbarschaftstypen beschrieben:

  • NbrAnnulus({innerRadius}, {outerRadius}, {units})

    Eine kreisringförmige Nachbarschaft, die durch einen inneren und äußeren Radius definiert ist. Der Standardkreisring ist ein innerer Radius von einer Zelle und ein äußerer Radius von drei Zellen.

  • NbrCircle({radius}, {units}

    Eine kreisförmige Nachbarschaft mit dem gegebenen Radius. Der Standardradius ist drei Zellen.

  • NbrRectangle({width}, {height}, {units})

    Eine rechteckige Nachbarschaft, die durch Höhe und Breite definiert ist. Die Standardeinstellung ist ein Quadrat mit einer Höhe und Breite von drei Zellen.

  • NbrWedge({radius}, {startAngle}, {endAngle}, {units})

    Eine keilförmige Nachbarschaft, die durch einen Radius, den Anfangswinkel und den Endwinkel definiert wird. Der Keil dehnt sich gegen den Uhrzeigersinn vom Anfangswinkel zum Endwinkel aus. Die Winkel werden in Grad angegeben, wobei 0 bzw. 360 Grad Osten darstellt. Es können negative Winkel verwendet werden. Der Standardkeil reicht von 0 bis 90 Grad mit einem Radius von drei Zellen.

  • NbrIrregular(inKernelFile)

    Eine benutzerdefinierte Nachbarschaft, deren Spezifikationen durch die angegebene Kernel-Textdatei festgelegt werden.

  • NbrWeight(inKernelFile)

    Eine benutzerdefinierte Nachbarschaft, deren Spezifikationen durch die angegebene Kernel-Textdatei festgelegt werden, die Gewichtungen auf die Elemente der Nachbarschaft anwenden kann.

Für die Nachbarschaftstypen NbrAnnulus, Nbrcircle, NbrRectangle und NbrWedge können die Entfernungseinheiten der Parameter als Einheiten der CELL oder der MAP angegeben werden. Die Standardeinstellung sind Zelleneinheiten.

Bei Kernel-Nachbarschaften definiert die erste Zelle in der Kernel-Datei die Breite und Höhe der Nachbarschaft als Anzahl von Zellen. In den darauffolgenden Zeilen ist angegeben, wie der Eingabewert verarbeitet wird, der der jeweiligen Position im Kernel entspricht. Ist beim Nachbarschaftstyp "Unregelmäßig" oder "Gewichtung" ein Wert von 0 in der Kernel-Datei angegeben, wird die entsprechende Position nicht in die Berechnung einbezogen. Bei einer unregelmäßigen Nachbarschaft bedeutet ein Wert von 1, dass die entsprechende Eingabezelle in die Berechnung einbezogen wird. Bei einer gewichteten Nachbarschaft gibt der Wert für die jeweilige Position an, mit welchem Faktor der Eingabezellenwert multipliziert wird. Es können positive, negative sowie Dezimalwerte verwendet werden.

Neighborhood
statistics_type
(optional)

Gibt den zu berechnenden Statistiktyp an.

  • MEANDer Mittelwert (Durchschnittswert) der Zellen innerhalb der Nachbarschaft wird berechnet.
  • MAJORITYDie Mehrheit (der am häufigsten auftretende Wert) der Zellen innerhalb der Nachbarschaft wird berechnet.
  • MAXIMUMDer Maximalwert (der höchste Wert) der Zellen innerhalb der Nachbarschaft wird berechnet.
  • MEDIANDer Medianwert der Zellen innerhalb der Nachbarschaft wird berechnet.
  • MINIMUMDer Minimalwert (der kleinste Wert) der Zellen innerhalb der Nachbarschaft wird berechnet.
  • MINORITYDie Minderheit (der am seltensten auftretende Wert) der Zellen innerhalb der Nachbarschaft wird berechnet.
  • PERCENTILEEin Perzentil der Zellen innerhalb der Nachbarschaft 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 Zellen in der Nachbarschaft wird berechnet.
  • STDDie Standardabweichung der Zellen innerhalb der Nachbarschaft wird berechnet.
  • SUMDie Summe der Zellen innerhalb der Nachbarschaft wird berechnet.
  • VARIETYDie Varianz (die Anzahl der Einzelwerte) der Zellen innerhalb der Nachbarschaft wird berechnet.

Der Standardstatistiktyp ist MEAN.

Wenn das Eingabe-Raster ein Ganzzahl-Raster ist, sind alle Statistiktypen verfügbar. Wenn das Eingabe-Raster ein Gleitkomma-Raster ist, sind nur die Statistiktypen MEAN, MAXIMUM, MEDIAN, MINIMUM, PERCENTILE, RANGE, STD und SUM verfügbar.

String
ignore_nodata
(optional)

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

  • DATAEin NoData-Wert innerhalb einer Nachbarschaft wird ignoriert, falls vorhanden. Nur Zellen innerhalb der Nachbarschaft, die Datenwerte aufweisen, werden bei der Ermittlung des Ausgabewertes verwendet. Handelt es sich beim Wert der bearbeiteten Zelle um einen NoData-Wert, bedeutet dies, dass die bearbeitete Zelle einen Wert im Ausgabe-Raster erhalten kann, wenn diese Option ausgewählt wurde. Voraussetzung ist jedoch, dass mindestens eine Zelle in der Nachbarschaft über einen gültigen Wert verfügt. Dies ist die Standardeinstellung.
  • NODATAWenn eine Zelle in der Nachbarschaft den Wert "NoData" aufweist, erhält auch die Ausgabe für die bearbeitete Zelle den Wert "NoData". Bei Auswahl dieser Option bedeutet das Vorhandensein eines NoData-Wertes, dass nicht genügend Informationen verfügbar sind, um den statistischen Wert für die Nachbarschaft zu bestimmen.
Boolean
percentile_value
(optional)

Das zu berechnende Perzentil. Der Standardwert ist 90 für das 90. Perzentil.

Zulässige Werte können 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.

Diese Option wird nur unterstützt, wenn für den Parameter statistics_type die Option PERCENTILE festgelegt wurde. Wenn ein anderer Statistiktyp angegeben wurde, wird dieser Parameter ignoriert.

Double

Rückgabewert

NameErläuterungDatentyp
out_raster

Das Ausgabe-Raster für "Focal Statistics".

Raster

Codebeispiel

FocalStatistics – Beispiel 1 (Python-Fenster)

In diesem Beispiel wird der am wenigsten häufig auftretende Wert in einer ringförmigen Nachbarschaft um jede Zelle im Eingabe-Raster berechnet.

import arcpy
from arcpy import env
from arcpy.ia import *
env.workspace = "C:/data"
outFocalStat = FocalStatistics("elevation", NbrAnnulus(5, 10, "CELL"), 
                               "MINORITY", "NODATA")
outFocalStat.save("C:/output/focalstat01")
FocalStatistics – Beispiel 2 (eigenständiges Skript)

In diesem Beispiel wird der am wenigsten häufig auftretende Wert in einer 10x10-Nachbarschaft um jede Zelle im Eingabe-Raster ermittelt.

# Name: FocalStatistics_Ex_02.py
# Description: Calculates a statistic on a raster over a specified
#    neighborhood.
# Requirements: Image Analyst Extension

# Import system modules
import arcpy
from arcpy import env
from arcpy.ia import *

# Set environment settings
env.workspace = "C:/data"

# Set local variables
inRaster = "elevation"
neighborhood = NbrRectangle(10, 10, "CELL")

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

# Execute FocalStatistics
outFocalStatistics = FocalStatistics(inRaster, neighborhood, "MINORITY",
                                     "")

# Save the output 
outFocalStatistics.save("C:/output/focalstatout")

Lizenzinformationen

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

Verwandte Themen