Use the raster analysis tools

Note:

This functionality is currently only supported in Map Viewer Classic. It will be available in a future release of Map Viewer.

Below you'll find information about accessing and using the raster analysis tools.

Licensing

The administrator of your organization needs to grant you certain privileges for you to perform analysis. To use the raster analysis tools, you need the following privileges:

  • Create, update, and delete content
  • Publish hosted imagery layers
  • Imagery Analysis

These privileges are available with the ArcGIS Image for ArcGIS Online user type extension, which is compatible with the Creator or GIS Professional user type and a Publisher, Facilitator, or Administrator role (or a custom role with the privileges listed above). If you do not have these privileges, you will not see the Raster Analysis option as described below.

Some raster analysis tools also require the Publish hosted feature layers privilege, which is automatically turned on when the Imagery Analysis privilege is turned on.

Access the tools

To access and use raster analysis tools in Map Viewer Classic, follow these steps:

  1. Open a web map containing the imagery layer or layers you want to analyze in Map Viewer Classic.
  2. Click the Analysis button Analysis button on the map menu bar.
  3. In the Perform Analysis pane, click Raster Analysis.

Note:

If you do not see the Raster Analysis tools in the Analysis pane in Map Viewer Classic, you might not be assigned the ArcGIS Image for ArcGIS Online license, or your organization may not have published at least one hosted feature layer. One hosted feature layer must be published before accessing raster analysis tools.

Explore the Raster Analysis pane

The Raster Analysis pane is illustrated below. This pane contains a number of categories, and each category contains tools. To view the tools in a category, click the expand or collapse button on the left side of the category.

Raster analysis categories and tools

Open the Raster Function Editor

Open the Raster Function Editor window. For details, see Raster Function Editor.

Open the Browse raster function templates and custom web tools window

Open the Browse Raster Function Templates and Custom Web Tools window. For details, see raster functions.

Open the Analysis Environments dialog box

Open the Analysis Environments dialog box.

Return to the Perform Analysis pane

Return to the Perform Analysis pane.

View help for the tool or category

View help about the category.

Expand the category to view tools within

Expand the category to view the tools it contains.

Use the analysis environments

The Analysis Environments button Analysis Environments is used to access the raster and imagery processing environments that apply to all raster analysis tools. When you open the Analysis Environments window from the Raster Analysis pane, you can modify the settings for the output coordinate system, processing extent, snap raster, cell size, and mask.

Analysis EnvironmentDescription
Output coordinate system

Specifies the coordinate system of the result imagery layer.

The following options are available:

  • Same as input—The result of your analysis will be in the same coordinate system as the input. This is the default.
  • As specified—The result of your analysis will be in the coordinate system you choose. When this option is selected, click the globe button Select Coordinate System and choose from a list of known coordinate systems, or add the spatial reference WKID in the box provided.
  • Layer <name>—The result of your analysis will be in the same coordinate system as an existing layer you choose in your web map.

Extent

Specifies the extent or boundary that will be used during execution of the analysis. All pixels or cells that are completely within or that intersect the specified extent will be used in the analysis.

The following options are available:

  • Default—The extent used for analysis is provided by the tool.
  • As specified—The extent is defined by the coordinates you provide.
  • Layer <name>—The extent used to process your analysis will be the same as the spatial extent of an existing layer you choose in your web map.

Snap Raster

Adjusts the extent of the output raster layer so it matches the cell alignment of the specified Snap Raster layer.

Cell size

Specifies the cell size or resolution that will be used to create the output raster layer in raster analysis. The default output resolution is determined by the largest cell size of the input raster layer.

The following options are available:

  • Minimum of Inputs—Use the smallest cell size of all input layers.
  • Maximum of Inputs—Use the largest cell size of all input layers. This is the default.
  • As specified—Specify a numeric value to set the cell size. If this is selected, the default value is 1.
  • Layer <name>—Set the cell size to the raster layer chosen.

Mask

Specifies a layer that will be used to define your area of interest for analysis. Only those cells that fall within the analysis mask will be considered in the analysis operation.

  • The mask can be either a raster or a feature layer.
  • If the analysis mask is a raster, all cells that have a value will be considered to define the mask. Cells in a mask raster that are NoData will be considered to be outside the mask and will be NoData in the analysis result layer.
  • If the analysis mask is a feature layer, it will be internally converted to a raster on execution. For this reason, ensure that Cell Size and Snap Raster are set appropriately for your analysis.

When you open the Analysis Environments window from a raster analysis tool pane, you may see additional analysis environments. Some raster analysis tools honor several of the analysis environments listed in the table below. Because not all tools honor all the environments, they are accessed from the individual tools instead of from the Raster Analysis pane.

Analysis EnvironmentDescription
Resampling method

