Available with Image Server
The Multidimensional Principal Components tool transforms the multidimensional imagery layers into a reduced number of components that account for the variance of the data, so that spatial and temporal patterns can be readily identified.
The output is a hosted imagery layer.
Examples
The Multidimensional Principal Components tool can be used to reduce the complexity and focus the analysis of 30 years of sea surface salinity data. The results of the tool can be used to focus further analysis on the raster bands that account for the most variance.
Usage notes
The Multidimensional Principal Components tool includes configurations for input layer, component settings, and result layer.
Input layer
The Input layer group includes the following parameters:
- Multidimensional imagery layer indicates which imagery layer will be analyzed. If there are not any imagery layers available to be selected in the tool, a multidimensional imagery layer must be added to the map. The tool processes data along one dimension, such as a time series raster or a data cube defined by a nontime dimension [X, Y, Z]. If an input variable includes multiple dimensions, such as depth and time, the first dimension value will be used by default.
- Dimension indicates which statistic will be extracted. If the input raster is not a multidimensional raster, this parameter is not required.
- Variable indicates which variable will be aggregated along the selected dimension. If no variable is specified, all variables with the selected dimension will be analyzed.
Component settings
The Component settings group includes the following parameters:
- Mode specifies the method that will be used to perform principal component analysis. The Mode parameter options are as follows:
- Dimension Reduction—The input time series data will be treated as a set of images. Principal components that extract prevalent pattens over time will be computed. This is the default.
- Spatial Reduction—The input time series data will be treated as a set of pixels. Principal components that extract prevalent pattens and locations over time will be computed as a set of one-dimensional arrays stored in a table.
The Number of principal components parameter defines the number of principal components to compute, usually fewer than the number of input rasters.
This parameter also takes the form of a percentage (%). For example, a value of 90% means the number of components that can explain 90 percent of variance in the data will be computed.
Result layer
The Result layers group includes the following parameters:
The Output principal components parameter determines the name of the output data.
When Mode is specified as Dimension Reduction, the output will be a multiband imagery layer with the components as bands. The first band is the first principal component with the largest eigenvalue, the second band has the principal component with the second largest eigenvalue, and so on.
When Mode is set to Spatial Reduction, the output is a table layer containing a set of time series data representing the principal components.Output loadings table determines the name of the data contributing to the principal components.
When Mode is specified as Dimension Reduction, the output will be a table layer containing the weights that each input raster contributed to the principal components. These weights define the correlations of the input data and the output principal components.
When the Mode parameter is specified as Spatial Reduction, the output is an imagery layer in which pixel values are the weights contributing the principal components. Pixels with larger values are more correlated to the principal components. This output may have a larger cell size than the input raster because a random reprojection is applied to reduce the computation complexity.- The Output eigenvalues table parameter specifies the name of the Output eigenvalues table layer. Eigenvalues are values indicating the variance percentage of each component. Eigenvalues help you define the number of principal components that are needed to represent the dataset.
- 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
- Mask
- Resampling method
Outputs
This tool includes the following outputs:
- One multidimensional imagery layer containing raster bands or one table layer of one-dimensional arrays that display dominant temporal patterns based on the Mode parameter.
- One table layer showing the supporting data for the choice of the principal components called the loadings table.
- Optionally, one table layer showing eigenvalues indicating the variance percentage for each component.
Licensing requirements
This tool requires the following licensing and configurations:
- Creator or GIS Professional user type
- Publisher or Administrator role, or an equivalent custom role
- ArcGIS Image Server configured for raster analysis
Resources
Use the following resources to learn more: