Product Documentation
Virtuoso Layout Suite SKILL Reference
Product Version IC23.1, November 2023

leFlattenInst

leFlattenInst(
d_instId 
x_levels 
[ g_flattenPCells ]
[ g_preservePins ]
[ g_preserveRODobjs ]
[ g_delDetachedBlockages ]
[ g_preservePinFigs ]
[ g_flattenVias ]
[ g_preserveTermName ]
[ t_excludePcellListFileName ]
) 
=> t / nil

Description

Flattens instance d_instId up through x_levels of hierarchy. The optional arguments are positional: you must specify nil for optional arguments prior to an optional argument you want to specify. For example, if you do not want to specify g_flattenPCells, but want to set g_preservePins to t, you need to specify both (nil t).

In color-aware designs, effective coloring on both locked and unlocked shapes is preserved. However, if the coloring engine is enabled during flattening, unlocked shapes might be recolored after flattening is completed.

Arguments

d_instId

The database ID of the instance to flatten.

x_levels

Number of levels of hierarchy through which to flatten the instance.

Valid Values: an integer between 0 and 32

g_flattenPCells

Specifies whether parameterized cells are flattened.

Default Value: nil

Valid Values: t or nil

g_preservePins

Specifies whether pin connectivity information is preserved.

Default Value: nil

Valid Values: t or nil

g_preserveRODobjs

Specifies whether ROD properties are preserved.

Default Value: nil

Valid Values: t or nil

g_delDetachedBlockages

Specifies whether detached blockages are preserved.

Default Value: nil

Valid Values: t or nil

g_preservePinFigs

Specifies whether geometric information of the flatten pins is preserved.

Default Value: t

Valid Values: t or nil

g_flattenVias

Specifies whether vias are flattened.

Default Value: t

Valid Values: t or nil

g_preserveTermName

Specifies whether terminal name of the flatten pins is preserved.

Default Value: nil

Valid Values: t or nil

t_excludePcellListFileName

Specifies the name of the file that contains the list of Pcells that should not be flattened.

Default Value: ""

Value Returned

t

The instance is flattened.

nil

The instance is not flattened.

Example

Flattens the instance instance1 through two levels of the hierarchy but does not flatten any parameterized cells contained in the instance.

leFlattenInst( instance1 2 nil )

Interactive Function

Enter this function with only the window ID argument; the system prompts you to point to the instance to flatten and specify the number of levels through which to flatten it. If you do not specify w_windowId, the current window is used.

leHiFlatten( [ w_windowId ] ) => t / nil


Return to top
 ⠀
X