Raster analysis is supported on imagery layer items shared on ArcGIS Online. The analysis request can be sent from Map Viewer, Scene Viewer, ArcGIS API for Python, or ArcGIS Pro. A user type of Professional or Professional Plus with the Image Analysis privilege is required to gain access to the raster tools and functions in Map Viewer or Scene Viewer.
ArcGIS Online has many layers that can be added to a web map or web scene and visualized, but not every layer can be used for raster analysis. While some layers can be visualized as imagery in the map or scene, not all of these layers are recognized in raster analysis tools or raster functions.
The publisher of the imagery layer can control whether the image layer can be used in analysis by either blocking or allowing analysis to be performed with the imagery layer as input. You can set these properties when you create the imagery layers. Layers publicly available on ArcGIS Online or through ArcGIS Living Atlas of the World may have properties set that prevent their use in analysis. When these layers are used as input, you may receive an error message indicating that it may not have analysis enabled or a warning indicating that the spatial extent exceeds the limit imposed on the imagery.
The sections below contain information to confirm that an imagery layer is ready for analysis based on the restrictions imposed by the creator of the imagery layers.
Confirm the type of layer
Not all layers that are available in ArcGIS Online are suitable for raster analysis. Many raster analysis tools and raster functions are designed to work on dynamic or tiled imagery layers from ArcGIS Online or imagery layers from ArcGIS Image Server. Review the type of layer to determine its analysis readiness.
Verify analysis is enabled in the service properties
Whether a layer can be used in analysis is controlled by the allowAnalysis service property. When this value is null or true, the imagery layer can be used in analysis. When the value is false, the imagery layer cannot be used as input for analysis. By default, analysis is enabled for the dynamic or tiled imagery layers from ArcGIS Online or imagery layers from ArcGIS Image Server. The value of the allowAnalysis flag can be retrieved from the service information page. For more information about the allowAnalysis flag, review the help documentation for the parameters.
Optimize raster analysis for ArcGIS Living Atlas of the World imagery layers
You can optimize raster analysis for selected imagery layers on ArcGIS Living Atlas. Currently, the Landsat Level-2, Sentinel-1 RTC, and NAIP imagery layers support this optimization.
The optimization allows the raster analysis to be performed in the same region co-located with the ArcGIS Living Atlas data. It requires your authorization to allow the analysis input to leave your region and be temporarily stored in the same region as the ArcGIS Living Atlas data. The analysis input includes deep learning models and raster function templates. The analysis output is temporarily stored in the ArcGIS Living Atlas imagery layer's region before being transferred back to your organization.
This feature is currently in Beta, and it is turned off by default. To enable it, your organization administrator can turn on this setting on the Organization settings page on the Security tab.
Beta:
When the optimization is enabled for the selected list of ArcGIS Living Atlas layers, the raster analysis tools generating feature layer output cannot run successfully.
Consider the request size limit for dynamic imagery layers or image services
In addition to the allowAnalysis flag, the dynamic imagery layer has settings to restrict the size of the analysis from a single request through maxImageHeight and maxImageWidth. In the settings of the imagery layer, the settings are reported as max rows and max columns as shown in the following table:
| Type of imagery layer | Max rows | Max columns |
|---|---|---|
Hosted dynamic imagery layer | 4,000 | 4,000 |
ArcGIS Image Server image service | 4,100 | 15,000 |
The values of these two settings define the maximum number of rows and columns that a single analysis request can retrieve from the imagery layer. The layer publisher can also change the settings to values other than the default.
For a hosted dynamic imagery layer on ArcGIS Online, there is a global limit for maximum rows and columns of 4000 by 4000. This global limit does not apply to an ArcGIS Image Server image service or ArcGIS Living Atlas dynamic imagery layer.
When using the layer for analysis, the analysis request size for the numbers of rows and columns is calculated from the analysis extent and the analysis cell size. The number should not exceed the limit set for the layer.
For example, to perform analysis on a 10-meter resolution image from a dynamic imagery layer, the maximum extent you can process in a single request is 10 x 4,000 = 40,000 meters (40 kilometers) by 40 kilometers.
If you use ArcGIS Living Atlas dynamic imagery layers for analysis, the request size limit setting is configured by the layer publisher and may not be the default value listed above. Review the settings value before you start the analysis job.