Quartus® Prime Pro Edition User Guide: Scripting

ID 683432
Date 9/29/2025
Public
Document Table of Contents

4.1.31.44. qed::run_dvrs (::quartus::qed)

The following table displays information for the qed::run_dvrs Tcl command:

Tcl Package and Version

Belongs to ::quartus::qed

Syntax qed::run_dvrs [-h | -help] [-long_help] -dvrs <dvrs> [-dvr_folder <dvr_folder> ] [-generate_recommendations] [-validate_recommendations] [-new_id_pattern <new_id_pattern> ] [-new_revision_pattern <new_revision_pattern> ] <group>
Arguments -h | -help Short help
-long_help Long help with examples and possible return values
-dvrs <dvrs> List of DVR IDs to run
-dvr_folder <dvr_folder> Name of the DVR folder to put the resulting reports
-generate_recommendations Flag to generate recommendations for every DVR.
-validate_recommendations Flag to validate all DVR recommendations. For each recommendation, a new group of projects will be forked and modified. The compilation results are then compared against the baseline.
-new_id_pattern <new_id_pattern> Pattern for the ID for any QED objects created during validation. \"%ORIGINAL_ID%\" will be replaced with the original object's ID. \"%DVR_ID%\" and \"%RECOMMENDATION_ID%\" will also be replaced accordingly.
-new_revision_pattern <new_revision_pattern> Pattern for the ID for any QED objects created during validation. \"%ORIGINAL_REVISION%\" will be replaced with the original revision. \"%DVR_ID%\" and \"%RECOMMENDATION_ID%\" will also be replaced accordingly.
<group> Identifier associated with the baseline group to analyze
Description
Invokes one or more Design Variant Recommendations (DVRs) on a group of connected & compiled projects.

Each DVR will make a set of recommendations for how to modify the projects in the provided group to
improve the results that the DVR is specialized to target.

The "-validate_recommendations" flag may be used to automatically fork the group of projects in
accordance with each recommendation that a DVR issues, modify the projects in accordance with that
recommendation, and then compile them and measure the results to compare back against the original
group. This flow can be extremely compute-intensive.

If a DVR fails to identify any recommendations for a given set of projects, it is considered
'disengaged' and no validation process will proceed.
Example Usage
    qed::run_dvrs -dvrs [qed::get_dvrs] -motivation_folder "Run #1"
Return Value Code Name Code String Return
TCL_OK 0 INFO: Operation successful