report_routing_stats

report_routing_stats 
[ -set d_setObj | -net {s_netName…} ] 
[ -file s_fileName ] 
[ -summary ] 
[ -subtotals [ -silent] ]

Description

Generates a report on the nets in the given list or set, or the entire design. The report is output to the console, Transcript area and, optionally, to a file. The following information is included:

• Routing Summary
  Includes the number of nets, routes and guides found and the percentage of routing that has been completed.
• Routing History
• Layer Details
  Reports by layer down-via counts, the lengths for guides, and detail and global routes by direction.

You can optionally create an environment variable package containing the statistics (-subtotals).

The GUI equivalent for this command is Report—Routing Statistics.

Arguments

-file s_fileName	Specifies a file to output the routing statistics to. By default, no file is created.
-net {s_netName…}	Limits reporting to the nets in the given list. The Routing Summary and Layer Details for the nets in the list are output. By default, all nets are reported.
-set d_setObj	Limits reporting to the nets in the given set. The Routing Summary and Layer Details for the nets in the set are output. By default, all nets are reported.
-silent	Suppresses all console and log file output. This is useful to streamline processing when running scripts.
-subtotals	Creates an environment variable package containing the statistics for the entire design. For information about the environment variable package, see Reading Statistics from an Environment Variable Package.
-summary	Outputs only the Routing Summary. If no arguments are given, the Routing Summary, Routing History, and Layer Details for the entire design are all output.

Reading Statistics from an Environment Variable Package

When you use the -subtotals argument, an environment variable package is created that contains the statistics for the entire design. The package contains two child packages, count and stats.

Child Environment Variables	Type	Description
count.nets	IntegerEnv	Number of nets
count.routes	IntegerEnv	Number of routes
count.guides	IntegerEnv	Number of guides
count.completion_pct	RealEnv	% Routing Completed
stats.wire_length	RealEnv	Total wire length (by layer)
stats.detail_horiz_length	RealEnv	Total horizontal detail length (by layer)
stats.global_horiz_length	RealEnv	Total horizontal global length (by layer)
stats.detail_vert_length	RealEnv	Total vertical detail length (by layer)
stats.global_vert_length	RealEnv	Total vertical global length (by layer)
stats.guide_count	IntegerEnv	Number of guides (by layer)
stats.down_vias	IntegerEnv	Number of down vias (by layer)
stats.guide_down_vias	IntegerEnv	Number of guide down vias (by layer)

For example, to access the data given layers metal1, metal2 and metal3, use the following:

set net_count [getvar -cmd report_routing_stats count.nets]
set route_count [getvar -cmd report_routing_stats count.routes]
set guide_count [getvar -cmd report_routing_stats count.guide_count]
set completed_pct [getvar -cmd report_routing_stats count.completion_pct]
set metal1_length [getvar -cmd report_routing_stats stats.metal1.wire_length]
set metal2_down_vias [getvar -cmd report_routing_stats stats.metal2.down_vias]

Examples

The following example requests routing statistics and shows the output.

report_routing_stats

Nets       =    8458   Routes =    29222   Guides =        0
Completion = 100.00%
| ROUTING HISTORY ==============
|        Pass        |         |
| Name         | No. | Max Mem |
|------------------------------|
| GRoute       |   1 |    72.3 |
| GRoute       |   2 |    72.3 |
| GRoute       |   3 |    72.3 |
| GRoute       |   4 |    72.3 |
|------------------------------|

= LAYER DETAILS
========================================================================================
|        |   |      Total |     Horizontal   |     Vertical     | Guide |   Down Vias  |
|  Layer |Dir|     Length |    Detail |Global|     Detail|Global| Length| Total | Guide|
|--------------------------------------------------------------------------------------|
|  met1  | H |   45223.77 |  44390.36 | 0.00 |    833.41 | 0.00 |  0.00 |     0 |    0 |
|  met2  | V |  193789.39 |   7112.48 | 0.00 | 186676.91 | 0.00 |  0.00 | 27803 |    0 |
|  met3  | H |  325697.86 | 318464.60 | 0.00 |   7233.26 | 0.00 |  0.00 | 23392 |    0 |
|  met4  | V |  306787.93 |   1987.13 | 0.00 | 304800.80 | 0.00 |  0.00 |  8265 |    0 |
|  met5  | H |  254937.34 | 254694.66 | 0.00 |    242.68 | 0.00 |  0.00 |  3205 |    0 |
|--------------------------------------------------------------------------------------|
| Totals |   | 1126436.29 | 626649.23 | 0.00 | 499787.06 | 0.00 |  0.00 | 62665 |    0 |
| Percent|   |     100.00 |     55.63 | 0.00 |     44.37 | 0.00 |  0.00 |       |      |
========================================================================================

Related Topics

Report Commands

Return to top