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

Dialogfeld

Beschriftung	Erläuterung	Datentyp
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. Alle—Die Statistik wird aus allen Dimensionen extrahiert. Dies ist die Standardeinstellung. Intervallschlüsselwort—Die 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 wiederkehrend—Die Statistik wird aus allen Tagen extrahiert. Wöchentlich wiederkehrend—Die Statistik wird aus allen Wochen extrahiert. Monatlich wiederkehrend—Die Statistik wird aus allen Monaten extrahiert. Quartalsweise wiederkehrend—Die Statistik wird aus allen Quartalen extrahiert. Stündlich—Die Statistik wird für die Stunde extrahiert, in der die Statistik erreicht wurde. Täglich—Die Statistik wird für den Tag extrahiert, an dem die Statistik erreicht wurde. Wöchentlich—Die Statistik wird für die Woche extrahiert, in der die Statistik erreicht wurde. Monatlich—Die Statistik wird für den Monat extrahiert, in dem die Statistik erreicht wurde. Vierteljährlich—Die Statistik wird für das Quartal extrahiert, in dem die Statistik erreicht wurde. Jährlich—Die 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 Minimums—Der Dimensionswert, bei dem der minimale Variablenwert erreicht wird, wird extrahiert. Dies ist die Standardeinstellung. Argument des Maximums—Der Dimensionswert, bei dem der maximale Variablenwert erreicht wird, wird extrahiert. Argument des Medians—Der Dimensionswert, bei dem der Medianwert der Variablen erreicht wird, wird extrahiert. Dauer—Der Wert der längsten Dimensionsdauer zwischen dem minimalen und maximalen Variablenwert wird extrahiert. Argument des Wertes—Der 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. Gleich—Die extrahierte Dimension entspricht dem angegebenen Wert. Dies ist die Standardeinstellung. Größer als—Die extrahierte Dimension ist größer als der angegebene Wert. Kleiner als—Die 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 Vorkommen—Der Wert der Dimension wird beim ersten Erreichen der Argumentstatistik zurückgegeben. Dies ist die Standardeinstellung. Letztes Vorkommen—Der Wert der Dimension wird beim letzten Erreichen der Argumentstatistik zurückgegeben.	String

Rückgabewert

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

Python

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

Name	Erläuterung	Datentyp
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. ALL—Die Statistik wird aus allen Dimensionen extrahiert. Dies ist die Standardeinstellung. INTERVAL_KEYWORD—Die 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_DAILY—Die Statistik wird aus allen Tagen extrahiert. RECURRING_WEEKLY—Die Statistik wird aus allen Wochen extrahiert. RECURRING_MONTHLY—Die Statistik wird aus allen Monaten extrahiert. RECURRING_QUARTERLY—Die Statistik wird aus allen Quartalen extrahiert. HOURLY—Die Statistik wird für die Stunde extrahiert, in der die Statistik erreicht wurde. DAILY—Die Statistik wird für den Tag extrahiert, an dem die Statistik erreicht wurde. WEEKLY—Die Statistik wird für die Woche extrahiert, in der die Statistik erreicht wurde. MONTHLY—Die Statistik wird für den Monat extrahiert, in dem die Statistik erreicht wurde. QUARTERLY—Die Statistik wird für das Quartal extrahiert, in dem die Statistik erreicht wurde. YEARLY—Die 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_MIN—Der Dimensionswert, bei dem der minimale Variablenwert erreicht wird, wird extrahiert. Dies ist die Standardeinstellung. ARGUMENT_MAX—Der Dimensionswert, bei dem der maximale Variablenwert erreicht wird, wird extrahiert. ARGUMENT_MEDIAN—Der Dimensionswert, bei dem der Medianwert der Variablen erreicht wird, wird extrahiert. DURATION—Der Wert der längsten Dimensionsdauer zwischen dem minimalen und maximalen Variablenwert wird extrahiert. ARGUMENT_VALUE—Der 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. DATA—Bei der Analyse werden alle gültigen Pixel entlang einer angegebenen Dimension einbezogen und NoData-Pixel ignoriert. Dies ist die Standardeinstellung. NODATA—Wenn 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_TO—Die extrahierte Dimension entspricht dem angegebenen Wert. Dies ist die Standardeinstellung. GREATER_THAN—Die extrahierte Dimension ist größer als der angegebene Wert. SMALLER_THAN—Die 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_OCCURRENCE—Der Wert der Dimension wird beim ersten Erreichen der Argumentstatistik zurückgegeben. Dies ist die Standardeinstellung. LAST_OCCURRENCE—Der Wert der Dimension wird beim letzten Erreichen der Argumentstatistik zurückgegeben.	String

Rückgabewert

Name	Erläuterung	Datentyp
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")

Umgebungen

Zellengröße, Komprimierung, Aktueller Workspace, Geographische Transformationen, NoData, Ausgabe-CONFIG-Schlüsselwort, Ausgabe-Koordinatensystem, Ausdehnung, Faktor für parallele Verarbeitung, Pyramide, Raster-Statistiken, Resampling-Methode, Scratch-Workspace, Fang-Raster, Kachelgröße