Step 1: Generating an ML Strategy RQS File - 2025.1 English - UG938

Vivado Design Suite Tutorial: Design Analysis and Closure Techniques (UG938)
Document ID
UG938
Release Date
2025-06-16
Version
2025.1 English
This step shows the process of opening a routed design with QoR suggestions and generating a new RQS file with strategies. For details on the design, refer to Step 1: Understanding the Design.
  1. In the Vivado Design Suite, source the Tcl file using the command to create the project and run the implementation flow.
    source <extract_Dir>/Lab3/tcl/create_project.tcl
  2. In the Flow Navigator, click Open Implemented Design.
  3. From the pull-down menus, select Reports > Report QoR Assessment, and click OK.
  4. In the RQA Summary table, you see the QoR Assessment Score and Flow Guidance. This table helps identify optimal candidate designs that can effectively leverage ML strategy suggestions. QoR assessment scores of three and above have a chance to meet timing. Designs with an RQA score of less than three are not prevented from generating ML strategies.
  5. Click ML Strategy Availability. This table details the required directives for the reference run to generate strategies.

    The status for all directives must be listed as OK to generate strategies. The requirements are as follows:

    • The opt_design directive value must be either Default or Explore.
    • The place_design, phys_opt_design, and route_design conditions must be the same as each other and must be set to either Default or Explore.
  6. In the Design Runs window, confirm the strategy is Vivado Implementation Defaults. This requirement is met when a design has been run with either the Vivado implementation defaults or the performance_explore strategy.
  7. From the pull-down menus, select Reports > Report QoR Suggestions, and click OK.
  8. In the QoR suggestion report, select GENERATED. Three new strategies have been generated.
    Generated by Your Tool
  9. In the Strategy section, select the topmost strategy. Here, you can see the details of the strategy being suggested. It is possible to set these up manually, but to automate the process more easily, the recommended flow is to read an RQS file containing strategies and set the directive to RQS on the implementation commands.
    Generated by Your Tool
  10. Select Write Suggestions to write the following files:
    • A top-level RQS file that does not contain strategies (this file can be ignored)
    • An RQS file for each strategy as well as any other QoR suggestions (written to the MLStrategy directory).

    Generating the strategy RQS files is the first part of a two-step process. This way of generating the suggestions gives complete control over what other suggestions are in the RQS file. Other ways to generate these files are as follows:

    • Automatic generation using AUTO_RQS flow (as seen in Using Report QoR Suggestions and Report QoR Assessment for Timing Closure).
    • Clicking Generate ML Strategies from the right-click menu in the Design Runs window.
    • Automatic generation at the end of Stage 1: Design Optimization of Intelligent Design Runs.
    • A post-route Tcl hook script that calls both report_qor_suggestions and write_qor_suggestions.