Product Documentation
Virtuoso Space-based Router Command Reference
Product Version IC23.1, September 2023

report_via_stats

report_via_stats
[ -window_id i_windowID ] 
[ -all | -region {f_xlo f_ylo f_xhi f_yhi} | -set d_setObj ] 
[ -do_via_layers {s_layerName …} ] 
[ -exclude_set d_setObj ] 
[ -exclude_net {s_netName …} ] 
[ -exclude_type {[power] [ground] [clock]} ] 
[ -exclude_via_pin [ true | false ] ] 
[ -output_pins_only [ true | false ] ] 
[ -report_level {summary | basic | detail} ] 
[ -file s_fileName ] 
[ -show_all_columns [ true | false ] ]

Description

Outputs statistics for vias in a set or the selected set, within a given region or in the entire design to the Transcript area, and optionally to a file. If the cutClass constraint is defined, the report includes a cut class name column for each cut count group.

To properly report larger enclosure single-cut via counts, the minDualExtension constraint must be set.

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

Arguments

-all

Sets the target area to the entire cellview.

-do_via_layers {s_layerName …}

  

Limits the output to the via layers in the given list. If this argument is not specified, all via layers are reported.

-exclude_net {s_netName …}

Specifies the names of nets to exclude from reporting.

-exclude_set d_setObj

Excludes from reporting vias, routes and nets in the given set.

-exclude_type {[power][ground][clock]}

Specifies one or more net types to exclude from reporting.

-exclude_via_pin [ true | false ]

Excludes via pins (top level only) from the report. By default, both via detail and via pins are included.

-file s_fileName

Outputs the via information to the given file. By default, no file is created.

-output_pins_only [ true | false ] ]

Limits processing to vias on output pins.

Default: false

-region {f_xlo f_ylo f_xhi f_yhi}

  

Limits reporting to vias only in the specified area of the cellview, given by the lower left and upper right coordinates.

-report_level {summary | basic | detail}

Controls the amount of detail to include in the summary:

summary

Reports the number of vias for each layer, grouped by the number of cuts and whether they are minimum enclosure or larger enclosure. This is the default.

basic

Reports summary information and subgroups vias on each layer by enclosure dimensions.

detail

Reports basic information and subgroups vias on each layer by via master.

-set d_setObj

Reports only vias in the specified set. If no target area or set is specified, the command operates on the vias in the selected set.

-show_all_columns [ true | false ]

If true, each cut count is reported separately. By default or if false, results are broken down as 1-cut, 2-cut, 3-cut, 4-cut and greater than 4-cut (vias with greater than 4 cuts are consolidated into one column).

-window_id i_windowID

Specifies the window to process. If this argument is not specified, the active artwork window is used.

Examples

The following is an example of a summary via report.

# Design:  tdsp_library/tdsp/layout
 Date:  Fri Feb 03 2006    Time:  13:05:44
 Elapsed Time:  0.1 seconds     Memory Usage:  0.0 MB
remaster_via completed in = 0.1s (elapsed), using 0.1s/0.0s/0.1s (user/kernel/total CPU).
+----------------------------------------------------------+
|Layer|Count|         1-cut         |        2-cut         |
|     |     |       Enclosure       |      Enclosure       |
|     |     |     Min    | Larger   |    Min    |  Larger  |
+----------------------------------------------------------+
|Via1 |   69| 22  (31.9%)|0   (0.0%)|47  (68.1%)|0   (0.0%)|
|Via2 |   81| 81 (100.0%)|0   (0.0%)| 0   (0.0%)|0   (0.0%)|
|----------------------------------------------------------|
|Total|  150|103  (68.7%)|0   (0.0%)|47  (31.3%)|0   (0.0%)|
+----------------------------------------------------------+

The following is an example of a basic via report.

# Design:  tdsp_library/tdsp/layout
 Date:  Fri Feb 03 2006    Time:  13:06:05
 Elapsed Time:  0.0 seconds     Memory Usage:  0.0 MB
