Argumentstatistiken suchen (Image Analyst)

Mit der Image Analyst-Lizenz verfügbar.

Zusammenfassung

Extrahiert den Dimensionswert oder Bandindex, bei dem in einem multidimensionalen Raster oder einem Multiband-Raster ein bestimmter statistischer Wert für jedes Pixel erreicht wird.

Verwendung

  • Verwenden Sie das Werkzeug Argumentstatistiken suchen, um den Dimensionswert (z. B. Datum, Höhe oder Tiefe) zu extrahieren, bei dem eine bestimmte Statistik in den Rastern eines multidimensionalen Raster-Datasets erreicht wird. Oder suchen Sie damit die Bandnummer, bei der ein bestimmter statistischer Wert in einem Multiband-Raster erreicht wird.

    Sie können zum Beispiel den Monat suchen, in dem in der 30-jährigen Datenerfassung jedes Pixel die höchste Meeresoberflächentemperatur erreicht hat. Oder ein anderes Beispiel: Sie haben ein 8-Band-Fernerkundungsbild und möchten wissen, in welchem Band der minimale Reflexionswert für jedes Pixel erreicht wurde.

  • Zu den unterstützten multidimensionalen Raster-Datasets gehören solche im Cloud-Raster-Format (CRF), multidimensionale Mosaik-Datasets oder multidimensionale Raster-Layer, die von netCDF-, GRIB- oder HDF-Dateien generiert werden.

  • Dieses Werkzeug generiert ein multidimensionales Raster-Dataset im Cloud-Raster-Format (CRF). Aktuell werden keine anderen Ausgabeformate unterstützt.

  • Wenn das multidimensionale Eingabe-Raster nur eine Dimension enthält, ist die Ausgabe ein Einzelband-Raster-Dataset. Wenn das multidimensionale Eingabe-Raster mehrere Dimensionen enthält, umfasst das multidimensionale Ausgabe-Raster auch die Dimensionen, die nicht Teil der Analyse waren.

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Multidimensions- oder -Multiband-Raster

Das zu analysierende Eingabe-Multidimensions- oder -Multiband-Raster.

Raster Dataset; Raster Layer; Mosaic Dataset; Mosaic Layer; Image Service; File
Dimension
(optional)

Die Dimension, aus der die Statistik extrahiert wird. Wenn das Eingabe-Raster kein multidimensionales Raster ist, ist dieser Parameter nicht erforderlich.

String
Dimensionsdefinition
(optional)

Gibt an, wie die Statistik aus der Dimension extrahiert wird.

  • AlleDie Statistik wird aus allen Dimensionen extrahiert. Dies ist die Standardeinstellung.
  • IntervallschlüsselwortDie Statistik wird aus der Zeitdimension je nach Intervallschlüsselwort extrahiert.
String
Schlüsselwortintervall
(optional)

Die Zeiteinheit, für die die Statistik extrahiert wird.

Sie haben beispielsweise tägliche Daten der Meeresoberflächentemperatur aus fünf Jahren und möchten wissen, in welchem Jahr die maximale Temperatur beobachtet wurde. Legen Sie Statistiktyp auf Argument des Maximums, Dimensionsdefinition auf Intervallschlüsselwort und Schlüsselwortintervall auf Jährlich fest.

Wenn Sie dagegen wissen möchten, in welchem Monat dauerhaft eine maximale Temperatur beobachtet wurde, legen Sie Statistiktyp auf Argument des Maximums, Dimensionsdefinition auf Intervallschlüsselwort und Schlüsselwortintervall auf Monatlich wiederkehrend fest. Dadurch wird ein Raster erzeugt, in dem jedes Pixel den Monat enthält, in dem diese Statistik im Laufe der fünf Jahre erreicht wurde (z. B. 18.08.2018, 25.08.2016, 07.08.2013).

Dieser Parameter ist erforderlich, wenn für den Parameter Dimension die Option StdTime und für den Parameter Dimensionsdefinition der Wert Intervallschlüsselwort festgelegt wurde.

  • Täglich wiederkehrendDie Statistik wird aus allen Tagen extrahiert.
  • Wöchentlich wiederkehrendDie Statistik wird aus allen Wochen extrahiert.
  • Monatlich wiederkehrendDie Statistik wird aus allen Monaten extrahiert.
  • Quartalsweise wiederkehrendDie Statistik wird aus allen Quartalen extrahiert.
  • StündlichDie Statistik wird für die Stunde extrahiert, in der die Statistik erreicht wurde.
  • TäglichDie Statistik wird für den Tag extrahiert, an dem die Statistik erreicht wurde.
  • WöchentlichDie Statistik wird für die Woche extrahiert, in der die Statistik erreicht wurde.
  • MonatlichDie Statistik wird für den Monat extrahiert, in dem die Statistik erreicht wurde.
  • VierteljährlichDie Statistik wird für das Quartal extrahiert, in dem die Statistik erreicht wurde.
  • JährlichDie Statistik wird für das Jahr extrahiert, in dem die Statistik erreicht wurde.
