report_partitions (::quartus::sta)

Tcl Package and Version

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 is 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.

Tcl Package and Version	Belongs to ::quartus::sta 1.0
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 is 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.