Use the analysis tools

Note:

This functionality is currently only supported in Map Viewer Classic (formerly known as Map Viewer). It will be available in a future release of the new Map Viewer (formerly known as Map Viewer Beta).

Below you'll find information about accessing and using the analysis tools. This information applies to all tools.

Licensing

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

  • Create, update, and delete content
  • Publish hosted feature layers
  • Spatial Analysis

These privileges are available with a Creator or GIS Professional user type and a Publisher, Facilitator, or Administrator role. If you do not have these privileges, you will not see the Perform Analysis option as described below.

Certain tools need additional privileges such as Network Analysis and GeoEnrichment. See Perform analysis for more information about these tools.

Raster analysis tools also require additional privileges and licensing. See Use the raster analysis tools for details about these tools.

Access the tools

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

  1. Open a web map containing the feature layer or layers you want to analyze in Map Viewer Classic.
  2. Click the Contents button in the Details pane.
  3. Do one of the following:
    • Click the Analysis button Analysis button on the map menu bar.
    • Hover over the layer you want to analyze and click the Analysis button Analysis button.
  4. If raster analysis is enabled for your account, choose either Feature Analysis or Raster Analysis.

The Perform Analysis pane opens.

Explore the Perform Analysis pane

The Perform 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.

Analysis categories and tools

Open the Analysis Environments dialog box

Open the Analysis Environments dialog box.

This button is only available when raster analysis is enabled.

Return to the Details pane

Return to the Details pane.

Expand the category to view tools within

Expand the category to view the tools it contains.

View help about the category

View help about the category.

View help for the tool

View help for the tool.

Use the analysis environments

The Analysis Environments button Analysis Environments is used to access settings that are applied to all tools run from your map. The Analysis Environments window can be used to change the processing extent (the extent of the data used during execution of the analysis). The processing extent can be set as one of the following three options:

  • Default—The tool uses the extent of the data specified by the tool being run. If a tool has Use current map extent checked, only features in the visible extent are used. If Use current map extent is not checked, all features are used. This option is the default. When this option is selected, Use current map extent is checked by default.
  • Layer < layer name >—The tool uses the extent of a layer included in the map for processing. When this option is selected, Use current map extent is not checked by default. Checking Use current map extent overrides using the selected layer's extent.
  • As specified—The tool uses an extent you provided by typing the coordinates using the Web Mercator projection. When this option is selected, Use current map extent is not checked by default. Checking Use current map extent overrides using the selected layer's extent.

Additional analysis environment settings are available for raster analysis tools. See raster analysis environments for more information.

Work with a tool pane

To open an analysis tool pane, click the tool button. This opens the tool's pane as illustrated below with the Aggregate Points tool.

Aggregate Points pane

Open the Analysis Environments dialog box

Open the Analysis Environments dialog box for the tool.

This button is only available when raster analysis is enabled.

Close the tool pane without running the analysis

Close the tool pane without running the analysis and return to the Perform 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 number of features the tool needs to examine when performing analysis as well as limiting the number of credits used by the tool. If you uncheck Use current map extent, all features in the analysis layer will potentially be analyzed, and credits used by the tool will be based on the number of features in the layer.

Rerun analysis tools

Analysis tools can be rerun by clicking the Rerun Analysis button Rerun analysis for a result feature layer. Rerun Analysis will open the tool that was used to create the layer and repopulate all of the parameters. The tool can be rerun with the same parameters, or the parameters, including inputs, can be updated before the tool is run.

When rerunning analysis tools, the state of the current map will be honored, including filters, extent, input layers, and output folder. If you want to ensure that an analysis is rerun at a specific extent, create a bookmark. If you share your results with the intention of allowing other users to rerun your analysis, you may need to share your input layers as well. If you open a tool using Rerun Analysis and the input layers are not available, a warning will be displayed but the tool can still be run with different inputs.

Note:

Analysis tools can only be rerun for result layers created after June 26, 2017.

The Result layer name from the previous iteration will be used when you open an analysis tool using Rerun Analysis. You must create a unique name before rerunning a tool.