Argumentstatistiken suchen (Image Analyst Tools)

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.

Beschriftung	Erläuterung	Datentyp
Eingabe-Multidimensions- oder -Multiband-Raster	Das zu analysierende multidimensionale oder Multiband-Eingabe-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 den Parameter Statistiktyp auf Argument des Maximums fest, den Parameter Dimensionsdefinition auf Intervallschlüsselwort und den Parameter Schlüsselwortintervall auf Jährlich fest. Wenn Sie dagegen wissen möchten, in welchem Monat dauerhaft eine maximale Temperatur beobachtet wurde, legen Sie den Parameter Statistiktyp auf Argument des Maximums fest, den Parameter Dimensionsdefinition auf Intervallschlüsselwort und den Parameter 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 Variablenwert erreicht wird, wird extrahiert.	String
Minimalpunkt (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
Maximalwert (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 der 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
Vergleich (Optional)	Gibt den Vergleichstyp für die Extraktion des Dimensionswertes an. 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 erst- oder letztmaligen 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

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 multidimensionale oder Multiband-Eingabe-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 den Parameter `statistics_type` auf `ARGUMENT_MAX`, den Parameter `dimension_def` auf `INTERVAL_KEYWORD` und den Parameter `interval_keyword` auf `YEARLY` fest. Wenn Sie dagegen wissen möchten, in welchem Monat dauerhaft eine maximale Temperatur beobachtet wurde, legen Sie den Parameter `statistics_type` auf `ARGUMENT_MAX`, den Parameter `dimension_def` auf `INTERVAL_KEYWORD` und den Parameter `interval_keyword` auf `RECURRING_MONTHLY` 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` und für den Parameter `dimension_def` die Option `INTERVAL_KEYWORD` festgelegt wurde. `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 Variablenwert 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 wurde.	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 wurde.	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 der Vergleich durchgeführt wird, um den Dimensionswert zu extrahieren. Dieser Parameter ist erforderlich, wenn der Parameter `statistics_type` auf `ARGUMENT_VALUE` festgelegt wurde.	Long
comparison (Optional)	Gibt den Vergleichstyp für die Extraktion des Dimensionswertes an. `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 erst- oder letztmaligen 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 *

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

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

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

Lizenzierungsinformationen

Basic: Erfordert "Image Analyst"
Standard: Erfordert "Image Analyst"
Advanced: Erfordert "Image Analyst"

Argumentstatistiken suchen (Image Analyst Tools)

Zusammenfassung

Verwendung

Parameter

Rückgabewert

Umgebungen

Lizenzierungsinformationen

Verwandte Themen