Statistiken berechnen (Data Management Tools)

Zusammenfassung

Berechnet Statistiken für ein Raster-Dataset oder Mosaik-Dataset.

Statistiken sind notwendig, damit bestimmte Tasks für Raster-und Mosaik-Datasets durchgeführt werden können, z. B. die Streckung des Kontrasts oder das Klassifizieren der Daten.

Verwendung

Der Sprungfaktor steuert den Teil des Rasters, der bei der Berechnung von Statistiken verwendet wird. Der eingegebene Wert gibt den horizontalen oder vertikalen Sprungfaktor an. Bei einem Wert von 1 wird jedes Pixel verwendet, und bei einem Wert von 2 wird jedes zweite Pixel verwendet. Der Sprungfaktor muss zwischen 1 und der Anzahl der Spalten/Zeilen im Raster liegen.
Bei den Sprungfaktoren für in einer File-Geodatabase oder einer Enterprise-Geodatabase gespeicherte Raster-Datasets sieht es ganz anders aus. Erstens, wenn die X- und die Y-Sprungfaktoren unterschiedlich sind, wird der kleinere Sprungfaktor für den X- und den Y-Sprungfaktor verwendet. Zweitens bezieht sich der Sprungfaktor auf die Pyramidenebene, die am besten zum ausgewählten Sprungfaktor passt. Wenn der Wert des Sprungfaktors nicht gleich der Anzahl der Pixel in einer Pyramide ist (der Sprungfaktor beträgt beispielsweise 5 und die nächstgelegene Pyramidenebene umfasst 4 x 4 Pixel, was der Ebene 2 entspricht), rundet die Software auf die nächste Pyramidenebene ab (in diesem Fall auf 2) und verwendet diesen Wert als Sprungfaktor.
Ein Sprungfaktor wird nicht für alle Raster-Formate verwendet. Zu den Raster-Formaten, für die Statistiken berechnet werden und die den Überspringfaktor nutzen, gehören TIFF, IMG, NITF, DTED, RAW, ADRG, CIB, CADRG, DIGEST, GIS, LAN, CIT, COT, ERMapper, ENVI DAT, BIL, BIP, BSQ und Geodatabases.
Beim Verwenden dieses Werkzeugs zum Berechnen von Statistiken für ein Mosaik-Dataset werden die Statistikdaten für das mosaikierte Bild der obersten Ebene berechnet, nicht für jedes im Mosaik-Dataset enthaltene Raster.
Die Angabe eines Sprungfaktors für ein Mosaik-Dataset ist zu empfehlen, da diese Datasets meist sehr groß sind.
Mit der Option "Werte ignorieren" können Sie einen bestimmten Wert aus der Berechnung der Statistiken ausschließen. Sie können einen Wert ignorieren, wenn es sich um einen NoData-Wert handelt oder wenn dieser die Berechnung verfälschen würde.
Bei der Berechnung von Statistiken für die Formate "Esri Grid" und "RADARSAT2" wird grundsätzlich ein Sprungfaktor von 1 verwendet.
Wenn mit diesem Werkzeug Statistiken für ein multidimensionales Mosaik-Dataset berechnet werden, werden die Statistiken für jede Variable im Dataset berechnet.
Wenn der erste Histogrammabschnitt mehr als 50 Prozent der Werte enthält, wird der Medianwert auf den Minimalwert gesetzt.

