Get a list of available QoR suggestions
Syntax
get_qor_suggestions [‑filter <arg>] [‑quiet] [‑verbose] [<IDs>]
Returns
List of qor suggestion objects.
Usage
Name | Description |
---|---|
[-filter]
|
Filter list with expression |
[-quiet]
|
Ignore command errors |
[-verbose]
|
Suspend message limits during command execution |
[<IDs>]
|
Match suggestion names against given names |
Categories
Description
Get existing QoR suggestion objects created by the report_qor_suggestions
command, or read into the design using read_qor_suggestions
. The selected QoR objects can be written to a file using the write_qor_suggestions
command. The suggestions created by the report command remain in memory until delete_qor_suggestions
is run, or until it is overwritten by another report.
This command returns a list of existing QoR suggestion objects from the open design, or returns an error if it fails.
Arguments
-filter <arg>
- (Optional) Filter the returned suggestion objects with the specified expression. The -filter
argument filters the list of objects returned by the command based on property values on the objects. You can find the properties on an object with the report_property
or list_property
commands. In the case of the qor_suggestion object, ENABLED, CATEGORY, and AUTO are a few of properties you might use to filter the list of suggestions.
-quiet
- (Optional) Execute the command quietly, returning no messages from the command. The command also returns TCL_OK regardless of any errors encountered during execution.
-verbose
- (Optional) Temporarily override any message limits and return all messages from this command.
set_msg_config
command.<IDs> - (Optional) Specify a list of QoR suggestion IDs to select the specified objects.
Examples
To return an individual suggestion, you can supply the full ID:
get_qor_suggestions RQS_CLOCK-5_1-1
You can also filter suggestions objects within a given category. Available categories include: Timing, Congestion, Utilization, XDC, Clocking, and Strategy. For example, the following returns suggestions related to the Timing category:
get_qor_suggestions -filter {CATEGORY==Timing}
To generate a list of suggestion objects that have been applied in the current run:
get_qor_suggestions -filter {APPLIED}
To view the Tcl command associated with the RQS_UTIL-4-1 suggestion:
get_property COMMAND [get_qor_suggestions RQS_UTIL-4-1]
To view all suggestions that requires opt_design rerun to apply them:
set suggs [get_qor_suggestions -filter {APPLICABLE_FOR==opt_design}]