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

find_net

find_net 
[ -name s_netExpr 
   [ -net_type {[signal][power][ground][clock][tieOff][tieHi][tieLo][scan][analog][all]} ] 
 | -inst s_instName [ -term s_termName ] 
 | -route_spec s_routeSpec ] 
[ -set d_setObj 
| -window_id i_windowID x
| -include_composite_nets [ true | false ] ] 
[ -ignore_case ] 
[ -no_wildcard ] 
[ -instance_path s_path ] 
[ -delimiter s_char ]
[ -silent ]

Description

Searches a particular window or an existing set of objects for one of the following:

If neither the -set argument nor the -window_id argument is specified, the scope of the search is the active window.

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

Arguments

-delimiter s_char

Specifies the hierarchical delimiter. If not specified, the default delimiter character for the active oaNamespace is used. A NULL string ("") can be specified to prevent the path from being decomposed and is useful for flattened designs. This option cannot be used with wildcards.

-ignore_case

Performs a case-insensitive search.

-include_composite_nets [ true | false ]

  

When set to true, includes composite nets in the search.

Default: false

-inst s_instName

Specifies the name of the instance. Searches for the net that connects to the given term of the instance if -term is specified; otherwise, searches for all the nets that connect to the instance.

-instance_path s_path

Specifies the instance path to the sub-occurrence.

-name s_netExpr

Finds all nets whose names match the expression or a space-delimited list of expressions. The expressions can include special characters described in Pattern Matching. If this argument is not included, then all nets within the specified scope are included in the resultant set.

-net_type

Finds all nets of the types specified.
Valid values include: signal, power, ground, clock, tieoff, tieHi, tieLo, scan, analog, and all.

-no_wildcard

Disables all wildcard processing. By default, wildcards can be used.

-route_spec s_routeSpec

Finds nets with the specified routespec.

-set d_setObj

Limits the search to nets in the specified set.

-silent

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

-term s_termName

Specifies a terminal name. Used with the -inst argument to search for the net that connects to the terminal of the given instance.

-window_id i_windowID

Limits the search to nets in the specified window.

Value Returned

d_setObj

Returns the identifier for a set containing all nets whose names matched the given expression for the given set or cellview.

Examples

The following example searches for any nets whose names contain the string RESULTS_CONV_INST_n. The resultant set of nets is stored in the Tcl variable net.

set net [find_net -cell_view_id 1 -net *RESULTS_CONV_INST_n*]

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 returns an unfolded shape.

setvar db.user_namespace def
find_net -instance_path fb_io/Fbd_data\\\[47\\\]_pad_macro -name j_ShiftDr -delimiter "" -no_wildcard

The following example highlights the net connected to the A0 term of the B_32_INST/i_9182/i_9187/i_217 instance.

add_highlight -color cyan -name termA -set [find_net -inst B_32_INST/i_9182/i_9187/i_217 -term A0]

Related Topics

Edit Commands

get_connected_net

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


Return to top
 ⠀
X