| 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.
| 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 mit zusätzlichen Optionen aktiviert. | 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 |
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 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.
Parameter
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.
| 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. | 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
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")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"
# Execute BandCollectionStats
BandCollectionStats([inRasterBand1, inRasterBand2], outStatFile, "DETAILED", "COMPUTE_HISTOGRAM", "256", outHistTable)Umgebungen
Lizenzinformationen
- Basic: Erfordert Spatial Analyst
- Standard: Erfordert Spatial Analyst
- Advanced: Erfordert Spatial Analyst