The Aggregate Multidimensional Raster tool generates a multidimensional imagery layer by combining existing multidimensional variables along a dimension.
The output is a hosted imagery layer.
Examples
Example scenarios for the use of this tool include the following:
- Many multidimensional imagery layers have data that spans multiple dimensions, but for some analysis, the data will need to be organized in a different dimension. For example, if you have 30 years of sea surface temperature that has been collected monthly, you can use the Aggregate Multidimensional Raster tool to organize the data into quarterly time slices.
- You have a year's worth of precipitation data that is organized in hourly slices. You can use the Aggregate Multidimensional Raster tool to aggregate the data into daily slices to compare it to the existing precipitation data.
Usage notes
Aggregate Multidimensional Raster includes configurations for input layers, aggregation settings, and the result layer.
Input layers
The Input layers group includes the following parameters:
- Multidimensional imagery layer is the imagery layer that will be aggregated into a new multidimensional imagery layer. If no imagery layers are available to be selected in the tool, a multidimensional imagery layer must be added to the map.
- Dimension indicates the dimension in the selected imagery layer that will be used for aggregation into a new multidimensional imagery layer. If the dimension is not available from the drop-down menu, the imagery layer selected may not contain the dimension.
- Variables specifies the variable that will be aggregated along the selected dimension. If no variable is specified, all variables with the selected dimension will be aggregated.
Aggregation settings
The Aggregation settings group includes the following parameters:
- Aggregation method specifies the mathematical method that will be used to generate the new multidimensional imagery layer when the slices are aggregated. The options are as follows:
- Mean—The mean of a pixel's values will be calculated across all slices in the interval. This is the default.
- Maximum—The maximum value of a pixel will be calculated across all slices in the interval.
- Majority—The pixel value that occurred most frequently will be calculated across all slices in the interval.
- Minimum—The minimum value of a pixel will be calculated across all slices in the interval.
- Minority—The pixel value that occurred least frequently will be calculated across all slices in the interval.
- Median—The median value of a pixel will be calculated across all slices in the interval.
- Percentile—The percentile of values for a pixel will be calculated across all slices in the interval. The 90th percentile is calculated by default. You can specify other values (from 0 to 100) using the Percentile value parameter.
- Range—The range of values for a pixel will be calculated across all slices in the interval.
- Standard Deviation—The standard deviation of a pixel's values will be calculated across all slices in the interval.
- Sum—The sum of a pixel's values will be calculated across all slices in the interval.
- Variety—The number of unique pixel values will be calculated across all slices in the interval.
- Custom—The pixel value will be calculated based on a custom raster function.
- Aggregation definition specifies the dimension interval for which the data will be aggregated. The options are as follows:
- All—The data values will be aggregated across all slices. This is the default.
- Interval keyword—The variable data will be aggregated using a commonly known interval.
- Interval value—The variable data will be aggregated using a user-specified interval and unit.
- Interval range—The variable data will be aggregated between specified pairs of values or dates.
- Interval keyword specifies the keyword interval that will be used when aggregating along the dimension. This parameter is available when the Aggregation definition parameter is set to Interval keyword. The options are as follows:
- Hourly—The data values will be aggregated into hourly time steps, and the result will include every hour in the time series.
- Daily—The data values will be aggregated into daily time steps, and the result will include every day in the time series.
- Weekly—The data values will be aggregated into weekly time steps, and the result will include every week in the time series.
- Monthly—The data values will be aggregated into monthly time steps, and the result will include every month in the time series.
- Quarterly—The data values will be aggregated into quarterly time steps, and the result will include every quarter in the time series.
- Yearly—The data values will be aggregated into yearly time steps, and the result will include every year in the time series.
- Recurring daily—The data values will be aggregated 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 aggregated into weekly time steps, and the result will include one aggregated value per week. The output will include, at most, 53 weekly time slices.
- Recurring monthly—The data values will be aggregated 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 aggregated into quarterly time steps, and the result will include one aggregated value per quarter. The output will include, at most, 4 quarterly time slices.
- Dekadly—The data values will be aggregated 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 aggregated 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.
- Interval value is the size of the interval that will be used for the aggregation. This parameter is available when the Aggregation definition parameter is set to Interval value.
- Interval unit specifies the unit used for the interval value. This parameter is available when the Dimension parameter value is a time field and the Aggregation definition parameter is set to Interval value.
- Minimum value is the lowest value in the interval range. This parameter is available when the Aggregation definition parameter is set to Interval range.
- Maximum value is the highest value in the interval range. This parameter is available when the Aggregation definition parameter is set to Interval range.
- Ignore NoData specifies whether 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 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.
- Output layer type specifies the type of raster output that will be created. The output can be either a tiled imagery layer or a dynamic imagery layer.
- 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
Credits
This tool consumes credits.
Use Estimate credits to calculate the number of credits that will be required to run the tool. For more information, see Understand credits for spatial analysis.
Outputs
The output is a multidimensional imagery layer that is aggregated according to the settings of the tool with the specified new dimensions.
Usage requirements
This tool requires the following user type and configurations:
- Professional or Professional Plus user type
- Publisher, Facilitator, or Administrator role, or an equivalent custom role with the Imagery Analysis privilege
Resources
Use the following resources to learn more:
- Aggregate Multidimensional Raster in ArcGIS REST API
- aggregate_multidimensional_raster in ArcGIS API for Python
- Aggregate Multidimensional Raster in ArcGIS Pro