leRemasterInstances
leRemasterInstances(
d_cellViewId
t_searchLibrary
t_searchCellview
t_searchViewName
t_updateLibrary
t_updateCellview
t_updateViewName
[ g_checkTerminals ]
)
=> t / nil
Description
Searches for instances based on the view name, cell name, and the library name for a given cellviewID, then re-masters those instances with the master that matches the update library, update cell and update view names you provide. The * wildcard can be used in any search string to replace any number of characters prior to or following the asterisk. If any of the search strings are empty then all matches in the cds.lib are considered, if matches exist. If any of the update strings are empty the update string uses the equivalent search string value. If both the search and the update strings are empty, only exact matches of the respective strings are considered. Due to the extensive changes available when using this command, making a backup copy of your design to guard against errors when replacing data is recommended.
Arguments
|
d_cellViewId
|
The database ID of the cellview containing the instances you want to re-master.
|
|
t_searchLibrary
|
The library name to search for. Valid Values: any library name or empty string
|
|
t_searchCellview
|
The cell name to search for. Valid Values: any cell name or empty string
|
|
t_searchViewName
|
The view name to search for. Valid Values: any view name or empty string
|
|
t_updateLibrary
|
The library master used to re-master the search results. Valid Values: any library name or empty string
|
|
t_updateCellview
|
The cellview master used to re-master the search results. Valid Values: any cell name or empty string
|
|
t_updateViewName
|
The cellview master used to re-master the search results. Valid Values: any view name or empty string
|
|
g_checkTerminals
|
When checkTerminals is set to t, and the master instTerm names of the instances that match the search criteria is a matching set or subset of the instTerms of the destination cellview, the cellview will be re-mastered. If the instTerm names are not a matching set or subset, the cellviews will not be re-mastered.
When checkTerminals is set to t, the following list shows the sample results, displaying the source, instTerm destination, and instTerm result.
-
ABC - ABC - re-mastered
-
ABC - ABCD - re-mastered
-
ABC - DEF - not re-mastered
-
ABC - AB - not re-mastered
When checkTerminals is set to nil, the function does not consider the instTerm names, so the cellviews are re-mastered even if the instTerms are not a matching set or subset.
Valid Values: t or nil
|
Value Returned
|
t
|
At least one of the searched instances is re-mastered.
|
|
nil
|
None of the searched instances met the update criteria and no instances are re-mastered.
|
Example
Remasters all instances of designLib/fir_nib/abstract in the specified cellview to lefin_lib/fir_nib/layout.
leRemasterInstances(cellViewId "designLib" "fir_nib" "abstract" "lefin_lib" "fir_nib" "layout" nil)
Return to top
