Skip to main content

Use analysis tools

The analysis tools enable users to extract insights from imagery by running spatial, spectral, and measurement-based analyses, helping them identify features, detect patterns and changes, and generate actionable intelligence to support decision-making.

Use the Mark Up tool

The markup tools allow you to create simple graphics using text and shape elements to call attention to areas of interest.

Create markup

To create markup, complete the following steps:

  1. Click the Tools menu in the canvas.

  2. In the Analysis Tools list, click Mark Up.

  3. Choose a geometry:

    • Point—Click the map to drop a point.

    • Line—Click the map to draw a line segment. Double-click to complete the line.

    • Rectangle—Click and drag the map to draw a rectangle.

    • Polygon—Click the map to draw at least three segments. Double-click to complete the polygon.

    • Text label—Type text in the input box, and click the map to drop a label.

  4. Optionally, before drawing mark up, customize mark up with the following options based on the geometry you chose:

    • Size

    • Style

    • Outline

    • Fill

    • Width

    • Transparency

    • Font Color (Text label only)

    • Font Size (Text label only)

    • Name

    • Description

To edit or delete an existing markup, open the Mark Up tool, and click directly on the corresponding markup graphic on the map or image. To delete all markup, click the Clear All Markup button. All graphics will be deleted.

Note:

You can save markup when an Excalibur project is created or saved. For more information, see Save markup to a project.

Use the Count tool

The Count tool allows you to count objects manually by marking each object with a numbered graphic. The Count tool places a point graphic where you click and keeps a total count associated with each point graphic as it is added.

To count objects, complete the following steps:

  1. Click the Tools menu in the canvas.

  2. In the Analysis Tools list, click Count.

  3. Optionally, change the following properties of the point graphic that will be created:

    • Fill

    • Outline

    • Size

    • Style

  4. Optionally, in Count Options, set the following:

    • Start At—The number that the count will begin at once a count is started (1–100).

    • Increment By—The increment that the count will increase after the first count graphic is added (1–10).

    For example, if you set Start At to 2 and set Increment By to 2, the following pattern would be expected: 2, 4, 6, 8, and so on.

  5. Once the style properties and count options are set, click Start Count to begin counting.

  6. Click on the map or image to create a count graphic at that location, and, optionally, continue clicking to add more count graphics.

    The Count Total value updates based on the count start and increment numbers.

  7. Optionally, once count graphics are added to the map, set the following:

    • Undo Last Count —Remove the last count graphic that was placed. You can continue to use this to undo actions for a sequential removal of count graphics.

    • Clear Count —Remove all count graphics.

  8. Click Stop Count when the count workflow is complete.

Note:

You can change the Increment By setting when an active count has been stopped.

Use the Measure tool

Measuring ground features in imagery is an important function in many image interpretation or feature compilation applications. The Measure tool allows you to measure horizontal and vertical distances, areas, and feature locations on an image in map and image space. The Measure tool also allows you to conduct 3D measurements on imagery in the Focus Panel. The available measurement tool options depend on the metadata and capabilities set on the image service.

To calculate measurements in the map and focus views, complete the following steps:

  1. Click Tools in the canvas.

  2. In the Analysis Tools list, click Measure.

  3. Choose the measurements type:

    • Map Measurements—Map measurements can only be performed in the Map Panel. Distance and Area are the only measurements available to perform.

    • Image Measurements—Image measurements can only be performed in the Focus Panel. The available image measurements are based on information from the image metadata and capabilities on an image service.

  4. Click a measurement to perform.

  5. From the drop-down list, choose the units to display.

    Note:

    The available units to display are based on the measurement type selected. Point and centroid measurements will automatically generate unit results.

  6. Click the map or image to create a measurement.

    The Measurement Results list will automatically populate based on the units selected and the underlying sensor model and information from the image service.

  7. Optionally, select one or more of the following:

    • Hide measurement on map —Turn the visibility of the measurement off.

    • Hide label on map —Turn the visibility of the measurement label off.

    • Copy to clipboard —Copy the results to the clipboard.

    • Clear from list —Remove the measurement from the map and the Measurements Results list.

    If the measurement conducted was a distance measurement type with multiple vertices, the segments will appear in the Measurement Results list where information and options for each segment can be viewed and turned on and off.

  8. Click Clear All to remove all measurements from the Map Panel and the Measurements Results list.

Use deep learning

Deep learning models can be used to automate recording observations and extracting features from an image-based analysis layer in an Excalibur project. The Deep Learning tool is available if there is at least one ArcGIS imagery layer, ArcGIS tiled imagery layer, or ArcGIS tile layer in an Excalibur project. For more information about requirements to use this tool see Requirements.

To learn how to use this tool, see Use Deep Learning models.

Use the NDVI tool

