vfpLoadPhysicalView

vfpLoadPhysicalView(
t_sourceLibName
t_sourceCellName
t_sourceViewName
t_targetLibName
t_targetCellName
t_targetViewName
[ ?updateInstances g_updateInstances ]
[ ?updateInstanceOptions l_updateInstanceOptions ]
[ ?updateDesignOptions l_updateDesignOptions ]
[ ?updateSelectedNets l_updateSelectedNets ]
[ ?updateSpecifiedLayers l_updateSpecifiedLayers ]
[ ?updateUnattachedLabels l_updateUnattachedLabels ]
[ ?loadPins s_updatePins ]
[ ?mapperFile t_fileName ]
[ ?addGeometries g_addGeometries ]
[ ?addGeometryOptions l_addGeometryOptions ]
[ ?updateBoundaries g_updateBoundaries ]
[ ?updateBoundaryOptions l_updateBoundaryOptions ]
[ ?replaceRows g_replaceRows ]
[ ?replaceRowOptions l_replaceRowOptions ]
[ ?replaceBlockages g_replaceBlockages ] 
[ ?replaceHalos g_replaceHalos ] 
[ ?replaceObstructionOptions l_replaceObstructionOptions ]
[ ?transferConstraints g_transferConstraints ] 
)
=> t / nil

Description

Updates the instances, pins, geometries, and P&R information from a source cellview to a target cellview. The source cellview acts as a template to perform the following in the target cellview:

Update instance location, orientation, and placement status.
Update pin location, layer, height, and width.
Add geometries such as shapes and wires.
Replace P&R objects such as boundaries, rows, blockages, and halos.

Arguments

t_sourceLibName	Specify the name of the source library.
t_sourceCellName	Specify the name of the source cell.
t_sourceViewName	Specify the name of the source view.
t_targetLibName	Specify the name of the target library.
t_targetCellName	Specify the name of the target cell.
t_targetViewName	Specify the name of the target view.
`?updateInstances` g_updateInstances
	Specify if the instances are to be updated. The default value is `nil`.
`?updateInstanceOptions` l_updateInstanceOptions
	Specify the instances to update in the target cellview. Set one or more of the following options to `t` or `nil`. `stdCells` `customCells` `macros` `ioPads` `addPhysOnlyInst`(instances that exist only in the physical domain and lack a corresponding instance in the logical domain. For example, filler cells)
`?updateDesignOptions` l_updateDesignOptions
	Specify the parameters to be updated in the target cellview. Set one or more of the following options to `t` or `nil`. `cellType` `blockType` `symmetry` (orientation) `sitePattern` `trackPattern`
`?updateSelectedNets` l_updateSelectedNets
	(Layout EXL Only) Specify the pins, shapes, and wires in the selected nets in the target cellview to be transferred from the source cellview. The default value is `nil`.
`?updateSpecifiedLayers` l_updateSpecifiedLayers
	(Layout EXL Only) Copies pins, wires, and shapes from the source to the target cellview only for the specified target layers. The default value is `nil`.
`?updateUnattachedLabels` l_updateUnattachedLabels
	(Layout EXL Only) Copies the unattached labels present in the source cellview to the target cellview. The default value is `t`.
`?loadPins` s_updatePins	Specify if the pins are to be updated or replaced. Specify replace to load pins in the replace mode, update to load pins in the update mode, and nil to not load the pins. The default value is nil.
`?mapperFile` t_fileName	(Layout EXL Only) Specify the name of a mapping file that defines the instance, layer, and layer purpose pair mapping between the source and target cellviews.
`?addGeometries` g_addGeometries
	Specify if the geometries are to be added. The default value is `nil`.
`?addGeometryOptions` l_addGeometryOptions
	Specify the geometries to be added from the source cellview to the target cellview at exactly the same locations as in the source cellview. The options are: `deleteGeometries`: Deletes existing shapes and wires (except Modgens and pins) before importing them from the source cellview. `addShapes`: Imports all the shapes from the source cellview to the target cellview. `addWiresAndVias`: Imports all the wires (pathSegs and vias) and their topologies from the source cellview to the target cellview.
`?updateBoundaries` g_updateBoundaries
	Specify if the boundaries are to be updated. The default value is `nil`.
`?updateBoundaryOptions` l_updateBoundaryOptions
	Specify the type of boundary for which information must be imported from the source cellview to the target cellview. The valid options are: `updatePRBoundary` `updateSnapBoundary`
`?replaceRows` g_replaceRows
	Specify if the rows are to be replaced. The default value is `nil`.
`?replaceRowOptions` l_replaceRowOptions
	Specify if the following types of rows are to be replaced. `replaceStandardRows` `replaceCustomRows`
`?replaceBlockages` g_replaceBlockages
	Specify if the blockages are to be replaced. The default value is `nil`.
`?replaceHalos` g_replaceHalos
	Specify if the halos are to be replaced. The default value is `nil`.
`?replaceObstructionOptions` l_replaceObstructionOptions
	Specify the types of obstructions to be replaced in the target cellview with appropriate obstructions from the source cellview. Set one or more of the following options to `t` or `nil`. `placement` `routing` `slot` `pin` `fill` `feedThru` `screen`
`?transferConstraints` g_transferConstraints
	When set to `replace`, the constraints in the target cellview are replaced with the constraints transferred from the source cellview. When set to `update`, the constraints in the target cellview are updated. When set to `nil`, no constraints are transferred. The default value is `nil`.

Value Returned

`t`	Returns `t` if the function successfully updates the target cellview.
`nil`	Returns `nil` otherwise.

Examples

Updates information from the specified source cellview to the specified target cellview. The instances in the target cellview are updated. The pins in the target cellview are replaced with the ones in the source cellview. Geometries (shapes, wires, and vias) are added from the source to the target cellview.

vfpLoadPhysicalView("design" "top_level" "layout_xy" "design" "top_level" "layout" ?updateInstances t ?loadPins replace ?addGeometries t)

Updates information from the specified source cellview to the specified target cellview. Only the standard cells in the target cellview are updated. The pins in the target cellview are replaced with the ones in the source cellview. Geometries (shapes, wires, and vias) and boundaries are added from the source to the target cellview. Blockages and halos of the type placement are replaced in the target cellview with the ones in the source cellview.

vfpLoadPhysicalView("design" "top_level" "layout_xy" "design" "top_level" "layout" ?updateInstances t ?updateInstanceOptions (("stdCells" t)) ?loadPins replace ?addGeometries t ?updateBoundaries t ?replaceBlockages t ?replaceHalos t ?replaceObstructionOptions ("placement" t))

Return to top

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