Focal Statistics (Spatial Analyst)

Lizenzstufe:BasicStandardAdvanced

Zusammenfassung

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

Weitere Informationen über die Funktionsweise des Werkzeugs "Focal Statistics"

Bild

Abbildung: Focal Statistics
OutRas = FocalStatistics(InRas1, NbrRectangle(3,3,MAP), "SUM", "")

Verwendung

Syntax

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

Das Raster, in dem die fokalen Statistikberechnungen durchgeführt werden.

Raster Layer
neighborhood
(optional)

Die Klasse Nachbarschaft definiert die Form der Fläche um jede Zelle, die zum Berechnen der Statistik verwendet wird.

Folgende Nachbarschaftstypen sind verfügbar: NbrAnnulus, NbrCircle, NbrRectangle, NbrWedge, NbrIrregular und NbrWeight.

Folgende Nachbarschaftsformen sind verfügbar:

  • NbrAnnulus({innerRadius}, {outerRadius}, {CELL | MAP})
  • NbrCircle({radius}, {CELL | MAP}
  • NbrRectangle({width}, {height}, {CELL | MAP})
  • NbrWedge({radius}, {start_angle}, {end_angle}, {CELL | MAP})
  • NbrIrregular(kernel_file)
  • NbrWeight(kernel_file)

Der Parameter {CELL | MAP} definiert für die Entfernungseinheiten entweder die Zelleneinheiten oder die Karteneinheiten.

Die Standardnachbarschaft ist das Quadrat NbrRectangle mit einer Breite und Höhe von drei Zellen.

Neighborhood
statistics_type
(optional)

Der zu berechnende Statistiktyp.

  • MEAN Berechnet den Mittelwert (den Durchschnittswert) der Zellen innerhalb der Nachbarschaft.
  • MAJORITY Berechnet die Mehrheit (den am häufigsten auftretenden Wert) der Zellen innerhalb der Nachbarschaft.
  • MAXIMUM Berechnet den Maximalwert (den höchsten Wert) der Zellen innerhalb der Nachbarschaft.
  • MEDIAN Berechnet den Medianwert der Zellen innerhalb der Nachbarschaft.
  • MINIMUM Berechnet den Minimalwert (den kleinsten Wert) der Zellen innerhalb der Nachbarschaft.
  • MINORITY Berechnet die Minderheit (den am seltensten auftretenden Wert) der Zellen innerhalb der Nachbarschaft.
  • RANGE Berechnet den Bereich (Differenz zwischen größtem und kleinstem Wert) der Werte innerhalb der Nachbarschaft.
  • STD Berechnet die Standardabweichung der Zellen innerhalb der Nachbarschaft.
  • SUM Berechnet die Summe (Summe aller Werte) der Zellen innerhalb der Nachbarschaft.
  • VARIETY Berechnet die Varianz (die Anzahl der Einzelwerte) der Zellen innerhalb der Nachbarschaft.

Der standardmäßige Statistiktyp ist MEAN.

String
ignore_nodata
(optional)

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

  • DATA Gibt an, dass ein NoData-Wert innerhalb einer Nachbarschaft ignoriert wird, falls vorhanden. Nur Zellen innerhalb der Nachbarschaft, die Datenwerte aufweisen, werden bei der Ermittlung des Ausgabewertes verwendet. 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

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.sa import *
env.workspace = "C:/sapyexamples/data"
outFocalStat = FocalStatistics("elevation", NbrAnnulus(5, 10, "CELL"), 
                               "MINORITY", "NODATA")
outFocalStat.save("C:/sapyexamples/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: 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
inRaster = "elevation"
neighborhood = NbrRectangle(10, 10, "CELL")

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

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

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

Umgebung

Verwandte Themen

Lizenzierungsinformationen

ArcGIS for Desktop Basic: Erfordert Spatial Analyst
ArcGIS for Desktop Standard: Erfordert Spatial Analyst
ArcGIS for Desktop Advanced: Erfordert Spatial Analyst
9/12/2013