The normalized difference vegetation index (NDVI) is used to measure the greenness, also known as relative biomass, of vegetation by calculating the differential reflection between the red and infrared bands. This index uses the contrast of characteristics between two bands from a multispectral raster dataset—the chlorophyll pigment absorption in the red band, and the high reflectivity of plant material in the near-infrared (NIR) band. NDVI is used worldwide to monitor drought, monitor and predict agricultural production, assist in predicting hazardous fire zones, and map desert encroachment.

NDVI is available if there is at least one multiband ArcGIS imagery layer or ArcGIS tiled imagery layer in the map. For additional requirements needed to use this tool, see Requirements.

To use the NDVI tool, complete the following steps:

  1. Click Tools in the canvas.

  2. In the Analysis Tools list, click NDVI.

  3. Select the layer you would like to use as the input analysis layer.

  4. Select Use the view extent or Draw an area for the Area of Interest value. For Use the view extent, pan and zoom in the Map Panel to the desired area. For Draw an area, click Draw Area , and draw the extent in the Map Panel.

  5. Set the Visible Band ID value to the ID of the red band.

    The Visible Band ID value represents the red part of the electromagnetic spectrum.

  6. Set the Infrared Band ID value to the ID of the infrared band.

    The Infrared Band ID value represents the near-infrared part of the electromagnetic spectrum.

  7. Select a Colormap value for the output:

    • NDVI—Values near zero are blue. Low values are brown. Then the colors gradually change from red, to orange, to yellow, to green, and to black as the vegetation index goes from low to high.

    • NDVI2—Low values range from white to green. Then the colors range from gray, to purple, to violet, to dark blue, and to black as the vegetation index goes from low to high.

    • NDVI3—Values near zero are blue. Then the colors gradually change from red, to orange, and to green as the vegetation index goes from low to high. This is the default.

  8. Provide a Layer Name value for the output layer.

  9. Optionally, change the output Folder location to a different folder, or create a folder. In an ArcGIS Online environment, you will also have the option to select the type of output layer as either a Dynamic Imagery Layer or Tiled Imagery Layer.

  10. Click Run.

The results appear in the canvas and in the Layers list when the tool completes successfully. Any errors in the process are returned by the server and displayed in the tool.

Use the Raster Templates tool

The Raster Templates tool allows you to select raster function templates that can be used for conducting imagery and raster analysis. Raster function templates are combinations of raster functions that are used to create a specific visualization or analysis that can be repeated. Raster function templates can be created through the Raster Function Editor in Map Viewer or ArcGIS Pro or ArcGIS AllSource, and used in ArcGIS Excalibur for analysis.

The Raster Templates tool is available if there is at least one ArcGIS imagery layer or ArcGIS tiled imagery layer in the map. For additional requirements needed to use this tool, see Requirements.

To use the Raster Templates tool, complete the following steps:

  1. Click Tools in the canvas.

  2. In the Analysis Tools list, click Raster Templates.

  3. Select Add Template to open the Raster Function Templates browser.

  4. Search for and select the templates you want to add.

  5. Once selected, click Add to add the templates to the tool.

  6. Click the Options button next to a template to open it, view the details, or remove the template.

  7. Click Open to open the template.

  8. Select Use the view extent or Draw an area for the Area of Interest value. For Use the view extent, pan and zoom in the Map Panel to the desired area. For Draw an area, click Draw Area , and draw the extent in the Map Panel.

  9. Provide any inputs needed for the different raster functions in the template.

  10. Provide a Layer Name value for the output layer.

  11. Optionally, change the output Folder location to a different folder, or create a folder. On ArcGIS Online you have the option to select the type of output layer, either a Dynamic Imagery Layer or a Tiled Imagery Layer.

  12. Click Run.

The results appear in the canvas and in the Layers list when the tool completes successfully. Any errors in the process are returned by the server and displayed in the tool or in the Job Status panel.

Use the Spectral tool

The Spectral tool helps you analyze multiband and hyperspectral imagery to identify materials, detect targets or anomalies, compare spectral signatures, and extract detailed information about land cover and surface composition based on how different features reflect light across the electromagnetic spectrum.

This tool is available if there is at least one multiband ArcGIS imagery layer or ArcGIS tiled imagery layer in the map. For additional requirements needed to use this tool, see Requirements.

To use the Spectral tool, complete the following steps:

  1. Click Tools in the canvas.

  2. In the Analysis Tools list, click Spectral.

You will have two options to select from:

  • Detect Anomalies—Creates an anomaly score raster from an input multiband or hyperspectral image. The anomaly score raster is a single band raster with values between zero and one.

  • Detect Target—Computes a matching score for each pixel in an input raster based on how well the pixel's spectrum matches the target spectra defined by an input spectral signature file.

