find_by_area

find_by_area 
-region {f_xlo f_ylo f_xhi f_yhi} 
[ -single ] 
[ -set d_setObj | -window_id i_windowID ] 
[ -fully_enclosed ]

Description

Finds a set of objects in a given area of a specified set or window. You can specify additional criteria including whether the return objects must be fully enclosed in the search area, and whether to return a single object.

When searching for a single object, only the first object found that matches the search criteria is returned. Space-based Router uses the following order when searching for objects: nets (highest level), routes and vias, other shapes (lowest level).

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

Only objects that are marked visible and active in the Layer Object Display Panel are searched.

Arguments

-region {f_xlo f_ylo f_xhi f_yhi}
	Specifies the lower-left (f_xlo, f_ylo) and the upper-right (f_xhi, f_yhi) bounding box coordinates for the search area.
-single	Specifies that the search be terminated when the first object matching the criteria is found. When not specified, all matching objects are included in the output set.
-set d_setObj	Limits the search to instances in the specified set.
-window_id i_windowID	Limits the search to objects in the top cellview of the specified window.
-fully_enclosed	Limits the search to objects that are fully enclosed in the search area. When not specified, all objects that are at least partially inside the search area are considered by the search routine.

Value Returned

d_setObj

Specifies the Open Access set identifier for the set containing the objects matching all the specified criteria.

Examples

The following example returns a set containing any active and visible objects that are at least partially inside the given area of window 1.

find_by_area -region {100.1 100.1 150.4 18.80} -window_id 1

The following example creates a set, identified by Tcl variable aset1, that contains the first active and visible object from set aset that is completely inside the given area.

set aset1 [find_by_area -region {2031.2 2130.5 2190.8 2156.7} -single -fully_enclosed -set $aset]

Tcl set variables can be passed to other Space-based Router commands that use the -set argument.

Related Topics

Edit Commands

Manipulate Sets

Return to top