String
Variablen [Dimensionsinfo] (Beschreibung)
(optional)

Die zu analysierende(n) Variable(n). Wenn das Eingabe-Raster nicht multidimensional ist, werden die Pixelwerte des Multiband-Rasters als die zu analysierende Variable betrachtet. Wenn das Eingabe-Raster multidimensional ist und keine Variable angegeben ist, werden alle Variablen mit der ausgewählten Dimension analysiert.

Um zum Beispiel die Jahre zu finden, in denen die Temperaturwerte am höchsten waren, geben Sie die Temperatur als zu analysierende Variable an. Wenn Sie keine Variablen angeben und als Variablen sowohl die Temperatur als auch der Niederschlag verfügbar sind, werden beide Variablen analysiert, und das multidimensionale Ausgabe-Raster enthält dann auch beide Variablen.

String
Statistiktyp
(optional)

Gibt die Statistik an, die aus der oder den Variablen entlang der gegebenen Dimension extrahiert werden soll.

  • Argument des MinimumsDer Dimensionswert, bei dem der minimale Variablenwert erreicht wird, wird extrahiert. Dies ist die Standardeinstellung.
  • Argument des MaximumsDer Dimensionswert, bei dem der maximale Variablenwert erreicht wird, wird extrahiert.
  • Argument des MediansDer Dimensionswert, bei dem der Medianwert der Variablen erreicht wird, wird extrahiert.
  • DauerDer Wert der längsten Dimensionsdauer zwischen dem minimalen und maximalen Variablenwert wird extrahiert.
  • Argument des WertesDer Dimensionswert, bei dem der angegebene Wert der Variablen erreicht wird, wird extrahiert.
String
Minimum
(optional)

Der minimale Variablenwert, der zur Extraktion der Dauer verwendet wird.

Dieser Parameter ist erforderlich, wenn für den Parameter Statistiktyp die Option Dauer festgelegt wurde.

Double
Maximum
(optional)

Der maximale Variablenwert, der zur Extraktion der Dauer verwendet wird.

Dieser Parameter ist erforderlich, wenn für den Parameter Statistiktyp die Option Dauer festgelegt wurde.

Double
Mehrfach vorkommender Wert
(optional)

Der Pixelwert, der verwendet werden soll, um anzuzeigen, dass eine bestimmte Argumentstatistik mehr als einmal im Eingabe-Raster-Dataset erreicht wurde. Wenn nichts angegeben wird, ist der Pixelwert der Wert der Dimension, der durch den Parameter Vorkommen angegeben wird, entweder das erste oder das letzte Vorkommen.

Long
NoData ignorieren
(optional)

Gibt an, ob NoData-Werte in der Analyse ignoriert werden.

  • Aktiviert: Bei der Analyse werden alle gültigen Pixel entlang einer angegebenen Dimension einbezogen und NoData-Pixel ignoriert. Dies ist die Standardeinstellung.
  • Deaktiviert: Wenn NoData-Werte für die Pixel entlang einer angegebenen Dimension vorhanden sind, wird bei der Analyse "NoData" zurückgegeben.
Boolean
Wert des Arguments
(optional)

Der Wert, bei dem ein Vergleich durchgeführt wird, um den Dimensionswert zu extrahieren.

Dieser Parameter ist erforderlich, wenn für den Parameter Statistiktyp die Option Argument des Wertes festgelegt wurde.

Der Wert, bei dem ein Vergleich durchgeführt wird, um den Dimensionswert zu extrahieren.

Dieser Parameter ist erforderlich, wenn der Parameter statistics_type auf ARGUMENT_VALUE festgelegt ist.

Long
Vergleich
(optional)

Gibt den Vergleichstyp an, der zum Extrahieren des Dimensionswertes verwendet wird.

  • GleichDie extrahierte Dimension entspricht dem angegebenen Wert. Dies ist die Standardeinstellung.
  • Größer alsDie extrahierte Dimension ist größer als der angegebene Wert.
  • Kleiner alsDie extrahierte Dimension ist kleiner als der angegebene Wert.
String
Vorkommen
(optional)

Gibt an, ob der Wert der Dimension beim ersten oder letzten Erreichen der Argumentstatistik zurückgegeben werden soll.

  • Erstes VorkommenDer Wert der Dimension wird beim ersten Erreichen der Argumentstatistik zurückgegeben. Dies ist die Standardeinstellung.
  • Letztes VorkommenDer Wert der Dimension wird beim letzten Erreichen der Argumentstatistik zurückgegeben.
String

Rückgabewert

