Gleitende Dimensionsstatistiken (Image Analyst)

Mit der Spatial Analyst-Lizenz verfügbar.

Mit der Image Analyst-Lizenz verfügbar.

Zusammenfassung

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 vor dem Wechsel zum nächsten verschiedene Statistiken zu berechnen. 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.

Parameter

BeschriftungErläuterungDatentyp
Multidimensionales Eingabe-Raster

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.

  • DatenNoData-Werte in der Werteingabe in den Ergebnissen des definierten Fensters, in dem sie sich befinden, werden ignoriert. Dies ist die Standardeinstellung.
  • NoDataAusgabewerte sind NoData-Werte, wenn sich in der Eingabe im definierten Fenster NoData-Werte befinden.
  • NoData-Werte füllenNoData-Zellenwerte werden durch die ausgewählte Statistik für die Werte im definierten Fenster ersetzt.
String
Statistiktyp
(optional)

Gibt den zu berechnenden Statistiktyp an.

  • MittelwertDer Mittelwert (Durchschnittswert) der Zellen in dem definierten Fenster wird berechnet. Dies ist die Standardeinstellung.
  • Zirkulärer MittelwertDer 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 ausgewählt ist, wird der Parameter Umbruchwert für Verteilung auf Einheitskreis verfügbar. Verwenden Sie diesen Parameter, um einen Umbruchwert festzulegen.
  • MehrheitDie Mehrheit (der am häufigsten auftretende Wert) in dem definierten Fenster wird berechnet.
  • MaximumDer Maximalwert (der höchste Wert) in dem definierten Fenster wird berechnet.
  • MedianwertDer Medianwert der Zellen im definierten Fenster wird identifiziert.
  • MinimumDer Minimalwert (der kleinste Wert) in dem definierten Fenster wird berechnet.
  • PerzentilEin Perzentil der Zellen in dem definierten Fenster wird berechnet. Standardmäßig wird das 90. Perzentil berechnet. Wenn dieser Statistiktyp ausgewählt 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 Perzentilwert wird berechnet. Der Standardwert ist 90 für das 90. Perzentil.

Zulässiger Wert kann zwischen 0 und 100 liegen. Grundsätzlich entspricht der Perzentilwert 0 statistisch gesehen der Statistik "Minimum" und der Perzentilwert 100 der Statistik "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 Median oder Perzentil festgelegt wurde.

  • Automatisch erkennenWeist 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.
  • Nächster NachbarEs wird der dem Perzentil am nächsten liegende verfügbare Wert verwendet. In diesem Fall entspricht der Ausgabepixeltyp dem des Eingabe-Rasters.
  • LinearEs 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

BeschriftungErläuterungDatentyp
Argumente der Raster-Funktion: JSON

Die Argumente der Funktion. Diese Ausgabe ist nur für die interne Verwendung vorgesehen.

String

Rückgabewert

BeschriftungErläuterungDatentyp
Multidimensionales Ausgabe-Raster

Das Ausgabe-Raster muss ein multidimensionales Raster im Cloud-Raster-Format (.crf-Datei) sein.

Raster

DimensionalMovingStatistics(in_raster, {dimension}, {backward_window}, {forward_window}, {nodata_handling}, {statistics_type}, {percentile_value}, {percentile_interpolation_type}, {circular_wrap_value})
NameErläuterungDatentyp
in_raster

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.

  • DATANoData-Werte in der Werteingabe in den Ergebnissen des definierten Fensters, in dem sie sich befinden, werden ignoriert. Dies ist die Standardeinstellung.
  • NODATAAusgabewerte sind NoData-Werte, wenn sich in der Eingabe im definierten Fenster NoData-Werte befinden.
  • FILL_NODATANoData-Zellenwerte werden durch die ausgewählte Statistik für die Werte im definierten Fenster ersetzt.
String
statistics_type
(optional)

Gibt den zu berechnenden Statistiktyp an.

  • MEANDer Mittelwert (Durchschnittswert) der Zellen in dem definierten Fenster wird berechnet. Dies ist die Standardeinstellung.
  • CIRCULAR_MEANDer 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 ausgewählt ist, verwenden Sie den Parameter circular_wrap_value, um einen Umbruchwert festzulegen.
  • MAJORITYDie Mehrheit (der am häufigsten auftretende Wert) in dem definierten Fenster wird berechnet.
  • MAXIMUMDer Maximalwert (der höchste Wert) in dem definierten Fenster wird berechnet.
  • MEDIANDer Medianwert der Zellen im definierten Fenster wird identifiziert.
  • MINIMUMDer Minimalwert (der kleinste Wert) in dem definierten Fenster wird berechnet.
  • PERCENTILEEin Perzentil der Zellen in dem definierten Fenster wird berechnet. Standardmäßig wird das 90. Perzentil berechnet. Wenn dieser Statistiktyp ausgewählt 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 Perzentilwert wird berechnet. Der Standardwert ist 90 für das 90. Perzentil.

Zulässiger Wert kann zwischen 0 und 100 liegen. Grundsätzlich entspricht der Perzentilwert 0 statistisch gesehen der Statistik "Minimum" und der Perzentilwert 100 der Statistik "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_DETECTWeist 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.
  • NEARESTEs wird der dem Perzentil am nächsten liegende verfügbare Wert verwendet. In diesem Fall entspricht der Ausgabepixeltyp dem des Eingabe-Rasters.
  • LINEAREs 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

Rückgabewert

NameErläuterungDatentyp
out_raster

Das Ausgabe-Raster muss ein multidimensionales Raster im Cloud-Raster-Format (.crf-Datei) sein.

Raster

Abgeleitete Ausgabe

NameErläuterungDatentyp
raster_function_arguments_json

Die Argumente der Funktion. Diese Ausgabe ist nur für die interne Verwendung vorgesehen.

String

Codebeispiel

DimensionalMovingStatistics – Beispiel 1 (Python-Fenster)

In diesem Beispiel wird der Mittelwert in einem dreiteiligen Fenster um jede Zelle im multidimensionalen Eingabe-Raster berechnet.

import arcpy
from arcpy import env
from arcpy.ia import *
env.workspace = "C:/iapyexamples/data"
out_dimstats = DimensionalMovingStatistics("md_raster.crf", "StdTime",
                                           1, 1, "NODATA", "MEAN")
out_dimstats.save("C:/iapyexamples/output/DMS01.crf")
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 *

# Check out the ArcGIS Image Analyst extension license
arcpy.CheckOutExtension("ImageAnalyst")

# 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"

# Execute 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")

Lizenzinformationen

  • Basic: Erfordert Image Analyst oder Spatial Analyst
  • Standard: Erfordert Image Analyst oder Spatial Analyst
  • Advanced: Erfordert Image Analyst oder Spatial Analyst

Verwandte Themen