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
The Find Argument Statistics tool can be used to know the month in which each pixel reached the highest sea surface temperature over 30 years of data collection.
The Find Argument Statistics tool can also be used if you have an eight-band remote sensing imagery layer and you want to know the band in which the minimum reflectance value was reached for each pixel.
Usage notes
Find Argument Statistics includes configurations for input layer, argument statistics, and result layer.
Input layer
The Input layer group includes the following parameters:
- Multidimensional or multiband imagery layer indicates which imagery layer will be analyzed. If there are no imagery layers available to be selected in the tool, a multidimensional imagery layer must be added to the map.
- Dimension indicates which statistic will be extracted.
- Variables indicates which variable 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 to extract from the variable or variables along a given dimension. The Statistics type parameter 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 Dimension definition parameter 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 interval 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 monthly time steps, and the result will include one aggregated value per month. The output will include, at most, 12 monthly 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 indicates the lowest value in the interval range.
- Maximum value indicates 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 indicates whether to indicate the first time the argument is met or the last.
- Ignore NoData indicates whether the missing values are ignored in the analysis or considered part of the analysis.
Result layer
The Result layer group includes the following parameters:
- Output name determines the name of the layer that is created and added to the map. 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 in Map Viewer 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 desired criteria have been met. If the input layer was multidimensional, the output will also be multidimensional.
Usage requirements
This tool requires the following licensing and configurations:
- Creator or GIS Professional 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