Intel® Quartus® Prime Pro Edition User Guide: Scripting

ID 683432
Date 9/26/2022
Public

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

Document Table of Contents

4.1.35.63. 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)
Description
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
create_timing_netlist
read_sdc
update_timing_netlist

# 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 Code String Return
TCL_OK 0 INFO: Operation successful
TCL_ERROR 1 ERROR: Design partitions are not supported in this project.