Perform analysis (Map Viewer)

When you look at a map, you may start turning that map into information by finding patterns, assessing trends, or making decisions. This process is called spatial analysis.

Some patterns and relationships aren't obvious by looking at a map. There may be too much data to sift through to present coherently on a map. The way you display data on a map can change the patterns you see. Spatial analysis tools and functions allow you to quantify patterns and relationships in the data and display the results as maps, tables, and charts. Using spatial analysis tools and functions, you can answer questions and make decisions using more than a visual analysis.

Feature analysis

Feature analysis is performed on vector data sources, which is coordinate-based data that represents geographic features using points, lines, and polygons.

Feature analysis can be used to summarize features based on geographic location, measure distances around or between features, and quantify spatial patterns.

Feature analysis tools are identified in the Tools pane by the feature tool icon Feature tool.

If you're a developer, you can access these tools through the ArcGIS REST API Spatial Analysis service and the ArcGIS API for Python arcgis.features.analysis module.

Raster analysis

Raster data consists of a matrix of cells (or pixels) organized into rows and columns (or a grid) where each cell contains a value representing information, such as temperature or elevation. Rasters can be digital aerial photographs, satellite imagery, digital pictures, or scanned maps.

Imagery and raster data contains information that can be used to identify patterns, find features, and understand change across landscapes. To extract information from imagery, you can process or analyze the data. For example, you can calculate a vegetation index to get an understanding of vegetation coverage from a multiband image or find suitable locations to build solar power plants using statewide elevation and land cover raster data.

Raster analysis can be performed by tools that are identified in the Tools pane by the raster tool icon Raster tool and by raster functions that are identified by the raster function icon Raster function.

If you're a developer, you can access these tools through the ArcGIS REST API Raster Analysis service and the ArcGIS API for Python arcgis.raster.analytics module and arcgis.raster.functions.gbl module.

Access analysis

To access and use analysis tools and functions in Map Viewer, complete the following steps:

  1. Confirm that you are signed in to your ArcGIS organization and that you have the required privileges to perform analysis.
  2. In Map Viewer, open the map containing the layers you want to analyze or add the layers directly. Optionally, browse for layers when you update the input parameters.
  3. On the Settings (light) toolbar, click Analysis Analysis.
    Note:

    If you do not see the Analysis button in Map Viewer, contact your ArcGIS administrator. Your organization may not be configured or you may not have privileges to perform spatial analysis. If you do not have the privileges required for a tool or raster function, it will not be visible.

    Learn more about licensing requirements for spatial analysis

  4. Choose one of the following:
    • Click Tools Tools to open the analysis tools.
    • Click Raster Functions Raster function to open the raster functions.
  5. Click a category to expand it. Alternatively, use the search box to search by name or keyword.
  6. Choose a tool or function.

    The tool pane appears with the input parameters.

  7. Click the Layer button for the input parameters to select an input layer. If the input layer has not been added to the map, do the following:
    1. Click Browse layers.

      The Select layer window appears showing layers from My content.

    2. Click My content and choose a different option from the menu (for example, My groups or My organization) if necessary.
    3. Use the Search bar or Sort by menu to reduce the number of layers or reorder the layers if necessary.
    4. On the desired item, click Select layer, and choose a layer from the menu.
    5. Click Confirm or Confirm and add to map.
  8. Update the remaining parameters, including naming the output layers, and updating any required configurations.
    Tip:

    Click the help icon beside a parameter to view the help. You can also click Learn more to open the help topic.

  9. Click Environment settings to view and update the environments that are used during the processing.
  10. Click Run.

The analysis runs and the output datasets are added to the web map. Information about the operation, including unsuccessful runs, is added to the analysis history for the web map.

Supported data

One or more input datasets are required for analysis. Some tools and functions only work with certain data types. For example, Aggregate Points requires an input layer containing point features, and the Aggregate Multidimensional Raster tool requires a multidimensional imagery layer.

The following data types are supported for feature inputs:

  • Feature service
  • Hosted feature layer
  • Map Service layer
  • Sketch layer
  • Table layer

The following data types are supported for raster inputs:

  • Image service
  • Hosted imagery layer
  • Deep learning package file (.dlpk)

Limitations

Feature services, map services, and image services must be accessible within your portal; the URL to the service must either be publicly accessible or in the same network as the portal and hosting server you use to run the analysis.

Domain descriptions and subtypes are not maintained in analysis results.

Attachments from the input layers will not be included in the output layer.

Some analysis tool parameters do not support DateOnly and TimeOnly field types. TimestampOffset fields cannot be used in analysis. If an input layer includes these field types, they will not be available in parameters where analysis fields are chosen.

TimestampOffset fields cannot be included in output datasets. If an input layer includes a TimestampOffset field and the tool creates an output that preserves the fields from the input layer, the analysis will fail.

Some tools do not support high-precision date fields. Inputs with high precision may result in output fields with fractional seconds or milliseconds removed.

Analysis outputs

Analysis results produce one or more outputs. When a tool or function runs successfully, the output will be added to the Layers pane. When the analysis produces a table output, it will be added to the Tables pane. The results can also be accessed from the analysis history on the Results tab of the analysis details.

The Extract Data tool doesn't add results to the Layers pane. Instead, your extracted files will be saved as items in your contents.

Note:

Output names cannot begin or end with a space and cannot include the following special characters: [, ], (, ), -, <, >, #, %, :, ;, ", ?, &, +, =, |, /, \, *, or @

Tool comparison

The following table lists new tools, tools that have been renamed, and tools that are not yet supported in Map Viewer. Tools that are not listed are supported in both Map Viewer and Map Viewer Classic under the same name. Differences in tool functionality are documented in the help topics for Map Viewer tools.