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

unclone_via

unclone_via 
{-set d_setObj 
| -all [ true | false ] 
| {-violators 
  [ -rules {s_ruleName } ] 
  [ -expansion_distance f_userunit ] 
  [ -max_vias_per_violation i_count ]}} 
[ -uncloned_set d_setObj ] 
[ -ignore_active_route_status [ true | false ] ] 
[ -lib s_libName -cell s_cellName -view s_viewName ] 
[ -silent [ true | false ] ] 

Description

Reverts remastered vias to their original masters.

unclone_via reverts vias that were remastered in the current session. To use this command in a later session for remastered vias in the design, you must set the environment variable, db.save_original_via_master_property, to true prior to saving the design with the newly remastered vias, and again before opening the saved view. Setting this variable before saving the design causes the original via properties to be saved for each remastered via, and setting the variable before opening the saved design causes those properties to be loaded when the design is reopened.

setvar db.save_original_via_master_property true

You can optionally replace remastered vias with the via given by the lib, cell, and view arguments.

Arguments

-all [ true | false ]

When true, reverts all remastered vias to their original masters.

-expansion_distance f_userunit

Distance to expand the Mentor Graphics® Calibre® error bounding box so that it overlaps the violating via. The default is 0.0.

-ignore_active_route_status [ true | false ]

Reverts vias on fixed routes. By default, these vias are skipped.

-lib s_libName -cell s_cellName -view s_viewName

(Optional) Specifies the library, cell and view of the replacement via.

This option replaces all vias in the specified set with the given via.

-max_vias_per_violation i_count

Specifies the maximum number of vias to revert for each processed Calibre violation if more than one remastered via overlaps the error bounding box. By default, only one via is processed per Calibre violation.

-rules {s_ruleName }

Restricts processing of Calibre errors to the given rules. If not specified, all rules are processed.

-set d_setObj

Specifies the set that contains the remastered vias to revert.

-silent [ true | false ]

When true, outputs only essential messages. By default and when false, additional status messages are output.

-uncloned_set d_setObj

Puts all reverted vias into this set. Can be used only with the -violators argument.

-violators

Reverts any remastered vias that cause violations as reported by the checker or a Calibre error file. You must run the check commands and/or load the Calibre files prior to using this command.

Value Returned

i_count

Is the total number of remastered vias that are reverted.

-1

The command failed due to a syntax error.

Examples

The following example reverts remastered vias in the selected set to their original master vias.

unclone_via -set [get_selection_set]

Related Topics

Optimize Commands

map_redundant_via

remaster_via


Return to top
 ⠀
X