Skip to main content

Generate and review drawing metrics

Drawing metrics can be used to evaluate maps and scenes for performance bottlenecks, especially in complex drawings with many layers where issues can be difficult to identify or not immediately apparent. The Draw Metrics tab of the Analyze Map pane generates and presents analytics about the drawing performance of layers in your map or scene.

Drawing metrics include essential time- and feature-based metrics by layer in 2D and 3D formats. The metrics can be used to understand how the layers in your map and their settings contribute to overall drawing time. Differences in performance may be due to slow network access times, the data source of the layer, or the number of features being processed.

These metrics are focused on providing insight on map drawing performance only. For assessing issues related to the performance of the application, use the Diagnostic Monitor. You can also analyze your map to identify known contributors to decreased drawing performance.

Generate drawing metrics for a map's current extent

Drawing metrics can be generated for any map or scene in your project. The application uses the extent of the active view to generate metrics. Collection completes when drawing concludes for all layers in the extent.

Note:

Drawing metrics cannot be generated for stereo maps.

To generate drawing metrics for the current extent of your map or scene, do the following:

  1. Pan or zoom the map or scene to the extent you wish to collect metrics.

  2. On the ribbon, click the Help tab. In the Performance group, click Analyze Map.

    The Analyze Map pane opens.

  3. In the Analyze Map pane, click the Draw Metrics tab.

  4. On the Draw Metrics tab, click Generate Metrics.

    To collect metrics, the active map or scene redraws, and the cache is cleared. You cannot interact with the application until drawing completes, but the process can be canceled. Similarly, you cannot generate metrics when drawing is paused.

    Important:

    If you click to generate metrics while the map is drawing, results may not be accurate.

You can filter the metrics table to search for layers by typing part or all of a layer's name into the provided search bar.

If you pan or zoom to a new extent, results do not update automatically. Your results may need to be regenerated because the amount of data or the scale at which your data draws may have changed. Click the Generate Metrics button again to update the metrics for the new extent.

The generated results for a map view remain in the pane until the map is closed or the button is clicked again.

Drawing metrics results

To aid you in understanding the metrics, the results are subdivided into one or more categories: 2D Layers, 3D Layers, and Elevation Surfaces. Each category includes unique metrics that relate to the background processes used to render the drawing, and every layer is categorized accordingly. If a layer is not visible, no metrics are generated, and the layer is not listed. Additionally, some visible layers may report no metrics, which is indicated with an icon.

Details regarding each category and their metrics are outlined below. Not all maps include multiple categories. For example, if your scene only contains 3D layers, then only the 3D Layers category is included in the results. If your scene includes 2D and 3D layers, your results will include both categories.

The default order of the layers is according to the drawing order in the Contents pane. To change the order in the table, right-click the table's header and choose Sort Ascending or Sort Descending. You can also select the layer in the Contents pane by right-clicking the layer's name in a metrics table and choosing the context menu option.

In each table, the Data Access column (in seconds) is the amount of time it takes to search for and retrieve the data from its source (local or network) to the client.

Totals

The Totals section includes summarized metrics regarding the complexity of your map.

  • Map Draw Time - Sometimes referred to as 'clock time', it is the amount of time passed (in seconds) for the first layer to begin drawing until the last layer in the map completes drawing. It is not the sum of all total times listed in each category's table. In some cases, the draw time may be lower than expected due to multithreaded processing used in ArcGIS Pro.

    Tip:

    In some cases, layer time totals may be higher than the Map Draw Time because layers are divided into multiple draw tiles for parallel processing. For example, imagery layers request tiles simultaneously, and the reported time corresponds to the total duration for each tile.

  • 2D Features Processed - The sum of features in the 2D Layers category that the application processed in all drawing phases. This is not the total number of features in the extent, as one feature may be processed multiple times in separate phases.

  • 3D Features Processed - For scenes only. The number of 3D features the application processed in all drawing phases. This is not the total number of features in the extent, as one feature may be processed multiple times in separate phases.

  • 3D Memory Usage - For scenes only. The amount (in megabytes (MB)) of memory consumed by the software to complete drawing.

  • Elevation Tile Count - For elevation surfaces, the number of tiles the application processed in all drawing phases.

2D Layers metrics

This metrics table includes information about every 2D layer in the map's extent. The sum of all features processed and loading time are reported in the Total row. The Data Access time may coincide with the times listed for each drawing phase (see below). When tile-based layers are redrawn, the metrics include any tiles that are drawn outside the extent to support the content in the view.

Time and feature processing are further grouped into drawing phases. Drawing phases are fundamental periods of operation that occur each time a map is drawn, and are focused on key areas of visualization:

  • Geography - Includes all symbology and visual effects.

  • Geographic Overlay - Used in special cases where the primary symbology is set to draw over other layers in the drawing order. For example, proportional symbols for polygon feature layers are drawn in this phase.

  • Selection - Includes all selection drawing.

  • Labeling - Includes all labeling, annotation, and dimension draws. Layers that have barrier weights (for example, graphics layers) may display time or feature processing totals, as barriers affect the placement of labels.

  • Masking - Includes all masking and feature level masking draws.

If the map does not have metrics to report for one or more drawing phases, they are not included in the metrics table by default. To show or hide a phase in the table, right-click the table header and check or uncheck the phase.

Tip:

Use the metrics to make comparisons between layer types as needed. A layer that reports a high Data Access time may indicate issues with decreased network performance, hard drive slowness, or other reasons. For layers with high feature processsing counts, consider clipping the layer to an area of interest or building a multiscale map.

3D Layers metrics

This metrics table includes information about every 3D layer in the extent of a scene. The sum of all features processed and loading time are reported in the Total row. When tile-based layers are redrawn, the metrics may include tiles that are drawn or processed at varying levels of detail (LOD) to support the content in the view.

In addition to data access metrics, the 3D Layers metrics table includes:

  • Features Processed - The sum of features per layer that were processed by the software.

  • Complexity Index - A scoring scale that represents the layer's feature, data, symbology, and vertex complexity. If the index for a particular layer exceeds 100 percent, the layer is considered too complex to draw, and a drawing alert is returned.

  • Vertex Count - The sum of vertices per layer that appear in the extent.

  • Memory Usage - The amount (in megabytes (MB)) of GPU memory consumed by the software to complete drawing the layer as it appears in the extent. Layers with high memory usage may, for example, have more material textures rendering in the view, such as a 3D-object feature layer with multiple LODs. See Reduce the load on the GPU for more information.

The complexity index scale adjusts according to the graphics capabilities of the system. If the metrics indicate your layer is drawing with a heightened complexity index or memory consumption, consider lowering the amount of features in the extent, modifying the symbology, or changing the application's rendering quality settings.

Elevation Surface metrics

This metrics table includes information about every elevation surface or its sources in a map or scene. Total counts are reported in the Total row.

In addition, the Elevation Surfaces metrics table includes:

  • Elevation Tile Count - The sum of tiles that each elevation surface processes.

Copy draw metrics

After drawing metrics are generated, you can copy and paste part or all of a table into another program for further analysis. In the Draw Metrics tab, click the Copy table button for any category.

You can also copy and paste a subselection of rows. To select one or more rows, hold the Shift key and click each row. Then click the Copy selected rows button for the selected category. To clear the selection, click Clear selected rows.