report_via_stats completed in = 0.0s (elapsed), using 0.0s/0.0s/0.0s (user/kernel/total CPU).
+--------------------------------------------------------------------------+
|Layer|   Enclosure   |Count|         1-cut         |        2-cut         |
|     | (Lower Upper) |     |       Enclosure       |      Enclosure       |
|     |               |     |     Min    |  Larger  |    Min    |  Larger  |
+--------------------------------------------------------------------------+
|Via1 |               |   69| 22  (31.9%)|0   (0.0%)|47  (68.1%)|0   (0.0%)|
|     |0.4x0.4 0.4x0.4|   22| 22 (100.0%)|0   (0.0%)| 0   (0.0%)|0   (0.0%)|
|     |0.4x0.9 0.4x0.9|   24|  0   (0.0%)|0   (0.0%)|13  (54.2%)|0   (0.0%)|
|     |0.9x0.4 0.9x0.4|   23|  0   (0.0%)|0   (0.0%)|13  (56.5%)|0   (0.0%)|
|     |0.4x0.9 0.4x0.9|   24|  0   (0.0%)|0   (0.0%)|11  (45.8%)|0   (0.0%)|
|     |0.9x0.4 0.9x0.4|   23|  0   (0.0%)|0   (0.0%)|10  (43.5%)|0   (0.0%)|
|Via2 |               |   81| 81 (100.0%)|0   (0.0%)| 0   (0.0%)|0   (0.0%)|
|     |0.4x0.5 0.4x0.4|   21|  9  (42.9%)|0   (0.0%)| 0   (0.0%)|0   (0.0%)|
|     |0.4x0.4 0.4x0.4|   60| 60 (100.0%)|0   (0.0%)| 0   (0.0%)|0   (0.0%)|
|     |0.4x0.5 0.4x0.4|   21| 12  (57.1%)|0   (0.0%)| 0   (0.0%)|0   (0.0%)|
|--------------------------------------------------------------------------|
|Total|               |  150|103  (68.7%)|0   (0.0%)|47  (31.3%)|0   (0.0%)|
+--------------------------------------------------------------------------+

The following is an example of a detail via report.

# Design:  tdsp_library/tdsp/layout
 Date:  Fri Feb 03 2006    Time:  13:06:12
 Elapsed Time:  0.0 seconds     Memory Usage:  0.0 MB
report_via_stats completed in = 0.0s (elapsed), using 0.0s/0.0s/0.0s (user/kernel/total CPU).
+-------------------------------------------------------------------------------+
|Layer|Via Master|   Enclosure   |Cnt|        1-cut        |       2-cut        |
|     |          | (Lower Upper) |   |     Enclosure       |     Enclosure      |
|     |          |               |   |   Min    |  Larger  |    Min   |  Larger |
+-------------------------------------------------------------------------------+
|Via1 |          |               | 69|22 (31.9%)|0   (0.0%)|47 (68.1%)|0  (0.0%)|
|     |M2M1      |0.4x0.4 0.4x0.4| 22|        22|         0|         0|         |
|     |M2M1_north|0.4x0.9 0.4x0.9| 13|         0|         0|        13|        0|
|     |M2M1_west |0.9x0.4 0.9x0.4| 13|         0|         0|        13|        0|
|     |M2M1_south|0.4x0.9 0.4x0.9| 11|         0|         0|        11|        0|
|     |M2M1_east |0.9x0.4 0.9x0.4| 10|         0|         0|        10|        0|
|Via2 |          |               | 81|81(100.0%)|0   (0.0%)| 0  (0.0%)|0  (0.0%)|
|     |Via23south|0.4x0.5 0.4x0.4|  9|         9|         0|         0|        0|
|     |M3M2      |0.4x0.4 0.4x0.4| 60|        60|         0|         0|        0|
|     |Via23north|0.4x0.5 0.4x0.4| 12|        12|         0|         0|        0|
|-------------------------------------------------------------------------------|
|Total|          |               |150|103(68.7%)|0   (0.0%)|47 (31.3%)|0  (0.0%)|
+-------------------------------------------------------------------------------+

Related Topics

Report Commands


Return to top
 ⠀
X