Using the Vitis Analyzer

Revision History

Introduction

The Vitis™ analyzer is a utility that allows you to view and analyze the reports generated while building and running the application. It is intended to let you review reports generated by both the Vitis compiler when the application is built, and the Xilinx® Runtime (XRT) library when the application is run. The Vitis analyzer can be used to view reports from both the v++ command line flow, and the Vitis integrated design environment (IDE). You will launch the tool using the vitis_analyzer command (see Setting up the Vitis Environment).

When first launched, the Vitis analyzer opens with a home screen that lets you open summary files, binary containers, or directories. Clicking any of these links opens a file browser that allows you to select a specific file of the type described.

For the Build section:

Open Summary

Report Summaries are collections of reports related to specific stages of application development in the Vitis tool. There are summaries created for the two steps of the build process, compile and link, and from the run process when the application is executed. Selecting Open Summary lets you open one of the following:

Compile Summary

The Compile Summary report is generated by the v++ command during compilation, provides the status of the kernel compilation process. When viewing the Compile Summary report the tool also references the following reports generated during compilation: Kernel Estimate, Kernel Guidance, HLS Synthesis, and compilation log.

Link Summary

The Link Summary report is created by the v++ command during linking and creation of the .xclbin file. When viewing the Link Summary report the tool also references the following reports generated during linking: System Estimate, System Guidance, Timing Summary, Utilization, Operation Trace, Platform and System Diagrams, and linking logs. When you open a Link Summary, the Vitis analyzer will automatically open the associated Compile Summaries of kernels that were linked into the .xclbin file.

Note: Timing Summary and Utilization are only generated when the build targets Hardware (as opposed to emulation).

Run Summary

The Run Summary report is created by the XRT library during the application execution, and provides a summary of the run process. When viewing the Run Summary report the tool also references the following reports generated during the application run: Guidance, Profile Summary, Application Timeline, Platform and System Diagrams.

When you run the application after the v++ build process, the ID from the Link Summary is assigned to the Run Summary. When you open Run Summary and Link Summary, Vitis Analyzer links them based on the shared ID.

TIP: Multiple Run Summaries can use the same ID, linking them to the same Link Summary file.

Open Binary Container

Opens the selected .xclbin file to display the Platform Diagram and the System Diagram for the build.

Open Directory

Specifies a directory to open. The tool recursively examines the contents of the directory and displays a dialog box allowing you to select which type of files to open and which individual files to open.

The vitis_analyzer command allows you to open the tool to the home screen, as discussed above, or specify a file to load when opening the tool. You can open a file by specifying the name of the file to open. You can open the Vitis analyzer with any of the files supported by the tool, as described in Working with Reports. For example:

vitis_analyzer project1.run_summary

You can access the command help for vitis_analyzer command by typing the following:

vitis_analyzer -help