Intel® Quartus® Prime Pro Edition User Guide: Scripting

ID 683432
Date 10/04/2021

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

Document Table of Contents report_partitions (::quartus::sta)

The following table displays information for the report_partitions Tcl command:

Tcl Package and Version

Belongs to ::quartus::sta

Syntax report_partitions [-h | -help] [-long_help] [-append] [-file <name> ] [-from_clock <names> ] [-nworst <number> ] [-panel_name <name> ] [-stdout] [-to_clock <names> ]
Arguments -h | -help Short help
-long_help Long help with examples and possible return values
-append If output is sent to a file, this option appends the result to that file. Otherwise, the file will be overwritten. This option is not supported for HTML files.
-file <name> Sends the results to an ASCII or HTML file. Depending on the extension
-from_clock <names> Valid source clocks (string patterns are matched using Tcl string matching)
-nworst <number> Specifies the maximum number of paths to report between partitions. If unspecified, the limit defaults to 1000
-panel_name <name> Sends the results to the panel and specifies the name of the new panel
-stdout Send output to stdout, via messages. You only need to use this option if you have selected another output format, such as a file, and would also like to receive messages.
-to_clock <names> Valid destination clocks (string patterns are matched using Tcl string matching)

Reports timing information related to design partitions. The report_partitions command analyzes the worst 1000 failing setup paths in the design by default, but you can optionally set the nworst option to increase or decrease this number. The from_clock and to_clock arguments can be used to control how this function finds the paths to be analyzed. This function reports the number of failing paths within each partition and the worst-case slack of the paths that are entirely contained within a single partition in a Partition Timing Overview table. The function also creates a Partition Timing Details table that lists the number of failing paths and worst-case slack of paths that feed from one partition to another partition. This information provides more details on where the critical paths in the design are with respect to design partitions. The function also creates a Partition Timing Breakdown table. This table bins the worst failing paths by all partitions that the path spans, and reports the number of failing paths and worst case slack for each group of partitions. This report can be directed to the Tcl console ("-stdout", default), a file ("-file"), the Timing Analyzer graphical user interface ("-panel_name"), or any combination of the three.

Example Usage

project_open my_project

# Report a maximum of 500 failing paths between partitions to the
# Timing Analyzer graphical interface and to the Tcl console.
report_partitions -panel_name "Partition Timing Report" -nworst 500 -stdout
Return Value Code Name