Intel® Quartus® Prime Pro Edition User Guide: Scripting

ID 683432
Date 6/20/2022
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents

3.1.34.8. get_keepers (::quartus::sdc_ext)

The following table displays information for the get_keepers Tcl command:

Tcl Package and Version

Belongs to ::quartus::sdc_ext

Syntax get_keepers [-h | -help] [-long_help] [-no_duplicates] [-nocase] [-nowarn] [ <filter> ]
Arguments -h | -help Short help
-long_help Long help with examples and possible return values
-no_duplicates Do not match duplicated keeper names
-nocase Specifies the matching of node names to be case-insensitive
-nowarn Do not issue warning messages about unmatched patterns
<filter> Valid destinations (string patterns are matched using Tcl string matching)
Description
Returns a collection of non-combinational or "keeper"
nodes in the design.

The default matching scheme returns not only
non-combinational nodes whose names match the
specified filter, but also non-combinational nodes
duplicated from these keepers (refers to cells are
automatically generated by Quartus from these
keepers).  Use the -no_duplicates option to exclude
duplicated keepers.

The filter for the collection is a Tcl list of
wildcards, and must follow standard Tcl or
Timing Analyzer-extension substitution rules. See help for
the use_timing_analyzer_style_escaping command for details.
Example Usage
project_open chiptrip
create_timimg_netlist

set kprs [get_keepers *reg*]
foreach_in_collection kpr $kprs {
    puts [get_object_info -name $kpr]
}

delete_timing_netlist
project_close
Return Value Code Name Code String Return
TCL_OK 0 INFO: Operation successful
TCL_ERROR 1 ERROR: Timing netlist does not exist. Use create_timing_netlist to create a timing netlist.