Raster-Bänder-Statistiken (Spatial Analyst Tools)

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 die Größe des Maximums der Eingabe-Raster.
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 diesen Parameter im Werkzeugdialogfeld (oder verwenden Sie DETAILED bei 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.
Wenn der Parameter Histogramm berechnen aktiviert ist, werden der Ausgabe-Statistikdatei Histogrammstatistiken hinzugefügt. Optional kann eine Ausgabe-Histogrammtabelle und ein Ausgabe-Histogrammdiagramm erstellt werden, wenn diese angegeben werden.
In der Ausgabe-Histogrammtabelle wird die Anzahl der Zellen im Layer <n>, die zu einem bestimmten Abschnitt gehören, in den l<n>_count-Feldern aufgezeichnet. In den l<n>_percent-Feldern wird der Prozentsatz der im Zählfeld gemeldeten Zellen aus der Gesamtanzahl der Zellen von Layer <n> im Analysebereich aufgezeichnet.
Die Statistiken werden im CSV-Format mit kommagetrennten Werten oder im Markdown-Format in die Ausgabedatei geschrieben. Die Erweiterung für die Ausgabe muss .txt, .md, .csv oder .asc lauten.
Alle mit diesem Werkzeug berechneten Statistiken mit Ausnahme des Histogramms werden im Bereich Geoverarbeitungsverlauf angezeigt. Wenn eine Histogrammtabelle und ein Diagramm erstellt wurden, werden sie unter Standalone-Tabellen im Bereich Inhalt angezeigt. Weitere Informationen finden Sie unter "Arbeiten mit Standalone-Tabellen" in Karten.

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-Datei im Text- oder Markdown-Format, die die Statistiken enthält. Die Erweiterung `.txt`, `.md`, `.csv` oder `.asc` ist erforderlich. Die Standardeinstellung ist `.txt`. Für die Ausgabe-Statistikdatei wird das CSV-Format verwendet, sofern nicht die Erweiterung `.md` angegeben wurde. In diesem Fall liegt die Ausgabedatei im Markdown-Format vor.	File
Kovarianz- und Korrelationsmatrizen berechnen (Optional)	Gibt an, ob Kovarianz- und Korrelationsmatrizen berechnet werden. Aktiviert—Zusätzlich zu den mit dem deaktivierten Parameter berechneten grundlegenden statistischen Messwerten werden auch die Kovarianz- und Korrelationsmatrizen berechnet. Deaktiviert—Nur die grundlegenden statistischen Messwerte (Minimum, Maximum, Mittelwert und Standardabweichung) werden für jeden Layer berechnet. Dies ist die Standardeinstellung.	Boolean
Histogramm berechnen (Optional)	Gibt an, ob Histogrammstatistiken berechnet werden. Wenn dieser Parameter aktiviert ist, werden die Parameter Anzahl der Histogrammabschnitte, Ausgabe-Histogrammtabelle und Ausgabe-Histogrammname unterstützt. Wenn der Parameter deaktiviert ist, werden diese anderen Parameter nicht unterstützt. Aktiviert—Histogrammstatistiken werden berechnet. Deaktiviert—Histogrammstatistiken werden nicht berechnet. Dies ist die Standardeinstellung.	Boolean
Anzahl der Histogrammabschnitte (Optional)	Gibt die Anzahl der Histogrammabschnitte an, die bei der Histogrammberechnung verwendet werden. Der Standardwert ist 256. Der kleinste zulässige Wert ist 1. Der höchste zulässige Wert ist 4096. Der Wert dieses Parameters sollte den Eingabedaten und der Analyseanwendung entsprechend festgelegt werden.	Long
Ausgabe-Histogrammtabelle (Optional)	Die Ausgabetabelle, die die Histogrammstatistiken für alle Eingabebänder enthalten soll. Das Format der Tabelle wird durch das Ausgabeverzeichnis und den Ausgabepfad bestimmt. Standardmäßig handelt es sich bei der Ausgabe um eine Geodatabase-Tabelle in einem Geodatabase-Workspace bzw. um eine dBASE-Tabelle (`.dbf`-Datei) in einem Datei-Workspace. Zum Erstellen einer Ausgabe-Histogrammtabelle muss der Parameter Histogramm berechnen aktiviert werden.	Table
Ausgabe-Histogrammname (Optional)	Der angezeigte Name des Ausgabe-Histogramms. Das Histogramm wird im Bereich Inhalt unter Standalone-Tabellen aufgeführt. Zum Erstellen eines Ausgabe-Histogrammdiagramms muss der Parameter Ausgabe-Histogrammtabelle angegeben werden.	String

BandCollectionStats(in_raster_bands, out_stat_file, {compute_matrices}, {compute_histogram}, {number_bins}, {out_histogram_table}, {out_histogram})

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-Datei im Text- oder Markdown-Format, die die Statistiken enthält. Die Erweiterung `.txt`, `.md`, `.csv` oder `.asc` ist erforderlich. Die Standardeinstellung ist `.txt`. Für die Ausgabe-Statistikdatei wird das CSV-Format verwendet, sofern nicht die Erweiterung `.md` angegeben wurde. In diesem Fall liegt die Ausgabedatei im Markdown-Format vor.	File
compute_matrices (Optional)	Gibt an, ob Kovarianz- und Korrelationsmatrizen berechnet werden. `DETAILED`—Zusätzlich zu den mit der Option `BRIEF` berechneten grundlegenden statistischen Messwerten werden auch die Kovarianz- und Korrelationsmatrizen berechnet. `BRIEF`—Nur die grundlegenden statistischen Messwerte (Minimum, Maximum, Mittelwert und Standardabweichung) werden für jeden Layer berechnet. Dies ist die Standardeinstellung.	Boolean
compute_histogram (Optional)	Gibt an, ob Histogrammstatistiken berechnet werden. Wenn der Parameter auf `COMPUTE_HISTOGRAM` festgelegt ist, werden die Parameter `number_bins`, `out_histogram_table` und `out_histogram` unterstützt. Wenn der Parameter auf `NO_HISTOGRAM` festgelegt ist, werden diese anderen Parameter nicht unterstützt. `COMPUTE_HISTOGRAM`—Histogrammstatistiken werden berechnet. `NO_HISTOGRAM`—Histogrammstatistiken werden nicht berechnet. Dies ist die Standardeinstellung.	Boolean
number_bins (Optional)	Gibt die Anzahl der Histogrammabschnitte an, die bei der Histogrammberechnung verwendet werden. Der Standardwert ist 256. Der kleinste zulässige Wert ist 1. Der höchste zulässige Wert ist 4096. Der Wert dieses Parameters sollte den Eingabedaten und der Analyseanwendung entsprechend festgelegt werden.	Long
out_histogram_table (Optional)	Die Ausgabetabelle, die die Histogrammstatistiken für alle Eingabebänder enthalten soll. Das Format der Tabelle wird durch das Ausgabeverzeichnis und den Ausgabepfad bestimmt. Standardmäßig handelt es sich bei der Ausgabe um eine Geodatabase-Tabelle in einem Geodatabase-Workspace bzw. um eine dBASE-Tabelle (`.dbf`-Datei) in einem Datei-Workspace. Zum Erstellen einer Ausgabe-Histogrammtabelle muss der Parameter `compute_histogram` auf `COMPUTE_HISTOGRAM` festgelegt werden.	Table
out_histogram (Optional)	Der angezeigte Name des Ausgabe-Histogramms. Zum Erstellen eines Ausgabe-Histogrammdiagramms muss der Parameter `out_histogram_table` angegeben werden.	String

Codebeispiel

BandCollectionStats 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", "COMPUTE_HISTOGRAM", "256", "c:/sapyexamples/output/outtable01.dbf", "histogram01")

BandCollectionStats 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"
outHistTable = "C:/sapyexamples/output/output.gdb/outtable01"

# Run BandCollectionStats
BandCollectionStats([inRasterBand1, inRasterBand2], outStatFile, "DETAILED", "COMPUTE_HISTOGRAM", "256", outHistTable)

Umgebungen

Zellengröße, Projektionsmethode für Zellengröße, Aktueller Workspace, Ausdehnung, Geographische Transformationen, Maske, Ausgabe-Koordinatensystem, Faktor für parallele Verarbeitung, Scratch-Workspace, Fang-Raster

Lizenzierungsinformationen