Statistiken berechnen (Data Management)

Zusammenfassung

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

Statistiken sind notwendig, damit bestimmte Tasks für ein Raster-Dataset und Mosaik-Dataset 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.

  • Die Sprungfaktoren für Raster-Datasets in File-Geodatabases und in Enterprise-Geodatabases unterscheiden sich erheblich. Erstens, wenn die X- und die Y-Sprungfaktoren unterschiedlich sind, wird der kleinere Sprungfaktor für den X- und den Y-Sprungfaktor verwendet. Zweitens, der Sprungfaktor ist mit der Pyramidenebene verbunden, die dem gewählten Sprungfaktor am nächsten ist. Falls der Sprungfaktorwert nicht der Anzahl der Pixel in einer Pyramide entspricht (wenn also zum Beispiel der Sprungfaktor 5 ist und die nächste Pyramidenebene 4 x 4 Pixel ist, also Ebene 2), rundet die Software auf die nächste Pyramidenebene (in diesem Fall 2) ab und verwendet diesen Wert als Sprungfaktor.

  • Nicht für jedes Raster-Format wird ein Sprungfaktor verwendet. Für folgende Raster-Formate werden Statistiken berechnet und wird ein Sprungfaktor verwendet: TIFF, IMG, NITF, DTED, RAW, ADRG, CIB, CADRG, DIGEST, GIS, LAN, CIT, COT, ERMapper, ENVI DAT, BIL, BIP, BSQ und Geodatabase.

  • 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 sehr zu empfehlen, da diese Datasets meist sehr groß sind.

  • Mit der Option "Ausschlusswerte" können Sie einen bestimmten Wert aus der Berechnung der Statistiken ausschließen. Dies ist beispielsweise hilfreich, wenn Sie über Werte ohne Daten (NoData) verfügen oder wenn einzelne Werte die Berechnung verzerren würden.

  • Für die Berechnung von Statistiken für das Esri Grid- und RADARSAT2-Format wird immer der Sprungfaktor 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.

Syntax

arcpy.management.CalculateStatistics(in_raster_dataset, {x_skip_factor}, {y_skip_factor}, {ignore_values}, {skip_existing}, {area_of_interest})
ParameterErklärungDatentyp
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.

Die Sprungfaktoren für Raster-Datasets in File-Geodatabases und in Enterprise-Geodatabases sind unterschiedlich. Erstens, wenn die X- und die Y-Sprungfaktoren unterschiedlich sind, wird der kleinere Sprungfaktor für den X- und den Y-Sprungfaktor verwendet. Zweitens, der Sprungfaktor ist mit der Pyramidenebene verbunden, die dem gewählten Sprungfaktor am nächsten ist. 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.

Die Sprungfaktoren für Raster-Datasets in File-Geodatabases und in Enterprise-Geodatabases sind unterschiedlich. Erstens, wenn die X- und die Y-Sprungfaktoren unterschiedlich sind, wird der kleinere Sprungfaktor für den X- und den Y-Sprungfaktor verwendet. Zweitens, der Sprungfaktor ist mit der Pyramidenebene verbunden, die dem gewählten Sprungfaktor am nächsten ist. 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)

Geben Sie an, ob nur Statistiken berechnet werden sollen, wo sie fehlen, oder ob auch vorhandene Statistiken neu erstellt werden sollen.

  • OVERWRITEStatistiken werden berechnet, auch wenn sie bereits vorhanden sind. Daher werden vorhandene Statistiken überschrieben. Dies ist die Standardeinstellung.
  • SKIP_EXISTINGStatistiken werden nur berechnet, wenn sie noch nicht vorhanden sind.
Boolean
area_of_interest
(optional)

Die Feature-Class, die den Bereich im Dataset darstellt, anhand dessen Sie die Statistik berechnen möchten, damit nicht das ganze Dataset herangezogen wird.

Feature Set

Abgeleitete Ausgabe

NameErklärungDatentyp
out_raster

Das Ausgabe-Raster-Dataset.

Raster-Dataset

Codebeispiel

CalculateStatistics – Beispiel 1 (Python-Fenster)

Dies ist ein Python-Beispiel für CalculateStatistics.

import arcpy
arcpy.CalculateStatistics_management(
     "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 CalculateStatistics.

# Calculate Statistics for single raster dataset

import arcpy
arcpy.env.workspace = "C:/Workspace"
    
arcpy.CalculateStatistics_management("image.tif", "4", "6", "0;255;21")

Lizenzinformationen

  • Basic: Ja
  • Standard: Ja
  • Advanced: Ja

Verwandte Themen