Find Argument Statistics (Image Analyst)

This ArcGIS 2.8 documentation has been archived and is no longer updated. Content and links may be outdated. See the latest documentation.

Available with Image Analyst license.

Available with Spatial Analyst license.

Summary

Extracts the dimension value or band index at which a given statistic is attained for each pixel in a multidimensional or multiband raster.

Usage

  • 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.

  • Supported multidimensional raster datasets include Cloud Raster Format (CRF), multidimensional mosaic datasets, or multidimensional raster layers generated by netCDF, GRIB, or HDF files.

  • This tool produces a multidimensional raster dataset in Cloud Raster Format (CRF). Currently, no other output formats are supported.

  • 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.

Parameters

LabelExplanationData Type
Input Multidimensional or Multiband Raster

The input multidimensional or multiband raster to be analyzed.

Raster Dataset; Raster Layer; Mosaic Dataset; Mosaic Layer; Image Service; File
Dimension
(Optional)

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 Definition
(Optional)

Specifies how the statistic will be extracted from the dimension.

  • All —The statistic will be extracted across all dimensions. This is the default.
  • Interval Keyword —The statistic will be extracted from the time dimension according to the interval keyword.
String
Keyword Interval
(Optional)

The unit of time for which the statistic will be extracted.

  • Recurring Daily —The statistic will be extracted across days.
  • Recurring Weekly —The statistic will be extracted across weeks.
  • Recurring Monthly —The statistic will be extracted across months.
  • Recurring Quarterly —The statistic will be extracted across quarters.
  • Hourly —The statistic will be extracted for the hour in which the statistic was reached.
  • Daily —The statistic will be extracted for the day in which the statistic was reached.
  • Weekly —The statistic will be extracted for the week in which the statistic was reached.
  • Monthly —The statistic will be extracted for the month in which the statistic was reached.
  • Quarterly —The statistic will be extracted for the quarter in which the statistic was reached.
  • Yearly —The statistic will be extracted for the year in which the statistic was reached.
String
Variables [Dimension Info] (Description)
(Optional)

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
(Optional)

Specifies the statistic to extract from the variable or variables along the given dimension.

  • 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.
String
Minimum Value
(Optional)

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
Maximum Value
(Optional)

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 Value
(Optional)

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
(Optional)

Specifies whether NoData values are ignored in the analysis.

  • Checked—The analysis will include all valid pixels along a given dimension and ignore any NoData pixels. This is the default.
  • Unchecked—The analysis will result in NoData if there are any NoData values for the pixels along the given dimension.
Boolean

Return Value

LabelExplanationData Type
Output Raster

The output raster dataset.

Raster

Licensing information

  • Basic: Requires Image Analyst
  • Standard: Requires Image Analyst
  • Advanced: Requires Image Analyst

Related topics