Доступно с лицензией Image Analyst.
Доступно с лицензией Spatial Analyst.
Сводка
Извлекает значение измерения или индекс канала, при котором достигается заданная статистика для каждого пиксела в многомерном или многоканальном растре.
Использование
-
Use the Find Argument Statistics tool to extract the dimension value (for example, the date, height, or depth) at which a specific statistic is reached in the stack of rasters in a multidimensional raster dataset. Alternatively, find the band number at which the statistic is reached in a multiband raster.
For example, you may want to know the month in which each pixel reached the highest sea surface temperature over 30 years of data collection. Another example is you have an eight-band remote sensing image and you want to know the band in which the minimum reflectance value was reached for each pixel.
Поддерживаются следующие многомерные наборы растровых данных: Облачный растр (CRF), многомерные наборы данных мозаики или многомерные растровые слои, созданные из файлов netCDF, GRIB или HDF.
Этот инструмент создает набор многомерных растровых данных в облачном растровом формате (CRF). Другие форматы выходных данных в настоящее время не поддерживаются.
If the input multidimensional raster contains only one dimension, the output will be a single-band raster dataset. If the input multidimensional raster contains multiple dimensions, the output multidimensional raster will include those dimensions that were not included in the analysis.
Синтаксис
FindArgumentStatistics(in_raster, {dimension}, {dimension_def}, {interval_keyword}, {variables}, {statistics_type}, {min}, {max}, {multiple_occurrence}, {ignore_nodata})| Parameter | Объяснение | Тип данных |
in_raster | The input multidimensional or multiband raster to be analyzed. | Raster Dataset; Raster Layer; Mosaic Dataset; Mosaic Layer; Image Service; File |
dimension (Дополнительный) | The dimension from which the statistic will be extracted. If the input raster is not a multidimensional raster, this parameter is not required. | String |
dimension_def (Дополнительный) | Specifies how the statistic will be extracted from the dimension.
| String |
interval_keyword (Дополнительный) | The unit of time for which the statistic will be extracted. For example, you have five years of daily sea surface temperature data and you want to know the year in which the maximum temperature was observed. Set Statisitcs Type to Argument of the maximum, set Dimension Definition to Interval Keyword, and set Keyword Interval to Yearly. Alternatively, if you want to know the month in which the maximum temperature was consistently observed, set Statistics Type to Argument of the maximum, setDimension Definition to Interval Keyword, and set Keyword Interval to Recurring Monthly. This will generate a raster in which each pixel contains the month in which the statistic was reached across the five-year record (08/18/2018, 08/25/2016, 08/07/2013, for example). This parameter is required when the dimension parameter is set to StdTime and the dimension_def parameter is set to INTERVAL_KEYWORD.
| String |
variables [variables,...] (Дополнительный) | The variable or variables to be analyzed. If the input raster is not multidimensional, the pixel values of the multiband raster are considered the variable. If the input raster is multidimensional and no variable is specified, all variables with the selected dimension will be analyzed. For example, to find the years in which temperature values were highest, specify temperature as the variable to be analyzed. If you do not specify any variables and you have both temperature and precipitation variables, both variables will be analyzed, and the output multidimensional raster will include both variables. | String |
statistics_type (Дополнительный) | Specifies the statistic to extract from the variable or variables along the given dimension.
| String |
min (Дополнительный) | The minimum variable value to be used to extract the duration. This parameter is required when the statistics_type parameter is set to DURATION. | Double |
max (Дополнительный) | The maximum variable value to be used to extract the duration. This parameter is required when the statistics_type parameter is set to DURATION. | Double |
multiple_occurrence (Дополнительный) | The pixel value to use to indicate that a given argument statistic was reached more than once in the input raster dataset. If not specified, the pixel value will be the value of the dimension the first time the argument statistic is reached. | Long |
ignore_nodata (Дополнительный) | Определяет, будут ли игнорироваться значения NoData в анализе.
| Boolean |
Значение отраженного сигнала
| Name | Объяснение | Тип данных |
| out_raster | The output raster dataset. | Raster |
Пример кода
This example finds the minimum monthly precipitation and temperature values across a time series multidimensional raster. If the same minimum value is found multiple times, the pixel value will be 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")This example finds the longest time interval for which salinity fell between 10 and 15 units of measurement in the multidimensional raster.
# 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")Environments
Информация о лицензиях
- Basic: Требуется Image Analyst
- Standard: Требуется Image Analyst
- Advanced: Требуется Image Analyst