Block-Statistiken (Spatial Analyst)

Lizenzstufe:BasicStandardAdvanced

Zusammenfassung

Partitioniert die Eingabe in nicht überlappende Blöcke und berechnet die Statistik der Werte innerhalb jedes Blocks. Der Wert wird allen Zellen in jedem Block in der Ausgabe zugewiesen.

Weitere Informationen zur Funktionsweise von "Block-Statistiken"

Bild

Abbildung: Block-Statistiken mit Option "Maximum"
OutRas = BlockStatistics(InRas1, NbrRectangle(3,3,MAP), "MAXIMUM", "")

Verwendung

Syntax

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

Das Raster, in dem die Block-Statistik-Berechnungen durchgeführt werden sollen.

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 innerhalb einer Block-Nachbarschaft vorhandener NoData-Wert ignoriert wird. Nur Zellen innerhalb der Nachbarschaft, die Datenwerte aufweisen, werden bei der Ermittlung des Ausgabewertes verwendet. Dies ist die Standardeinstellung.
  • NODATA Wenn eine Zelle innerhalb der Nachbarschaft den Wert "NoData" aufweist, erhält auch die Ausgabe für diese Zelle in dem entsprechenden Block 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 "Block-Statistiken".

Raster

Codebeispiel

BlockStatistics – Beispiel 1 (Python-Fenster)

In diesem Beispiel wird der minimale Zellenwert für jede nicht überlappende Kreisringnachbarschaft (ringförmig) im Eingabe-GRID-Raster berechnet.

import arcpy
from arcpy import env  
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
nbr = NbrAnnulus(1, 3, "MAP")
outBlockStat = BlockStatistics("block", nbr, "MINIMUM", "")
outBlockStat.save("C:/sapyexamples/output/blockstat")
BlockStatistics – Beispiel 2 (eigenständiges Skript)

In diesem Beispiel wird der minimale Zellenwert für jede nicht überlappende Kreisringnachbarschaft (ringförmig) im Eingabe-GRID-Raster berechnet.

# Name: BlockStatistics_Ex_02.py
# Description: Calculates statistics for a nonoverlapping 
#              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 = "block"
nbr = NbrAnnulus(1, 3, "MAP")

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

# Execute BlockStatistics
outBlockStat = BlockStatistics(inRaster, nbr, "MINIMUM", "NODATA")

# Save the output 
outBlockStat.save("C:/sapyexamples/output/blockstat")

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