Working with Reports

Generally, the Compile Summary, Link Summary, and Run Summary reports provide you 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 kernels, start with the Compile Summary. For the FPGA binary (xclbin), start with the Link Summary, which also loads the Compile Summaries for included kernels. For profiling data related to the application execution start with the Run Summary.

In addition, the File menu offers commands to let you open individual reports, and directories of reports.

Figure 1: Open Directory
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.
Open Binary Container
FPGA binary, <name>.xclbin, created by the compilation and linking process as described in Building and Running the Application.
Open Report
Opens one of the report files generated by the Vitis core development kit during compilation, linking, or running the application. The reports you can open include:
Application Timeline
Refer to Application Timeline.
Profile Summary
Refer to Profile Summary Report.
Waveform database and waveform config file as described in Waveform View and Live Waveform Viewer.
A resource utilization report generated by the Vivado® tool when you build the system hardware (HW) target.

The Vitis analyzer can also open Kernel Estimate, Operation Trace, Low Overhead Profile 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 Vitis analyzer displays log files rendered for improved readability. Some key additions the tool provides when viewing log files include line wrapping, message severity tagging (Error, Warning, Info), added hyperlinks to referenced files, search capability, and live log monitoring. This last feature lets you open a log file in-process and see it rendered in real time.

Viewing Report Contents

The features of the Vitis analyzer depend on the specific report you are viewing. When the report is structured like a spreadsheet you interact with the report like a spreadsheet, selecting rows or cells of data, and sorting columns by clicking on the column header. When the report is graphical in nature, you can interact with the report by zooming into the report to view details, and zooming out to view more information. The Vitis analyzer supports the following mouse strokes to let you quickly zoom into and out of a graphical report:

Zoom In
Press and hold the left mouse button while dragging the mouse from top left to bottom right to define an area to zoom into.
Zoom Out
Press and hold the left mouse button while drawing a diagonal line from lower left to upper right. This zooms out the window by a variable amount. The length of the line drawn determines the zoom factor applied. Alternatively, press Ctrl and scroll the wheel mouse button down to zoom out.
Zoom Fit
Press and hold the left mouse button while drawing a diagonal line from lower right to upper left. The window zooms out to display the entire device.
Horizontal scrolling
In a report such as the Application Timeline, you can hold the shift button down while scrolling the middle mouse roller to scroll across the timeline.
Press and hold the wheel mouse button while dragging to pan.