Follow these steps to use the Detect Anomalies option:

  1. Select the layer you would like to use as the input analysis layer.

  2. Select Use the view extent or Draw an area for the Area of Interest value. For Use the view extent, pan and zoom in the Map Panel to the desired area. For Draw an area, click Draw Area , and draw the extent in the Map Panel.

  3. Select an Anomaly Calculation Method:

    • RXD—Extracts pixels that are significantly different from the background. This method calculates the pixels' Mahalanobis distance to the background, which is defined by the mean. This is the default.

    • UTD—Extracts background pixels from the input image. This method is similar to the RXD method but extracts the background.

    • KMEANS—Extracts pixels that significantly deviate from established clusters in the data using a K-means clustering algorithm.

  4. Optionally, select a Background Region. This specifies a polygon feature layer that defines the region used to calculate background statistics. This parameter only appears if anomaly calculation method is set to RXD or UTD. It will also only be enabled if you have a polygon feature layer in your map.

  5. Optionally, select a Number of Clusters. The number of clusters specifies the number of clusters to use if the anomaly calculation method is set to KMEANS.

  6. Optionally, choose to Recompute Statistics. Recompute statistics determines whether to recompute statistics for the input raster when Anomaly calculation method is set to RXD or UTD, which require accurate statistics to perform. If checked, statistics are recomputed for the input raster. This is the default.

  7. Type a Layer Name for the output layer.

  8. Optionally, change the output Folder location to a different folder, or create a folder. On ArcGIS Online you have the option to select the type of output layer, either a Dynamic Imagery Layer or a Tiled Imagery Layer.

  9. Click Run.

The results appear in the canvas and in the Layers list when the tool completes successfully. Any errors in the process are returned by the server and displayed in the tool or in the Job Status panel.

Follow these steps to use the Detect Target option:

  1. Select the layer you would like to use as the input analysis layer.

  2. Select Use the view extent or Draw an area for the Area of Interest value. For Use the view extent, pan and zoom in the Map Panel to the desired area. For Draw an area, click Draw Area , and draw the extent in the Map Panel.

  3. Select the Input File Type. This indicates the file type of the input spectral signature file. The following options are available:

    • Spectra file (default) - The spectral signature file is an Esri spectral library file (.esl).

    • Feature layer - The spectral signature file is a point feature layer, which you can create in ArcGIS Pro using Training Samples Manager.

  4. Select the Input Spectra File or Input Feature Layer depending on which input file type you selected. This specifies the spectral signature file that contains the target spectra. Select the spectra file you would like to use from the Spectra Library Files browser, or select a point feature layer. The point feature layer must be in your map in order to be selected in the input.

  5. Choose the Detection Method. This specifies the method used to compute the matching score between the input raster and the spectral signature file. All scores are normalized from zero to one. A higher score indicates a better match between a pixel's spectrum in the input raster and the target spectrum in the spectral signature file. The following options are available:

    • SAM— Use the Spectral Angle Mapper method to compute matching scores. This method measures the angle between the target spectrum and the pixel spectrum. It is not sensitive to changes in illumination. This is the default.

    • SID—Use the Spectral Information Divergence method to compute matching scores. This method measures the divergence between the probability distributions of the target spectrum divided by the pixel spectrum. This option is useful to identify targets in pixels with mixed spectra.

    • SID-SAM—Use a combination of the Spectral Information Divergence and Spectral Angle Mapper methods to compute matching scores. This method can discriminate targets in pixels with mixed spectra better than the SID and SAM options individually.

    • NS3—Use the Normalized Spectral Similarity Score method to compute matching scores. This method uses the Euclidian distance and the SAM score to compute the matching score. This method can discriminate targets efficiently but requires extensive reference data for accuracy.

    • CEM—Use the Constrained Energy Minimization method to compute matching scores. This method uses a Finite Impulse Response (FIR) filter, which has a greater response to a pixel spectrum when it is more similar to the target spectrum. This option is useful when the background noise is minimal.

    • ACE—Use the Adaptive Cosine Estimator method to compute matching scores. This method estimates the similarity between a target vector and a pixel's spectrum after normalizing for background noise. This option is useful when the input raster has significant background noise.

    • MF—Use the Matched Filter method to compute matching scores. This method uses a FIR filter, which has a greater response to a mean-subtracted pixel spectrum when it is more similar to the mean-subtracted target spectrum. This option is useful when the background noise is additive white Gaussian noise.

  6. Optionally, choose to Remove Continuum. Remove continuum indicates whether to normalize the spectra, which can be done using an image or reference data. By default, this parameter is unchecked, and the spectra are not normalized. If checked, the spectra are normalized. To create the continuum, the tool uses straight-line segments to connect local maxima in the spectrum and fits a convex hull over the top of the spectrum. To remove the continuum, the continuum is divided into the spectrum of each pixel in the input raster and the target spectra in the input spectral signature file. This removal allows you to compare the absorption features in the input raster and input spectral signature file from a common baseline.

  7. Type a Layer Name for the output layer.

  8. Optionally, change the output Folder location to a different folder, or create a folder. On ArcGIS Online you have the option to select the type of output layer, either a Dynamic Imagery Layer or a Tiled Imagery Layer.

  9. Click Run.

The results appear in the canvas and in the Layers list when the tool completes successfully. Any errors in the process are returned by the server and displayed in the tool or in the Job Status panel.