Beschriftung	Erläuterung	Datentyp
Eingabe-Raster-Dataset	Das Eingabe-Raster-Dataset bzw. -Mosaik-Dataset.	Mosaic Dataset; Mosaic Layer; Raster Dataset
X-Sprungfaktor (Optional)	Die Anzahl der horizontalen Pixel zwischen den Stichproben. Der Sprungfaktor steuert den Teil des Rasters, der bei der Berechnung von Statistiken verwendet wird. Der eingegebene Wert gibt den horizontalen oder vertikalen Sprungfaktor an. Bei einem Wert von 1 wird jedes Pixel verwendet, und bei einem Wert von 2 wird jedes zweite Pixel verwendet. Der Sprungfaktor muss zwischen 1 und der Anzahl der Spalten/Zeilen im Raster liegen. Der Wert muss größer null und kleiner oder gleich der Spaltenanzahl im Raster sein. Der Standardwert ist 1 oder der zuletzt verwendete Sprungfaktor. Bei den Sprungfaktoren für in einer File-Geodatabase oder einer Enterprise-Geodatabase gespeicherte Raster-Datasets sieht es anders aus. Erstens, wenn die X- und die Y-Sprungfaktoren unterschiedlich sind, wird der kleinere Sprungfaktor für den X- und den Y-Sprungfaktor verwendet. Zweitens bezieht sich der Sprungfaktor auf die Pyramidenebene, die am besten zum ausgewählten Sprungfaktor passt. Wenn der Sprungfaktor nicht der Anzahl der Pixel in einer Pyramidenebene entspricht, wird auf die nächste Pyramidenebene abgerundet und diese Statistik verwendet.	Long
Y-Sprungfaktor (Optional)	Die Anzahl der vertikalen Pixel zwischen den Stichproben. Der Sprungfaktor steuert den Teil des Rasters, der bei der Berechnung von Statistiken verwendet wird. Der eingegebene Wert gibt den horizontalen oder vertikalen Sprungfaktor an. Bei einem Wert von 1 wird jedes Pixel verwendet, und bei einem Wert von 2 wird jedes zweite Pixel verwendet. Der Sprungfaktor muss zwischen 1 und der Anzahl der Spalten/Zeilen im Raster liegen. Der Wert muss größer null und kleiner oder gleich der Zeilenanzahl im Raster sein. Der Standardwert ist 1 oder der zuletzt verwendete Y-Sprungfaktor. Bei den Sprungfaktoren für in einer File-Geodatabase oder einer Enterprise-Geodatabase gespeicherte Raster-Datasets sieht es anders aus. Erstens, wenn die X- und die Y-Sprungfaktoren unterschiedlich sind, wird der kleinere Sprungfaktor für den X- und den Y-Sprungfaktor verwendet. Zweitens bezieht sich der Sprungfaktor auf die Pyramidenebene, die am besten zum ausgewählten Sprungfaktor passt. Wenn der Sprungfaktor nicht der Anzahl der Pixel in einer Pyramidenebene entspricht, wird auf die nächste Pyramidenebene abgerundet und diese Statistik verwendet.	Long
Ausschlusswerte (Optional)	Die Pixelwerte, die bei der Berechnung der Statistik ausgelassen werden sollen. Der Standardwert ist kein Wert bzw. entspricht dem zuletzt verwendeten Ausschlusswert.	Long
Vorhandene überspringen (Optional)	Gibt an, ob lediglich fehlende Statistiken berechnet oder ob auch vorhandene Statistiken neu generiert werden. Aktiviert—Statistiken werden nur berechnet, wenn sie noch nicht vorhanden sind. Deaktiviert—Statistiken werden berechnet, auch wenn sie bereits vorhanden sind, und vorhandene Statistiken werden überschrieben. Dies ist die Standardeinstellung.	Boolean
Interessenbereich (Optional)	Der Bereich im Dataset, anhand dessen die Statistik berechnet wird, damit nicht das ganze Dataset herangezogen wird. Suchen Sie entweder eine Feature-Class, oder erstellen Sie eine Polygon-Grafik auf der Anzeige.	Feature Set

Abgeleitete Ausgabe

Beschriftung	Erläuterung	Datentyp
Aktualisiertes Eingabe-Raster-Dataset	Das Ausgabe-Raster-Dataset.	Raster Dataset

arcpy.management.CalculateStatistics(in_raster_dataset, {x_skip_factor}, {y_skip_factor}, {ignore_values}, {skip_existing}, {area_of_interest})

