QoR Suggestion Report - 2025.2 English - UG906

Vivado Design Suite User Guide: Design Analysis and Closure Techniques (UG906)

Document ID
UG906
Release Date
2025-12-10
Version
2025.2 English

The QoR Suggestions report includes two main sections:

  • Summary Section: Displays a list of all suggestions, grouped by category.
  • Details Section: Provides additional information about each suggestion, organized by analysis type.
Figure 1. Example report_qor_suggestions Report

The top section, labeled Suggestion Report, categorizes suggestions into four groups, arranged in two pairs:

  • GENERATED and EXISTING
    GENERATED
    Suggestions created during the current stage of the flow.
    EXISTING
    Suggestions from earlier stages or imported from an .rqs file.
  • APPLIED and FAILED TO APPLY
    APPLIED
    Suggestions that are enabled, valid for the current stage, and successfully applied.
    FAILED TO APPLY
    Suggestions that are enabled and valid for the stage but could not be applied. Check the log file to understand the failure reason.

The Details Section at the bottom of the report provides category-specific analysis. Vivado uses report_qor_suggestions to evaluate your design across the following areas:

  • Clocking
  • Congestion
  • Utilization
  • Timing
  • Netlist
  • XDC
  • Strategy

Working with Suggestions

When reviewing GENERATED suggestions, the details section explains why each suggestion appears. You can use the following cross-probing methods to explore the design:

  1. Select objects to highlight them in other windows such as Device view
  2. Press F4 to open a schematic of the selected objects
  3. Right-click objects to generate a timing report

For EXISTING suggestions, cross-probing might not be available if the objects were removed by commands such as opt_design.

Additional Information Columns

Each suggestion includes extra attributes to help you understand its context and application:

Table 1. Additional Information Columns
Attribute Values Description
GENERATED_AT Design stage (for example, opt_design) Stage at which the suggestion was generated.
APPLICABLE_FOR Design stage (for example, opt_design) Stage which must be rerun with the suggestion enabled.
SOURCE An RQS file, or current_run if the suggestion was generated in the current run. Where the suggestion source is.
AUTOMATIC Yes, No Describes if Vivado tools can automatically execute the suggestion or it is a manual suggestion.
SUGGESTION_SCOPE GLOBALSCOPE, OOC top module Used to enable OOC synthesis to automatically scope synthesis suggestions.