mptLPPMergeToColor

mptLPPMergeToColor(
d_cellviewID
g_libName
g_viewName
l_mapping
[ g_colorState ]
)
=> t / nil

Description

Converts the layout into Virtuoso multi-pattern conformance format for designs that use two or more separate layer-purpose pairs to represent multi-patterning mask information, so that Virtuoso coloring engine can perform further operations on it. You can choose to write the conversion result into a different library or/and a different view. In this case, new cells with the same cell name and the library or/and view name that you specify are used. The original cell is not changed. If you choose to write the result to the same cell, the original layer-purpose pair data is removed. This function is performed on the entire hierarchy starting from the specified cell.

Net information and any previous mask coloring are not copied when output is to an existing cellview that is different from the source cellview.

Arguments

d_cellviewID	The database ID of the top-level cellview where the data conversion is to be started. When this function is applied, it covers the entire hierarchy tree and converts each cell as necessary.
g_libName	Library name. If this argument value is a string, the result is written to the library with this name. If the argument value is `nil`, the result is written to the same library. If the g_viewName argument is `nil` as well, the result is written to the same cell.
g_viewName	View name. If the argument value is a string, the result is written to the view with this name. If the argument value is `nil`, the result is written to the same view. If the g_libName argument is `nil` as well, the result is written to the same cell.
l_mapping	A list specifying the mapping of layer-purpose pair to color information. Each element in this list contains a list of four or more string values (depending on the number of masks), which are in this order: layer_name, result_purpose_name,and a color_`<`mask number`>`_purpose_name for each mask on the layer, in numeric order. A two-mask layer would have a list of four values, and a three-mask layer would have a list of five values.
g_colorState	Specifies the color state of the output layer-purpose pair. If `t`, the output layer-purpose pair will be color locked. If `nil` (the default), the output layer-purpose pair will not be color locked.

Values Returned

`t`	The data is converted.
`nil`	The data is not converted.

Examples

mptLPPMergeToColor( geGetEditCellView() nil nil list( list( "Metal1" "drawing" "dr1" "dr2" "dr3" ) )

The following tasks are performed for the three-mask Metal1 layer:

Hierarchically converts the layer-purpose-pair based multi-patterning design into Virtuoso standard multi-patterning data, starting from the cellview currently being edited.
Writes the result to the same cell.
Moves all shapes on (Metal1, dr1) to (Metal1, drawing) with color set to 1.
Moves all shapes on (Metal1, dr2) to (Metal1, drawing) with color set to 2.
Moves all shapes on (Metal1, dr3) to (Metal1, drawing) with color set to 3.
Shapes originally on (Metal1, drawing) will remain on (Metal1, drawing) with color set to 0.

mptLPPMergeToColor( geGetEditCellView() "colorLib" nil list( list( "Metal1" "drawing" "dr1" "dr2" ) )

The following tasks are performed for the two-mask Metal1 layer:

Hierarchically converts the layer-purpose-pair based multi-patterning design into Virtuoso standard multi-patterning data, starting from the cellview currently being edited.
Writes the results to library colorLib with the same cell and view name.
Copies all shapes on (Metal1, dr1) from the original cell to (Metal1, drawing) with color set to 1 in the destination cell.
Copies all shapes on (Metal1, dr2) from the original cell to (Metal1, drawing) with color set to 2 in the destination cell.
Copies the shapes on (Metal1, drawing) from the original cell on (Metal1, drawing) with color set to 0 in the destination cell.

Return to top

Virtuoso Layout Suite SKILL ReferenceProduct Version IC23.1, November 2023