Name	Erläuterung	Datentyp
in_raster_dataset	Das Eingabe-Raster-Dataset bzw. -Mosaik-Dataset.	Mosaic Dataset; Mosaic Layer; Raster Dataset
x_skip_factor (Optional)	Die Anzahl der horizontalen Pixel zwischen den Stichproben. Der Sprungfaktor steuert den Teil des Rasters, der bei der Berechnung von Statistiken verwendet wird. Der eingegebene Wert gibt den horizontalen oder vertikalen Sprungfaktor an. Bei einem Wert von 1 wird jedes Pixel verwendet, und bei einem Wert von 2 wird jedes zweite Pixel verwendet. Der Sprungfaktor muss zwischen 1 und der Anzahl der Spalten/Zeilen im Raster liegen. Der Wert muss größer null und kleiner oder gleich der Spaltenanzahl im Raster sein. Der Standardwert ist 1 oder der zuletzt verwendete Sprungfaktor. Bei den Sprungfaktoren für in einer File-Geodatabase oder einer Enterprise-Geodatabase gespeicherte Raster-Datasets sieht es anders aus. Erstens, wenn die X- und die Y-Sprungfaktoren unterschiedlich sind, wird der kleinere Sprungfaktor für den X- und den Y-Sprungfaktor verwendet. Zweitens bezieht sich der Sprungfaktor auf die Pyramidenebene, die am besten zum ausgewählten Sprungfaktor passt. Wenn der Sprungfaktor nicht der Anzahl der Pixel in einer Pyramidenebene entspricht, wird auf die nächste Pyramidenebene abgerundet und diese Statistik verwendet.	Long
y_skip_factor (Optional)	Die Anzahl der vertikalen Pixel zwischen den Stichproben. Der Sprungfaktor steuert den Teil des Rasters, der bei der Berechnung von Statistiken verwendet wird. Der eingegebene Wert gibt den horizontalen oder vertikalen Sprungfaktor an. Bei einem Wert von 1 wird jedes Pixel verwendet, und bei einem Wert von 2 wird jedes zweite Pixel verwendet. Der Sprungfaktor muss zwischen 1 und der Anzahl der Spalten/Zeilen im Raster liegen. Der Wert muss größer null und kleiner oder gleich der Zeilenanzahl im Raster sein. Der Standardwert ist 1 oder der zuletzt verwendete Y-Sprungfaktor. Bei den Sprungfaktoren für in einer File-Geodatabase oder einer Enterprise-Geodatabase gespeicherte Raster-Datasets sieht es anders aus. Erstens, wenn die X- und die Y-Sprungfaktoren unterschiedlich sind, wird der kleinere Sprungfaktor für den X- und den Y-Sprungfaktor verwendet. Zweitens bezieht sich der Sprungfaktor auf die Pyramidenebene, die am besten zum ausgewählten Sprungfaktor passt. Wenn der Sprungfaktor nicht der Anzahl der Pixel in einer Pyramidenebene entspricht, wird auf die nächste Pyramidenebene abgerundet und diese Statistik verwendet.	Long
ignore_values [ignore_value,...] (Optional)	Die Pixelwerte, die bei der Berechnung der Statistik ausgelassen werden sollen. Der Standardwert ist kein Wert bzw. entspricht dem zuletzt verwendeten Ausschlusswert.	Long
skip_existing (Optional)	Gibt an, ob lediglich fehlende Statistiken berechnet oder ob auch vorhandene Statistiken neu generiert werden. `SKIP_EXISTING`—Statistiken werden nur berechnet, wenn sie noch nicht vorhanden sind. `OVERWRITE`—Statistiken werden berechnet, auch wenn sie bereits vorhanden sind, und vorhandene Statistiken werden überschrieben. Dies ist die Standardeinstellung.	Boolean
area_of_interest (Optional)	Die Feature-Class, die den Bereich im Dataset repräsentiert, anhand dessen die Statistik berechnet wird, damit nicht das ganze Dataset herangezogen wird.	Feature Set

Abgeleitete Ausgabe

Name	Erläuterung	Datentyp
out_raster	Das Ausgabe-Raster-Dataset.	Raster Dataset

Codebeispiel

CalculateStatistics: Beispiel 1 (Python-Fenster)

Dies ist ein Python-Beispiel für die Funktion CalculateStatistics.

import arcpy
arcpy.management.CalculateStatistics(
     "C:/data/image.tif", "5", "5", "0;255",
     "SKIP_EXISTING", "c:/data/aoi.shp")

CalculateStatistics: Beispiel 2 (eigenständiges Skript)

Dies ist ein Python-Skriptbeispiel für die Funktion CalculateStatistics.

# Calculate Statistics for single raster dataset

import arcpy
arcpy.env.workspace = "C:/Workspace"

arcpy.management.CalculateStatistics("image.tif", "4", "6", "0;255;21")

Umgebungen

Aktueller Workspace, Faktor für parallele Verarbeitung, Raster-Statistiken, Scratch-Workspace

Lizenzierungsinformationen

Basic: Ja
Standard: Ja
Advanced: Ja

Statistiken berechnen (Data Management Tools)

Zusammenfassung

Verwendung

Parameter

Abgeleitete Ausgabe

Umgebungen

Lizenzierungsinformationen

Verwandte Themen