Mit der Image Analyst-Lizenz verfügbar.
Mit der Spatial 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.
Zum Beispiel möchten Sie vielleicht wissen, in welchem Monat 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 bzw. 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.
Syntax
FindArgumentStatistics(in_raster, {dimension}, {dimension_def}, {interval_keyword}, {variables}, {statistics_type}, {min}, {max}, {multiple_occurrence}, {ignore_nodata})| Parameter | Erklärung | 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.
| 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.
| 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.
| String |
min (optional) | Der minimale Variablenwert, der zur Extraktion der Dauer verwendet wird. Dieser Parameter ist erforderlich, wenn der Parameter statistics_type auf DURATION gesetzt 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 gesetzt 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. Wird dies nicht angegeben, ist der Pixelwert der Wert der Dimension beim ersten Erreichen der Argumentstatistik. | Long |
ignore_nodata (optional) | Gibt an, ob NoData-Werte bei der Analyse ignoriert werden.
| Boolean |
Rückgabewert
| Name | Erklärung | Datentyp |
| out_raster | Das Ausgabe-Raster-Dataset | Raster |
Codebeispiel
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")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
Lizenzinformationen
- Basic: Erfordert Image Analyst
- Standard: Erfordert Image Analyst
- Advanced: Erfordert Image Analyst