Creating an Archive File - 2021.1 English

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

Document ID
UG1393
Release Date
2022-03-29
Version
2021.1 English

At times while developing your project, you might introduce changes in your host or kernel code that completely alters the contents or quality of the various build and run summaries produced by the tool. Your existing reports and analysis data are overwritten unless you manually save the relevant files. The Archive Summary command lets you save all relevant files with an open Link Summary or Run Summary.

Tip: This feature lets you quickly share design reports with other team members by sharing the archive summary.

Select File > Archive Summary menu command, or right-click a summary in the Report Navigator and select Archive Summary. This opens the Archive Summary dialog box as shown below.

Figure 1. Archive Summary Dialog Box

Archive file names must have the extension of link_summary.archive, or run_summary.archive to be recognized by the Vitis analyzer. The contents of the archive depend on the summary report being archived.

The contents of the Link Summary include these file extensions:

Binary container(s)
.xclbin
Kernel(s)
.xo
System/platform diagram
.json
System estimate
.xtxt
Guidance
.html, .pb
Timing summary
.rpt, .rpv
Utilization(s)
.xutil
HLS synthesis report
Report

The contents of the Run Summary include these file extensions:

System diagram
.run_summary
Platform diagram
.run_summary
Guidance
Not required, generated using via perf_analyze and the opencl_summary.csv
Profile summary
opencl_summary.csv
Application timeline
opencl_trace.csv
Waveform report
.wdb
Important: For AI Engine designs, when a run_summary contains a trace report but does not have an entry for the AI Engine work directory, Vitis analyzer cannot run hwanalyze to display the trace report. In this case, the tool prompts you for the location of the AI Engine compile_summary, and updates the run_summary file on disk. If you archive the run_summary before providing this location, you cannot view the trace report from the archived run_summary.

You can also choose to save the .xclbin file extension, any compiled kernel object file extensions (.o and .xo), and the original source file extensions (.cpp, .c, and .cl) used to generate the summary reports.

Tip: Guidance is not saved because this is dynamically generated by Vitis™ analyzer from opencl_summary.csv, and optionally profile_kernels.csv.
To open an existing archive file, use the File > Open Summary command and browse for the archive file. You can also open an archive file when launching Vitis analyzer:
vitis_analyzer design.archive
There is also a command line form of Archive Summary that you learn more about with:
archive_summary -help
Note: The Vitis analyzer archive is a compressed archive that can be uncompressed to access the individual, including the xclbin and xo file when they are included in the archive.