BeschriftungErläuterungDatentyp
Ausgabe-Raster

Das Ausgabe-Raster-Dataset.

Raster

FindArgumentStatistics(in_raster, {dimension}, {dimension_def}, {interval_keyword}, {variables}, {statistics_type}, {min}, {max}, {multiple_occurrence}, {ignore_nodata}, {value}, {comparison}, {occurrence})
NameErläuterungDatentyp
in_raster

Das zu analysierende Eingabe-Multidimensions- oder -Multiband-Raster.

Raster Dataset; Raster Layer; Mosaic Dataset; Mosaic Layer; Image Service; File
dimension
(optional)

Die Dimension, aus der die Statistik extrahiert wird. Wenn das Eingabe-Raster kein multidimensionales Raster ist, ist dieser Parameter nicht erforderlich.

String
dimension_def
(optional)

Gibt an, wie die Statistik aus der Dimension extrahiert wird.

  • ALLDie Statistik wird aus allen Dimensionen extrahiert. Dies ist die Standardeinstellung.
  • INTERVAL_KEYWORDDie Statistik wird aus der Zeitdimension je nach Intervallschlüsselwort extrahiert.
String
interval_keyword
(optional)

Die Zeiteinheit, für die die Statistik extrahiert wird.

Sie haben beispielsweise tägliche Daten der Meeresoberflächentemperatur aus fünf Jahren und möchten wissen, in welchem Jahr die maximale Temperatur beobachtet wurde. Legen Sie Statistiktyp auf Argument des Maximums, Dimensionsdefinition auf Intervallschlüsselwort und Schlüsselwortintervall auf Jährlich fest.

Wenn Sie dagegen wissen möchten, in welchem Monat dauerhaft eine maximale Temperatur beobachtet wurde, legen Sie Statistiktyp auf Argument des Maximums, Dimensionsdefinition auf Intervallschlüsselwort und Schlüsselwortintervall auf Monatlich wiederkehrend fest. Dadurch wird ein Raster erzeugt, in dem jedes Pixel den Monat enthält, in dem diese Statistik im Laufe der fünf Jahre erreicht wurde (z. B. 18.08.2018, 25.08.2016, 07.08.2013).

Dieser Parameter ist erforderlich, wenn für den Parameter dimension der Wert StdTime festgelegt wurde und für den Parameter dimension_def die Option INTERVAL_KEYWORD.

  • RECURRING_DAILYDie Statistik wird aus allen Tagen extrahiert.
  • RECURRING_WEEKLYDie Statistik wird aus allen Wochen extrahiert.
  • RECURRING_MONTHLYDie Statistik wird aus allen Monaten extrahiert.
  • RECURRING_QUARTERLYDie Statistik wird aus allen Quartalen extrahiert.
  • HOURLYDie Statistik wird für die Stunde extrahiert, in der die Statistik erreicht wurde.
  • DAILYDie Statistik wird für den Tag extrahiert, an dem die Statistik erreicht wurde.
  • WEEKLYDie Statistik wird für die Woche extrahiert, in der die Statistik erreicht wurde.
  • MONTHLYDie Statistik wird für den Monat extrahiert, in dem die Statistik erreicht wurde.
  • QUARTERLYDie Statistik wird für das Quartal extrahiert, in dem die Statistik erreicht wurde.
  • YEARLYDie Statistik wird für das Jahr extrahiert, in dem die Statistik erreicht wurde.
String
variables
[variables,...]
(optional)

Die zu analysierende(n) Variable(n). Wenn das Eingabe-Raster nicht multidimensional ist, werden die Pixelwerte des Multiband-Rasters als die zu analysierende Variable betrachtet. Wenn das Eingabe-Raster multidimensional ist und keine Variable angegeben ist, werden alle Variablen mit der ausgewählten Dimension analysiert.

Um zum Beispiel die Jahre zu finden, in denen die Temperaturwerte am höchsten waren, geben Sie die Temperatur als zu analysierende Variable an. Wenn Sie keine Variablen angeben und als Variablen sowohl die Temperatur als auch der Niederschlag verfügbar sind, werden beide Variablen analysiert, und das multidimensionale Ausgabe-Raster enthält dann auch beide Variablen.

String
statistics_type
(optional)

Gibt die Statistik an, die aus der oder den Variablen entlang der gegebenen Dimension extrahiert werden soll.

  • ARGUMENT_MINDer Dimensionswert, bei dem der minimale Variablenwert erreicht wird, wird extrahiert. Dies ist die Standardeinstellung.
  • ARGUMENT_MAXDer Dimensionswert, bei dem der maximale Variablenwert erreicht wird, wird extrahiert.
  • ARGUMENT_MEDIANDer Dimensionswert, bei dem der Medianwert der Variablen erreicht wird, wird extrahiert.
  • DURATIONDer Wert der längsten Dimensionsdauer zwischen dem minimalen und maximalen Variablenwert wird extrahiert.
  • ARGUMENT_VALUEDer Dimensionswert, bei dem der angegebene Wert der Variablen erreicht wird, wird extrahiert.
