Raster-Bänder-Statistiken (Spatial Analyst)—ArcGIS Pro

Mit der Spatial Analyst-Lizenz verfügbar.

Zusammenfassung

Berechnet die Statistiken für eine Gruppe von Raster-Bändern.

Weitere Informationen zur Funktionsweise von "Raster-Bänder-Statistiken"

Verwendung

Wenn ein Multiband-Raster als eines der Eingabe-Raster-Bänder (in_raster_bands in Python) angegeben wird, werden alle Bänder verwendet.
Wenn eine Auswahl von Bändern aus einem Multiband-Raster verarbeitet werden soll, können Sie zunächst mit dem Werkzeug Bänder zusammensetzen ein neues Raster-Dataset erstellen, das aus den betreffenden Bändern besteht, und das Ergebnis in der Liste der Eingabe-Raster-Bänder (in_raster_bands in Python) verwenden.
Die Raster-Bänder müssen einen gemeinsamen Schnittpunkt haben. Wenn dieser nicht vorhanden ist, tritt ein Fehler auf und es wird keine Ausgabe erzeugt.
Wenn die Ausdehnungen der Raster-Bänder nicht gleich sind, wird die Statistik auf der allgemeinen räumlichen Ausdehnung aller Eingabe-Raster-Bänder berechnet. Die Zellengröße ist standardmäßig die des Maximums der Eingabe-Raster; andernfalls hängt sie von den Umgebungseinstellungen zur Raster-Analyse ab.
Bei dem Parameter Kovarianz- und Korrelationsmatrizen berechnen gibt die deaktivierte Standardeinstellung (BRIEF in der Skripterstellung) an, dass nur Minimum, Maximum, Mittelwert und Standardabweichung der Eingabe-Raster-Bänder berechnet werden. Um zusätzlich zu diesen Statistiken die Kovarianz- und Korrelationsmatrizen zu berechnen, aktivieren Sie diese Option im Werkzeugdialogfeld (oder verwenden Sie DETAILED in der Skripterstellung).
Eine Kovarianzmatrix enthält die Varianzen aller Raster-Bänder entlang der Diagonale von links oben nach rechts unten und die Kovarianzen zwischen allen Raster-Bändern in den restlichen Einträgen. Die Korrelationsmatrix stellt die Korrelationskoeffizienten zwischen den einzelnen Kombinationen zweier Eingabebänder bereit.
In der Berechnung der Kovarianzmatrix wird der Mittelwert des Bandes für alle Eingabezellen verwendet, die einen NoData-Wert haben.
Die Statistiken werden im ASCII-Textformat in die Ausgabedatei geschrieben. Die Erweiterung für die Ausgabe muss .txt lauten.

Parameter

Beschriftung	Erläuterung	Datentyp
Eingabe-Raster-Bänder	Die Eingabe-Raster-Bänder. Die Raster können den Typ "Integer" oder "Gleitkomma" haben.	Raster Layer
Ausgabe-Statistikdatei	Die Ausgabe-ASCII-Datei, die die Statistiken enthält. Die Erweiterung .txt ist erforderlich.	File
Kovarianz- und Korrelationsmatrizen berechnen (optional)	Gibt an, ob Kovarianz- und Korrelationsmatrizen berechnet werden. Nicht aktiviert – Nur die grundlegenden statistischen Messwerte (Minimum, Maximum, Mittelwert und Standardabweichung) werden für jeden Layer berechnet. Dies ist die Standardeinstellung. Aktiviert – Zusätzlich zu den berechneten Standardstatistiken werden auch die Kovarianz- und Korrelationsmatrizen ermittelt.	Boolean

BandCollectionStats(in_raster_bands, out_stat_file, {compute_matrices})

Name	Erläuterung	Datentyp
in_raster_bands [in_raster_band,...]	Die Eingabe-Raster-Bänder. Die Raster können den Typ "Integer" oder "Gleitkomma" haben.	Raster Layer
out_stat_file	Die Ausgabe-ASCII-Datei, die die Statistiken enthält. Die Erweiterung .txt ist erforderlich.	File
compute_matrices (optional)	Gibt an, ob Kovarianz- und Korrelationsmatrizen berechnet werden. BRIEF— Nur die grundlegenden statistischen Messwerte (Minimum, Maximum, Mittelwert und Standardabweichung) werden für jeden Layer berechnet. Dies ist die Standardeinstellung. DETAILED— Zusätzlich zu den mit {BRIEF} berechneten Standardstatistiken werden auch die Kovarianz- und Korrelationsmatrizen ermittelt.	Boolean

Codebeispiel

BandCollectionStatistics – Beispiel 1 (Python-Fenster)

In diesem Beispiel werden die Statistiken für eine Gruppe von Raster-Bändern berechnet.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
BandCollectionStats("redlands", "c:/sapyexamples/output/redbandstats.txt", "BRIEF")

BandCollectionStatistics – Beispiel 2 (eigenständiges Skript)

In diesem Beispiel werden die Statistiken für eine Gruppe von Raster-Bändern berechnet.

# Name: BandCollectionStats_Ex_02.py
# Description: Calculates the statistics for a set of raster bands.
# 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
inRasterBand1 = "sb/sbc1"
inRasterBand2 = "sb/sbc2"
outStatFile = "C:/sapyexamples/output/bandstatfile.txt"

# Execute BandCollectionStats
BandCollectionStats([inRasterBand1, inRasterBand2], outStatFile, "DETAILED")

Umgebungen

Aktueller Workspace, Scratch-Workspace

Lizenzinformationen

Basic: Erfordert Spatial Analyst
Standard: Erfordert Spatial Analyst
Advanced: Erfordert Spatial Analyst