The Find Argument Statistics tool extracts the dimension value or band index at which a given statistic is attained for each pixel in a multidimensional or multiband imagery layer.
The output is a hosted imagery layer.
Examples
Example uses of this tool include the following:
- Identify the month in which each pixel reached the highest sea surface temperature over 30 years of data collection.
- Determine the band in which the minimum reflectance value was reached for each pixel in an eight-band remote sensing imagery layer.
Usage notes
Find Argument Statistics includes configurations for the input layer, argument statistics, and the result layer.
Input layer
The Input layer group includes the following parameters:
- Multidimensional or multiband imagery layer is the imagery layer that will be analyzed. If no imagery layers are available for selection by the tool, add a multidimensional imagery layer to the map.
- Dimension is the statistic that will be extracted.
- Variables are the variables that will be analyzed along the selected dimension. If no variable is specified, all variables with the selected dimension will be analyzed.
Argument statistics
The Argument statistics group includes the following parameters:
- Statistics type specifies the statistic that will be extracted from the variable or variables along a given dimension. The options are as follows:
- Argument of the minimum—The dimension value at which the minimum variable value is reached will be extracted. This is the default.
- Argument of the maximum—The dimension value at which the maximum variable value is reached will be extracted.
- Argument of the median —The dimension value at which the median variable value is reached will be extracted.
- Duration—The longest dimension duration value between the minimum and maximum variable values will be extracted.
- Argument of the value—The dimension value at which the specified variable value is reached will be extracted.
- Dimension definition specifies how the statistic will be extracted from all the dimensions. The options are as follows:
- All—The data values will be analyzed across all slices. This is the default.
- Interval keyword—The variable data will be analyzed using a commonly known interval. The options are as follows:
- Hourly—The data values will be analyzed into hourly time steps, and the result will include every hour in the time series.
- Daily—The data values will be analyzed into daily time steps, and the result will include every day in the time series.
- Weekly—The data values will be analyzed into weekly time steps, and the result will include every week in the time series.
- Dekadly—The data values will be analyzed into 3 periods of 10 days each. The last period can contain more or fewer than 10 days. The output will include 3 slices for each month.
- Pentadly—The data values will be analyzed into 6 periods of 5 days each. The last period can contain more or fewer than 5 days. The output will include 6 slices for each month.
- Monthly—The data values will be analyzed into monthly time steps, and the result will include every month in the time series.
- Quarterly—The data values will be analyzed into quarterly time steps, and the result will include every quarter in the time series.
- Yearly—The data values will be analyzed into yearly time steps, and the result will include every year in the time series.
- Recurring daily—The data values will be analyzed into daily time steps, and the result will include one aggregated value per Julian day. The output will include, at most, 366 daily time slices.
- Recurring weekly—The data values will be analyzed into weeklytime steps, and the result will include one aggregated value per week. The output will include, at most, 52 weekly time slices.
- Recurring quarterly—The data values will be analyzed into quarterly time steps, and the result will include one aggregated value per quarter. The output will include, at most, 4 quarterly time slices.
- Argument value is the value specified when Statistics type is set to Argument of the value.
- Minimum value is the lowest value in the interval range.
- Maximum value is the highest value in the interval range.
- Multiple occurrence flag value indicates 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.
- Occurrence specifies whether the first time the argument is met or the last time the argument is met will be indicated.
- Ignore NoData specifies whether the missing values will be ignored in the analysis or considered part of the analysis.
Result layer
The Result layer group includes the following parameters:
- Output name specifies the name of the layer that is created and displayed. The name must be unique. If a layer with the same name already exists in your organization, the tool will fail and you will be prompted to use a different name.
- Save in folder specifies the name of a folder in My content where the result will be saved.
Environments
Analysis environment settings are additional parameters that affect a tool's results. You can access the tool's analysis environment settings from the Environment settings parameter group.
This tool honors the following analysis environments:
- Output coordinate system
- Processing extent
Note:
The default processing extent is Full extent. This default is different from Map Viewer Classic in which Use current map extent is enabled by default.
- Snap raster
- Cell size
- Resampling method
- Parallel processing factor
Outputs
The output layer will be a thematic imagery layer with the locations where the criteria have been met. If the input layer was multidimensional, the output will also be multidimensional.
Usage requirements
This tool requires the following user type and configurations:
- Creator, Professional, or Professional Plus user type
- Publisher or Administrator role, or an equivalent custom role
- Available when the organization is configured for raster analytics with a premium capability license
Resources
Use the following resources to learn more:
- Find Argument Statistics in ArcGIS REST API
- find_argument_statistics in ArcGIS API for Python
- Find Argument Statistics in ArcGIS Pro