Viewing Guidance in the Vitis IDE - 2025.2 English - UG1076

AI Engine Tools and Flows User Guide (UG1076)

Document ID
UG1076
Release Date
2025-11-20
Version
2025.2 English

Use design guidance to evaluate performance. The guidance highlights design areas where performance tuning is recommended. In the Vitis IDE, you can view the design guidance generated by the tool as follows:

  1. Open the run summary file, xrt.run_summary, with the following command:
    vitis -a xrt.run_summary
  2. In the IDE, click Run Guidance in the summary view to view guidance information.
  3. Run Guidance shows recommended predefined threshold values and actual results from the design under review.
  4. Click the guidance name for a more detailed description of the guidance rule. For example, clicking AIE_MEMORY_CONFLICTS displays the following description:
    The rule checks the amount of memory conflicts for AI Engine tiles
  5. Adjust the predefined values by clicking the predefined value shown in blue and update with the preferred value. This filters out rules in the guidance view for the design.
  6. Click the percentage value of the guidance rule to open the Profile Summary of the design.
  7. Click the highlighted hyperlink. The tool provides guidance resolution to help improve design performance.