Specify how to interpolate pixel values when transforming your raster dataset. This environment is used when the input and output do not line up, when the pixel size changes, when the data is shifted, or a combination of these situations.

The following options are available:

  • Nearest neighborhood—Used primarily for discrete data, such as a land-use classification, since it does not create new pixel values. This method is also appropriate for continuous data when you want to preserve the original reflectance values in imagery for accurate multispectral analysis. It is the most efficient in terms of processing time but may introduce small positional errors in the output image. The output image may be offset by up to half a pixel, which may cause the image to have discontinuities and a jagged appearance.
  • Bilinear interpolation—This method is most appropriate for continuous data. It performs a bilinear interpolation and determines the new value of a cell based on a weighted distance average of the four nearest input cell centers. It creates an output image that is smoother in appearance than Nearest neighborhood but alters the reflectance values, which results in blurring or loss of image resolution.
  • Cubic convolution—Suitable for continuous data. This method performs a cubic convolution and determines the new value of a cell based on fitting a smooth curve through the 16 nearest input cell centers. The result is geometrically less distorted than the raster achieved with Nearest neighborhood, and sharper than Bilinear interpolation. In some cases, it can result in output pixel values outside the range of input cell values. If this is unacceptable, use the Bilinear interpolation method instead. Cubic convolution is computationally intensive and takes longer to process.

Processor type

Specify whether to run the analysis using the CPU or GPU. If the Processor type environment is empty, the tool uses CPU to process the data.

The following options are available:

  • CPU—Processing will use the CPU. CPU processing can be parallelized across multiple cores and instances, as handled by the Parallel processing factor.
  • GPU—Processing will use the GPU. GPUs are effective at graphics and image processing, where their highly parallel structure makes them efficient in processing large blocks of data in a repetitive manner. The raster analysis tools that honor this environment can distribute its job across GPU instances at multiple raster analysis server machines, as handled by the Parallel processing factor.

Recycle interval of processing workers

Define how many image sections will be processed before restarting worker processes, to prevent potential failures in long-running processes. The default value is 0.

Parallel processing factor

Specify the number of raster processing service instances that can be used for processing your data.

If the tool doesn't honor the Processor type, or if the Processor type environment is set to CPU, the Parallel processing factor environment controls raster processing (CPU) service instances. If the Processor type is set to GPU, the Parallel processing factor environment controls the number of raster processing GPU instances.

By setting the Parallel processing factor, you can request the number of parallel workers that the raster analytics image server uses to process one raster analysis task. However, if the total number of parallel processes exceeds the maximum number of raster processing (CPU or GPU) service instances, the additional parallel processes will be queued.

If the Parallel processing factor is not specified, which is the default, the tool will use 80 percent of the maximum number of raster processing service instances. Either an integer number or a percentage can be specified as the parallel processing factor.

Number of retries on failures

Defines how many retries the same worker process will attempt when there is random failure processing a particular job. The default value is 0.

Work with a tool pane

To open a raster analysis tool pane, click the tool button. This opens the tool's pane as illustrated below with the Monitor Vegetation tool.

Monitor Vegetation pane

Open the Analysis Environments dialog box

Open the Analysis Environments dialog box.

Close the tool pane without running the analysis

Close the tool pane without running the analysis and return to the Raster Analysis pane.

Get help about a parameter

Get help about a parameter.

The result of running the analysis is saved to Content using this name

The result of running the analysis is saved to Content using this name.

You can specify a folder in Content in which to save the result

You can specify a folder in Content in which to save the result.

Show how many credits will be used if you run the analysis

Show how many credits will be used if you run the analysis.

If checked, only the data visible in the current map will be analyzed

If checked, only the data visible in the current map will be analyzed.

Note:

Before running an analysis tool in ArcGIS Online, you can use the credit estimator to calculate the expected number of credits that will be used. If your organization has enabled credit budgeting and the expected number of credits exceeds the number of credits allocated to you, ArcGIS Online displays an error message. For more on credit allocation and consumption, see Understand credits.

Each tool has a different set of parameters. You can always view help for a parameter by clicking the help button next to the parameter as illustrated above. All tools have a Result layer name parameter where the results of running the analysis are written. You can change this name or use the default value.

Use current map extent

It is recommended that you always check Use current map extent and that you zoom in to the area you want analyzed. Doing so limits the amount of imagery or raster pixels the tool will include when performing analysis as well as limiting the number of credits used by the tool. If you uncheck Use current map extent, the entire input imagery layer will potentially be analyzed, and credits used by the tool will be based on the size of the imagery and complexity of the analysis.

Note:

The Use current map extent parameter will be unchecked when the Processing Extent environment is set. Checking Use current map extent will override Processing Extent.