ccpExpandExactDesign

ccpExpandExactDesign(
G_src
s_expFlag
q_expandSkipLibList 
[ l_expandViewTypeList ]
[ l_expandViewNameList ]
[ t_vNameSimExp ]
[ t_vNameSpace ]
[ g_addProp ]
[ g_existenceCheck ]
[ g_reReferenceCustomVias ]
)
=> q_expSpecList / nil

Description

Expands a design, given a source cell or cellview gdmSpec object. This function is similar to ccpExpandDesign, except that the expansion list only includes those views that are used in the design.

ccpExpandExactDesign traverses the design hierarchy based on the pcdb (parent-child database). It excludes the cells that are in libraries listed in q_expandSkipLibList, if any. It then returns the expansion list.

For each cell, ccpExpandExactDesign includes only the view that is used in the design. It does not include any other views in the expansion list.

To include other views, you need to specify them in the l_expandViewTypeList or l_expandViewNameList. If these views have their own hierarchy, then that hierarchy is also traversed.

Arguments

G_src	Source gdmSpec object. Must be a cell or view.
s_expFlag	Expands the flag options. Can be one of the following predefined symbols: `CCP_EXPAND_COMANAGED`: Expands a directory and includes only the `coManaged` and `alsoManaged` files, which are defined in the `dataReg`. Some applications have co-managed files stored at different directory levels. These co-managed files will also be included for copy. The `prop.xx` file, which is invalid in OpenAccess libraries, is no longer automatically included in co-managed sets. `CCP_EXPAND_ALL`: Expands everything in a directory.
q_expandSkipLibList
	Excludes gdmSpecList object that contains the libraries while copying. It is a stop list—design objects in the libraries are not traversed.
l_expandViewTypeList
	Lists strings specifying the additional view types to be expanded. If the list is empty, includes only those views that are used in the design. This argument is optional; its default value is `nil`.
l_expandViewNameList
	Lists strings specifying the additional views to be expanded. If the list is empty, includes only those views that are used in the design. This argument is optional; its default value is `nil`.
t_vNameSimExp	Specifies the additional views to expand.
t_vNameSpace	The name space in which the arguments t_vNameSimExp and l_expandViewNameList are provided. Can be one of the following strings: `VHDL`, `Verilog`, `Verilog-A`, `CDBA`, `Concept`, `Library`, `LibraryUnix`, or `LibraryNT`.
g_addProp	Copies files from library and cell property. It is recommended that you use `nil` for this argument because of potential conflicts between property files. Properties are usually added by the copy updaters. Default is `nil.`
g_existenceCheck	Sets a flag for the Virtuoso post-copy updater to validate the existence of layers, purposes, viaDefs, and siteDefs in the technology database of the destination library after the copy command is completed. Default is `0.`
g_reReferenceCustomVias
	Sets a flag for the Virtuoso post-copy updater to update custom via definitions to point to cellviews in the destination library. Default is `0.`

Value Returned

q_expSpecList	A gdmSpecList object containing gdmSpec objects for the files in the expansion list.
`nil`	The design could not be expanded.

Cadence Application Infrastructure SKILL Reference
Product Version IC23.1, November 2023