Berechnet in einem Moving Window und entlang einer bestimmten Dimension Statistiken für multidimensionale Daten.
Verwendung
Gleitende Statistiken können auch als Statistiken des Moving Window oder rollende bzw. laufende Statistiken bezeichnet werden. Ein vordefiniertes Fenster zu den einzelnen Dimensionswerten wird verwendet, um verschiedene Statistiken zu berechnen, bevor der Übergang zur nächsten Statistik erfolgt. Mit den Parametern Rückwärtsgleitendes Fenster und Vorwärtsgleitendes Fenster können Sie Fenstergrößen auf beiden Seiten der Dimension definieren.
Das Eingabe-Raster muss ein multidimensionales Raster im Cloud-Raster-Format (.crf-Datei) sein.
Von diesem Werkzeug wird nur eine Dimension verarbeitet. Standardmäßig wird die erste Dimension, die nicht x,y ist, als Verarbeitungsdimension verwendet.
Mit dem Statistiktyp Zirkulärer Mittelwert wird der Mittelwert für Winkel oder andere zirkuläre Größen, wie etwa die Himmelsrichtung in Grad, berechnet. Wenn diese Option ausgewählt ist, wird der Parameter Umbruchwert für Verteilung auf Einheitskreis verfügbar. Verwenden Sie diesen Parameter, um einen Umbruchwert zum Berechnen des zirkulären Mittelwertes festzulegen. Bei einer Winkelberechnung muss der Umbruchwert für die Verteilung auf den Einheitskreis beispielsweise 360 Grad betragen. Das bedeutet, dass der Wert 360 auf 0 und der Wert 370 auf 10 umgebrochen wird. Eine andere Verwendung ist die Zeitberechnung von Monaten in einem Jahr. Dabei muss der Umbruchwert 12 betragen. In diesem Fall wird der Eingabewert 13 auf 1 umgebrochen.
Wenn es sich beim multidimensionalen Eingabe-Raster um eine ganze Zahl handelt, lauten die gültigen Optionen für den Statistiktyp wie folgt: Mittelwert, Zirkulärer Mittelwert, Mehrheit, Maximum, Medianwert, Minimum und Perzentil. Wenn es sich beim Eingabe-Raster um ein Gleitkomma-Raster handelt, ist der Typ Mehrheit nicht verfügbar.
Bei einem ganzzahligen Eingabe-Raster ist auch das Ausgabe-Raster für die Optionen Mehrheit, Maximum und Minimum ganzzahlig. Für die Statistiken Mittelwert, Zirkulärer Mittelwert, Medianwert und Perzentil ist das Ausgabe-Raster ein Gleitkomma-Raster.
Wenn das Eingabe-Raster vom Typ "Gleitkomma" ist, ist auch die Ausgabe für alle verfügbaren Statistiktypen vom Typ "Gleitkomma".
Bei der Option Mehrheit wird bei einem Gleichstand der niedrigste der beiden Werte ausgegeben.
Das Eingabe-Raster muss ein multidimensionales Raster im Cloud-Raster-Format (.crf-Datei) sein.
Raster Layer
Dimension
(Optional)
Der Name der Dimension an der das Fenster entlanggleitet.
Der Standardwert ist die erste Dimension im multidimensionalen Eingabe-Raster, die nicht x,y ist.
String
Rückwärtsgleitendes Fenster
(Optional)
Die Anzahl der vorausgehenden oder höheren Intervalle, die im definierten Fenster berücksichtigt werden sollen. Der Wert muss eine positive ganze Zahl von 1 bis 100 sein. Der Standardwert ist 1.
Die Einheit dieses Parameters ist das Intervall.
Long
Vorwärtsgleitendes Fenster
(Optional)
Die Anzahl der nachfolgenden oder niedrigeren Intervalle, die im definierten Fenster berücksichtigt werden sollen. Der Wert muss eine positive ganze Zahl von 1 bis 100 sein. Der Standardwert ist 1.
Die Einheit dieses Parameters ist das Intervall.
Long
Umgang mit NoData-Werten
(Optional)
Gibt an, wie NoData-Werte bei der Statistikberechnung behandelt werden.
Daten—NoData-Werte im definierten Fenster werden bei der Berechnung der ausgewählten Statistik ignoriert. Nur Zellen innerhalb des definierten Fensters, die Datenwerte aufweisen, werden bei der Ermittlung des Ausgabewertes verwendet. Wenn die Verarbeitungszelle einen NoData-Wert aufweist, erhält diese Zelle im Ausgabe-Raster einen Wert, sofern mindestens eine Zelle innerhalb des definierten Fensters über einen gültigen Wert verfügt. Dies ist die Standardeinstellung.
NoData—Ausgabewerte sind NoData-Werte, wenn sich im definierten Fenster NoData-Werte befinden. Das Vorhandensein eines NoData-Wertes bedeutet, dass nicht genügend Informationen verfügbar sind, um den statistischen Wert für das definierte Fenster zu bestimmen.
NoData-Werte füllen—NoData-Zellenwerte werden in der Ausgabe durch die ausgewählte für die Werte im definierten Fenster berechnete Statistik ersetzt. Eingabezellen, die Datenwerte aufweisen, werden in der Ausgabe unverändert beibehalten.
String
Statistiktyp
(Optional)
Gibt den zu berechnenden Statistiktypen an.
Mittelwert—Der Mittelwert (Durchschnittswert) der Zellen in dem definierten Fenster wird berechnet. Dies ist die Standardeinstellung.
Zirkulärer Mittelwert—Der Mittelwert für Winkel oder andere zirkuläre Größen, wie etwa die Himmelsrichtung in Grad, Tageszeiten oder Bruchteile von reellen Zahlen, wird berechnet. Wenn dieser Statistiktyp angegeben ist, wird der Parameter Umbruchwert für Verteilung auf Einheitskreis verfügbar. Verwenden Sie diesen Parameter, um einen Umbruchwert festzulegen.
Mehrheit—Die Mehrheit (der am häufigsten auftretende Wert) in dem definierten Fenster wird berechnet.
Maximum—Der Maximalwert (der höchste Wert) in dem definierten Fenster wird berechnet.
Medianwert—Der Medianwert der Zellen im definierten Fenster wird identifiziert.
Minimum—Der Minimalwert (der kleinste Wert) in dem definierten Fenster wird berechnet.
Perzentil—Ein Perzentil der Zellen in dem definierten Fenster wird berechnet. Standardmäßig wird das 90. Perzentil berechnet. Wenn dieser Statistiktyp angegeben ist, werden die Parameter Perzentilwert und Perzentil-Interpolationstyp verfügbar. Verwenden Sie diese neuen Parameter, um das zu berechnende Perzentil festzulegen bzw. den zu verwendenden Interpolationstyp auszuwählen.
String
Perzentilwert
(Optional)
Der zu berechnende Perzentilwert. Der Standardwert ist 90 für das 90. Perzentil.
Die Wert kann im Bereich von 0 bis 100 liegen. Grundsätzlich entspricht der Perzentilwert 0 statistisch gesehen dem Minimum und der Perzentilwert 100 dem Maximum. Der Wert 50 ergibt im Wesentlichen dasselbe Ergebnis wie der Medianwert der Statistik.
Dieser Parameter wird nur unterstützt, wenn für den Parameter Statistiktyp die Option Perzentil festgelegt wurde.
Double
Perzentil-Interpolationstyp
(Optional)
Gibt die Interpolationsmethode an, die verwendet wird, wenn der Perzentilwert zwischen zwei Zellenwerten liegt.
Dieser Parameter wird nur unterstützt, wenn für den Parameter Statistiktyp die Option Mittelwert oder Perzentil festgelegt wurde.
Automatisch erkennen—Weist das Eingabe-Werte-Raster einen ganzzahligen Pixeltyp auf, wird die Methode Nächster Nachbar verwendet. Weist das Eingabe-Werte-Raster einen Gleitkomma-Pixeltyp auf, wird die Methode Linear verwendet. Dies ist die Standardeinstellung.
Nächster Nachbar—Es wird der dem Perzentil am nächsten liegende verfügbare Wert verwendet. In diesem Fall entspricht der Ausgabepixeltyp dem des Eingabe-Rasters.
Linear—Es wird der gewichtete Durchschnitt der beiden umgebenden Werte aus dem Perzentil verwendet. In diesem Fall ist der Ausgabepixeltyp "Gleitkomma".
String
Umbruchwert für Verteilung auf Einheitskreis
(Optional)
Der Wert, der verwendet wird, um einen linearen Wert in den Bereich eines bestimmten zirkulären Mittelwertes zu konvertieren. Der Wert muss positiv sein. Der Standardwert beträgt 360 Grad.
Dieser Parameter wird nur unterstützt, wenn für den Parameter Statistiktyp die Option Zirkulärer Mittelwert festgelegt wurde.
Double
Abgeleitete Ausgabe
Beschriftung
Erläuterung
Datentyp
Argumente der Raster-Funktion: JSON
Die Argumente der Funktion. Diese Ausgabe ist nur für die interne Verwendung vorgesehen.
String
Rückgabewert
Beschriftung
Erläuterung
Datentyp
Multidimensionales Ausgabe-Raster
Das Ausgabe-Raster muss ein multidimensionales Raster im Cloud-Raster-Format (.crf-Datei) sein.
Das Eingabe-Raster muss ein multidimensionales Raster im Cloud-Raster-Format (.crf-Datei) sein.
Raster Layer
dimension
(Optional)
Der Name der Dimension an der das Fenster entlanggleitet.
Der Standardwert ist die erste Dimension im multidimensionalen Eingabe-Raster, die nicht x,y ist.
String
backward_window
(Optional)
Die Anzahl der vorausgehenden oder höheren Intervalle, die im definierten Fenster berücksichtigt werden sollen. Der Wert muss eine positive ganze Zahl von 1 bis 100 sein. Der Standardwert ist 1.
Die Einheit dieses Parameters ist das Intervall.
Long
forward_window
(Optional)
Die Anzahl der nachfolgenden oder niedrigeren Intervalle, die im definierten Fenster berücksichtigt werden sollen. Der Wert muss eine positive ganze Zahl von 1 bis 100 sein. Der Standardwert ist 1.
Die Einheit dieses Parameters ist das Intervall.
Long
nodata_handling
(Optional)
Gibt an, wie NoData-Werte bei der Statistikberechnung behandelt werden.
DATA—NoData-Werte im definierten Fenster werden bei der Berechnung der ausgewählten Statistik ignoriert. Nur Zellen innerhalb des definierten Fensters, die Datenwerte aufweisen, werden bei der Ermittlung des Ausgabewertes verwendet. Wenn die Verarbeitungszelle einen NoData-Wert aufweist, erhält diese Zelle im Ausgabe-Raster einen Wert, sofern mindestens eine Zelle innerhalb des definierten Fensters über einen gültigen Wert verfügt. Dies ist die Standardeinstellung.
NODATA—Ausgabewerte sind NoData-Werte, wenn sich im definierten Fenster NoData-Werte befinden. Das Vorhandensein eines NoData-Wertes bedeutet, dass nicht genügend Informationen verfügbar sind, um den statistischen Wert für das definierte Fenster zu bestimmen.
FILL_NODATA—NoData-Zellenwerte werden in der Ausgabe durch die ausgewählte für die Werte im definierten Fenster berechnete Statistik ersetzt. Eingabezellen, die Datenwerte aufweisen, werden in der Ausgabe unverändert beibehalten.
String
statistics_type
(Optional)
Gibt den zu berechnenden Statistiktypen an.
MEAN—Der Mittelwert (Durchschnittswert) der Zellen in dem definierten Fenster wird berechnet. Dies ist die Standardeinstellung.
CIRCULAR_MEAN—Der Mittelwert für Winkel oder andere zirkuläre Größen, wie etwa die Himmelsrichtung in Grad, Tageszeiten oder Bruchteile von reellen Zahlen, wird berechnet. Wenn dieser Statistiktyp angegeben ist, verwenden Sie den Parameter circular_wrap_value, um einen Umbruchwert festzulegen.
MAJORITY—Die Mehrheit (der am häufigsten auftretende Wert) in dem definierten Fenster wird berechnet.
MAXIMUM—Der Maximalwert (der höchste Wert) in dem definierten Fenster wird berechnet.
MEDIAN—Der Medianwert der Zellen im definierten Fenster wird identifiziert.
MINIMUM—Der Minimalwert (der kleinste Wert) in dem definierten Fenster wird berechnet.
PERCENTILE—Ein Perzentil der Zellen in dem definierten Fenster wird berechnet. Standardmäßig wird das 90. Perzentil berechnet. Wenn dieser Statistiktyp angegeben ist, verwenden Sie die Parameter percentile_value und percentile_interpolation_type, um das zu berechnende Perzentil festzulegen bzw. den zu verwendenden Interpolationstyp auszuwählen.
String
percentile_value
(Optional)
Der zu berechnende Perzentilwert. Der Standardwert ist 90 für das 90. Perzentil.
Die Wert kann im Bereich von 0 bis 100 liegen. Grundsätzlich entspricht der Perzentilwert 0 statistisch gesehen dem Minimum und der Perzentilwert 100 dem Maximum. Der Wert 50 ergibt im Wesentlichen dasselbe Ergebnis wie der Medianwert der Statistik.
Dieser Parameter wird nur unterstützt, wenn der Parameter statistics_type auf PERCENTILE festgelegt wurde. Wenn ein anderer Statistiktyp angegeben wurde, wird dieser Parameter ignoriert.
Double
percentile_interpolation_type
(Optional)
Gibt die Interpolationsmethode an, die verwendet wird, wenn der Perzentilwert zwischen zwei Zellenwerten liegt.
Dieser Parameter wird nur unterstützt, wenn der Parameter statistics_type auf MEDIAN oder PERCENTILE festgelegt wurde. Wenn ein anderer Statistiktyp angegeben wurde, wird dieser Parameter ignoriert.
AUTO_DETECT—Weist das Eingabe-Raster einen ganzzahligen Pixeltyp auf, wird die Methode NEAREST verwendet. Weist das Eingabe-Raster einen Gleitkomma-Pixeltyp auf, wird die Methode LINEAR verwendet.
NEAREST—Es wird der dem Perzentil am nächsten liegende verfügbare Wert verwendet. In diesem Fall entspricht der Ausgabepixeltyp dem des Eingabe-Rasters.
LINEAR—Es wird der gewichtete Durchschnitt der beiden umgebenden Werte aus dem Perzentil verwendet. In diesem Fall ist der Ausgabepixeltyp "Gleitkomma".
String
circular_wrap_value
(Optional)
Der Wert, der verwendet wird, um einen linearen Wert in den Bereich eines bestimmten zirkulären Mittelwertes zu konvertieren. Der Wert muss positiv sein. Der Standardwert beträgt 360 Grad.
Dieser Parameter wird nur unterstützt, wenn der Parameter statistics_type auf CIRCULAR_MEAN festgelegt wurde. Wenn ein anderer Statistiktyp angegeben wurde, wird dieser Parameter ignoriert.
Double
Abgeleitete Ausgabe
Name
Erläuterung
Datentyp
raster_function_arguments_json
Die Argumente der Funktion. Diese Ausgabe ist nur für die interne Verwendung vorgesehen.
String
Rückgabewert
Name
Erläuterung
Datentyp
out_raster
Das Ausgabe-Raster muss ein multidimensionales Raster im Cloud-Raster-Format (.crf-Datei) sein.
Raster
Codebeispiel
DimensionalMovingStatistics: Beispiel 1 (Python-Fenster)
In diesem Beispiel wird der Mittelwert in einem dreiteiligen Fenster um jede Zelle im multidimensionalen Eingabe-Raster berechnet.
DimensionalMovingStatistics: Beispiel 2 (eigenständiges Skript)
In diesem Beispiel wird der am häufigsten auftretende Wert in einem fünfteiligen Moving Window um jede Zelle im multidimensionalen Eingabe-Raster ermittelt.
# Name: DimensionalMovingStatistics_standalone.py
# Description: Calculates majority on a multidimensional raster
# along its time dimension.
# Requirements: Image Analyst extension
# Import system modules
import arcpy
from arcpy import env
from arcpy.ia import *
# Set the analysis environment
env.workspace = "C:/iapyexamples/data"
# Set local variables
in_raster = "mining_location.crf"
dimension = "StdTime"
backward_window = 2
forward_window = 2
nodata_handling = "FILL_NODATA"
statistics_type = "MAJORITY"
# Run DimensionalMovingStatistics
out_dimstats = DimensionalMovingStatistics(in_raster, dimension,
backward_window, forward_window, nodata_handling,
statistics_type)
# Save the output
out_dimstats.save("C:/iapyexamples/output/mining_location_out.crf")