Creating an Archive File - 2020.2 English

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

Document ID
UG1393
Release Date
2021-03-22
Version
2020.2 English

At times while developing your project, you might introduce changes in your host or kernel code that will completely alter the contents or quality of the various build and run summaries produced by the tool. Your existing reports and analysis data will be 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
Utilization(s)
.xutil
HLS synthesis report
Report

The contents of the Run Summary include these file extensions:

Run summary
.run_summary
System diagram
.run_summary
Platform diagram
.run_summary
Guidance
Not required, generated using via perf_analyze and the profile_summary.csv
Profile summary
profile_summary.csv
Application timeline
timeline_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 will prompt you for the location of the AI Engine compile_summary, and will update the run_summary file on disk. If you archive the run_summary before providing this location, you will not be able to 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 profile_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