Viewing AI Engine Compilation Summary Reports - Viewing AI Engine Compilation Summary Reports - 2026.1 English - UG1702

Vitis Reference Guide (UG1702)

Document ID
UG1702
Release Date
2026-06-23
Version
2026.1 English

After compiling the AI Engine graph, the AI Engine compiler writes a summary of compilation results in <graph-file-name>.aiecompile_summary. The file displays in the Analysis view of the Vitis Unified IDE. The summary includes reports and diagrams that reflect the compiled state of the AI Engine application. The compiler writes the summary to the working directory specified by the --workdir option. The --workdir option defaults to ./Work.

To open the AI Engine compiler summary, use the following command:

vitis ./Work/graph.aiecompile_summary

The Vitis Unified IDE opens the Analysis view and displays the Summary page of the report. The Report Navigator view lists the different reports that are available in the Summary.

The listed reports include:

Summary
This top-level report summarizes build details, including the date, tool version, graph link, and build command.
Kernel Guidance
Shows a variety of messages to provide guidance on kernel optimization.
Graph
Provides a flow diagram of the AI Engine graph. Shows the data flow through the various kernels. You can zoom in and pan the graph display. At the bottom of the Reports view, a table summarizes the graph with information related to kernels, buffers, ports, and nets. Refer to Graph and Array Details for details.
Array
Provides a graphical representation of the AI Engine processor array on the Versal device. The tool places the graph kernels and connections within the array. You can zoom in and select elements in the array diagram. Choosing objects in the array also highlights the object in the tables at the bottom of the Reports view.
Note: The Graph and Array reports both share the same tables. When selecting an item in either of the views, it also selects it in both. For example, selecting a net in the Graph view, also selects it in the Array view.
Constraints
Shows all constraints used within the graph and from .json constraint files.
Mapping Analysis
Displays the text report graph_mapping_analysis_report.txt. Reports the block mapping, port mapping, and memory bank mapping of the graph to the device resources.
DMA Analysis
Displays the text report DMA_report.txt, providing a summary of DMA accesses from the graph.
Lock Allocation
Displays the text report Lock_report.txt, listing DMA locks on port instances.
AI Engine Compilation
Shows the single kernel compilation log file.

The following figure shows the graph.aiecompile_summary report in the Analysis. In the Array view, you can see the associated tables. You can view the source code on the right side.

Figure 1. Array View