lntAddTrace

lntAddTrace(
w_window
{ d_figId | t_netName }
[ ?mode t_mode ]
[ ?hierPath l_hierPath ]
[ ?startLevel x_startLevel ]
[ ?stopLevel x_stopLevel ]
[ ?userArea l_userArea ]
[ ?hilightIncrementally g_hilightIncrementally ]
[ ?retainColornStateInfo g_retainColornStateInfo ]
[ ?hilightColor t_hilightColor ]
[ ?maxCutShapes t_maxCutShapes ]
[ ?constraintGroup t_constraintGroup ]
[ ?stackLayers l_stackLayers ]
)
=> x_traceId / nil

Description

Creates a trace starting from the specified figure or net name in the specified window.

Arguments

w_window	ID of the window in which the trace needs to be created.
t_mode	Specifies how the figures are looked for during tracing. Valid values: "physical", "logical" Physical mode strictly uses layer overlaps to determine connectivity. Logical mode uses net assignments.
d_figId	ID of the specified figure from which the trace will be created.
t_netName	Name of the specified net on which the trace will be created.
?hierPath l_hierPath
	Path in the hierarchy at which the trace needs to be created.
?startLevel x_startLevel
	The hierarchy level at which the trace will be started.
?stopLevel x_stopLevel
	The hierarchy level at which the trace will be stopped.
?userArea l_userArea
	Allows defining a region (polygon) that supports restricted tracing. Only those traces are created that have their starting figure inside the defined region.
?hilightIncrementally g_hilightIncrementally
	Controls whether the traced nets for connected shapes are highlighted in the increments of 10K shapes.
?retainColornStateInfo g_retainColornStateInfo
	Retains the color state and lock status information for the figure from which the trace is created.
?hilightColor t_hilightColor
	Specifies the color to be used for creating the trace. The default is "Cycle", which selects the next new color from the associated palette.
?maxCutShapes t_maxCutShapes
	Controls the maximum number of cut shapes that are traced per overlap. Choose from: Low – 100 cut shapes Medium – 1000 cut shapes High – 10000 Full – all cut shapes The default is Medium.
?constraintGroup t_constraintGroup
	Specifies the constraint group that defines the via layer, connected layer, and stop layers to be used for creating traces. Choose from virtuosoDefaultExtractorSetUp—the default constraint group used by the Layout XL connectivity extractor— or define a custom constraint group. The default is virtuosoDefaultExtractorSetUp.
?stackLayers l_stackLayers
	Specifies the start and end layers to narrow down to a smaller set of extractable layers to be used for tracing. The same layer can be used to define the start and end layer for tracing. This argument is useful when creating a big trace, such as for a power or ground net.

Value Returned

x_traceId	ID of the created trace.
nil	The trace could not be created.

Examples

win = hiGetCurrentWindow()

fig = css()

Uses the database ID of any valid figure — rect, path, pathSeg, circle, donut, ellipse or via for creating the trace.

fig2 = figId

//Database figure ID of the figure at depth 2.

netName = "n1" 

// Name of the net from which the trace will be created.

hp = ((db:0x3233c71c 0 0 0) (db:ox3cbc819a 0 0 0)) 

Uses the SKILL function geGetInstHierPath(win) to derive the hierarchical path of the instance.

lntAddTrace(win figId) => 1

Searches the edit cellview for the figure with the specified ID.

lntAddTrace(win netName)  => 2

Searches the edit cellview for the net with the specified name.

lntAddTrace(win fig2 ?hierPath hp) => 10

Uses the SKILL function from top to create a trace starting with the figure at hierarchy depth 2.

lntAddTrace(win n1 ?hierPath hp) => 10

Uses the SKILL function from top to create a trace starting with the net n1 from the cellview of the instance at hierarchy depth 2.

lntAddTrace(win fig ?stopLevel 20)  => 20

Creates a trace starting from the figure at depth 0 and goes up to depth 20.

lntAddTrace(win fig ?retainColornStateInfo t) =>21 

Retains the color and lock status of the chased figure.

lntAddTrace(win fig ?stopLevel 20 ?constraintGroup "myconstaintGroup) => 67

Uses the custom constraint group, "myconstaintGroup", to derive the layer rules to use for tracing.

lntAddTrace(win fig2) => nil 

Creates no trace because the figure to use is present at depth 2, and the hierarchical path to the figure is not supplied.

lntAddTrace(hiGetCurrentWindow() figId ?stackLayers list("Metal1" "Metal5"))

Traces shapes only on Metal1 and Metal5 layers.

lntAddTrace(hiGetCurrentWindow() figId ?stackLayers list("Metal1"))

Traces shapes only on Metal1 layer.

Related Topics

Tracing Nets

Return to top