String
min
(optional)

Der minimale Variablenwert, der zur Extraktion der Dauer verwendet wird.

Dieser Parameter ist erforderlich, wenn der Parameter statistics_type auf DURATION festgelegt ist.

Double
max
(optional)

Der maximale Variablenwert, der zur Extraktion der Dauer verwendet wird.

Dieser Parameter ist erforderlich, wenn der Parameter statistics_type auf DURATION festgelegt ist.

Double
multiple_occurrence
(optional)

Der Pixelwert, der verwendet werden soll, um anzuzeigen, dass eine bestimmte Argumentstatistik mehr als einmal im Eingabe-Raster-Dataset erreicht wurde. Wenn nichts angegeben wird, ist der Pixelwert der Wert der Dimension, der durch den Parameter occurrence angegeben wird, entweder das erste oder das letzte Vorkommen.

Long
ignore_nodata
(optional)

Gibt an, ob NoData-Werte in der Analyse ignoriert werden.

  • DATABei der Analyse werden alle gültigen Pixel entlang einer angegebenen Dimension einbezogen und NoData-Pixel ignoriert. Dies ist die Standardeinstellung.
  • NODATAWenn NoData-Werte für die Pixel entlang einer angegebenen Dimension vorhanden sind, wird bei der Analyse "NoData" zurückgegeben.
Boolean
value
(optional)

Der Wert, bei dem ein Vergleich durchgeführt wird, um den Dimensionswert zu extrahieren.

Dieser Parameter ist erforderlich, wenn für den Parameter Statistiktyp die Option Argument des Wertes festgelegt wurde.

Long
comparison
(optional)

Gibt den Vergleichstyp an, der zum Extrahieren des Dimensionswertes verwendet wird.

  • EQUAL_TODie extrahierte Dimension entspricht dem angegebenen Wert. Dies ist die Standardeinstellung.
  • GREATER_THANDie extrahierte Dimension ist größer als der angegebene Wert.
  • SMALLER_THANDie extrahierte Dimension ist kleiner als der angegebene Wert.
String
occurrence
(optional)

Gibt an, ob der Wert der Dimension beim ersten oder letzten Erreichen der Argumentstatistik zurückgegeben werden soll.

  • FIRST_OCCURRENCEDer Wert der Dimension wird beim ersten Erreichen der Argumentstatistik zurückgegeben. Dies ist die Standardeinstellung.
  • LAST_OCCURRENCEDer Wert der Dimension wird beim letzten Erreichen der Argumentstatistik zurückgegeben.
String

Rückgabewert

NameErläuterungDatentyp
out_raster

Das Ausgabe-Raster-Dataset.

Raster

Codebeispiel

FindArgumentStatistics – Beispiel 1 (Python-Fenster)

In diesem Beispiel werden die minimalen monatlichen Niederschlags- und Temperaturwerte für ein multidimensionales Zeitserien-Raster ermittelt. Wird derselbe Minimalwert mehrmals gefunden, lautet der Pixelwert 99999.

# Import system modules
import arcpy
from arcpy.ia import *

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

# get the date when the minimal precipitation was observed in each year
# as well as the date when the minimal temperature was observed in each year
argStatOutput = FindArgumentStatistics("prcp_temp_time_series.crf", "StdTime", "INTERVAL_KEYWORD", "YEARLY",
	"prcp;temp", "ARGUMENT_MIN", None, None, 0, "DATA")
	
# Save output
argStatOutput.save("C:/data/yearly_min_temp_precip.crf")
FindArgumentStatistics – Beispiel 2 (eigenständiges Skript)

Mit diesem Beispiel wird das längste Zeitintervall gefunden, in dem der Salzgehalt zwischen 10 und 15 Maßeinheiten im multidimensionalen Raster gefallen ist.

# Import system modules
import arcpy
from arcpy.ia import *

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

# Define input parameters
inFile = "C:/data/salinity.crf"
dimensionName = "Time"
dimensiondef = "ALL"
intervalkeyword = ''
variables = "temp"
arg_statistics_type = "DURATION"
min_value = 20
max_value = 25
multiple_occurrances_value = None
ignore_nodata = "NODATA"

# Execute 
# get the number of continous slices that have temperature value between 20 and 25
argStatOutput = FindArgumentStatistics(inFile, dimensionName, dimensiondef, intervalkeyword,
	variables, arg_statistics_type, min_value, max_value, multiple_occurrances_value, ignore_nodata)
	
# Save output
argStatOutput.save("C:/data/arg_statistics_output2.crf")

Verwandte Themen