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

find_instance_of

find_instance_of 
[ -lib s_libExpr ]
[ -cell s_cellExpr ]
[ -view s_viewExpr ]
[ -set d_setObj | -window_id i_windowID ] 
[ -find_radius f_userunit {-ref_pt {f_x f_y} | -ref_inst s_instName} ]
[ -exclude_vias ] 
[ -ignore_case ] 
[ -no_wildcard ]
[ -silent ]

Description

Searches a particular cellview or an existing set of objects for instances of master cellviews with names that match the given expressions. If neither the -set argument nor the -cell_view_id argument is specified, the scope of the search is the active cellview. You can define the area of the search using the -find_radius argument to search within a specific radius of an instance or a given coordinate.

The GUI equivalent for this command is Edit—Find (Instance).

Arguments

-cell s_cellExpr

Finds all instances whose master cell names match the expression. The expression can include special characters described in Pattern Matching. If this argument is not specified, then the resultant set will include instances with any master cell name.

-exclude_vias

Excludes vias from consideration. By default, vias are included.

-find_radius f_userunit

Searches for instances whose bounding box falls within the given radius (in microns) from a reference given by one of the following:

-ref_inst s_instName

Uses the bounding box of the given instance as the reference.

-ref_pt {f_x f_y}

  

Uses the given coordinate (in microns) as the reference.

-ignore_case

Performs a case-insensitive search.

-lib s_libExpr

Finds all instances whose master library names match the expression. The expression can include special characters described in Pattern Matching. If this argument is not specified, then resultant set will include instances with any master library name.

-no_wildcard

Disables all wildcard processing.

-ref_inst s_instName

Refer to the description for -find_radius.

-ref_pt {f_x f_y}

Refer to the description for -find_radius.

-set d_setObj

Limits the search to instances in the specified set.

-silent

Suppresses informational messages, such as the number of items found. By default, these messages are output.

-view s_viewExpr

Finds all instances whose master view names match the expression. The expression can include special characters described in Pattern Matching. If this argument is not specified, then the resultant set will include instances with any master view name.

-window_id i_windowID

Limits the search to instances in the specified window.

Value Returned

d_setObj

Returns the identifier for a set containing all instances that matched the lib/cell/view criteria for the given set or cellview.

Examples

The following example searches in the active window for any instances whose master cell names begin with the letters corner. The resultant set of instances is stored in the Tcl variable master.

set master [find_instance_of -cell corner*]

Tcl set variables can be passed to other Space-based Router commands that use the -set argument. For more information on set functions, refer to Manipulate Sets

The following example finds all BUFA1 cells within a 20 micron radius of the bounding box of inst_I2.

find_instance_of -cell BUFA1 -ref_inst inst_I2 -find_radius 20

Related Topics

Edit Commands

find_instance

get_midpoint

Examples of Tcl Core Commands and Virtuoso Space-based Router Commands


Return to top
 ⠀
X