Open Summary Reports - 2023.2 English

Vitis Unified Software Platform Documentation: Application Acceleration Development (UG1393)

Document ID
UG1393
Release Date
2023-12-13
Version
2023.2 English

Generally, the Summary reports provide a great overview of the specific steps in building and profiling the application to get a good view of where the application is with regard to performance and optimization.

  • For individual components review the Compile Summary.
  • For Application and device binary (xclbin) refer to the Link Summary, which also loads the Compile Summaries for linked components.
  • For embedded processor and AMD Versal™ AI Engine systems, review the Package Summary.
  • For performance profiling and event trace data related to the application execution, start with the Run Summary.

The Vitis analyzer offers the ability to open a folder, such as a workspace, using Open Summary Folder from the Welcome view, or from the command line when launching the tool. The tool examines the folder you specify and identifies the various build and run summaries included through the file hierarchy. The Open Summary Folder dialog box opens as shown below.

Figure 1. Open Summary Folder

The figure above shows the results of the Open Summary Folder when used on a Vitis IDE workspace. Filter by Type highlights the various types of reports found, and lets you enable or disable the reports of interest. Choose summary files to open lets you select specific files to open. In this way, you are viewing the type and specific reports of interest.

Vitis analyzer displays the various Summary reports in the Analysis view. Related Summaries are grouped into a hierarchy, so that the Link Summary for an Application includes the Compile Summaries and Run Summaries for the various components, in addition to any Run Summary for the Application. Separate Applications, or unrelated Components create separate hierarchies as shown below.

Figure 2. Analysis View Hierarchy

The Summary report provides access to the individual reports that are collected into the summary file, such as the Kernel Estimate, Operation Trace, AI Engine Trace, Timeline Trace, System Estimate, Log, and Timing Summary reports. Refer to Profiling the Application for more information on the individual reports generated by the build and run processes.

The Summary Files section menu also includes a drop down menu that includes the command Import Xbutil/Xsdb JSON Output as shown in the following figure. This command lets you import a Json file generated by the xbutil command or xsdb commands to display in the Analysis view.

Figure 3. Analysis View Menu