Product Documentation
Virtuoso Schematic Editor SKILL Functions Reference
Product Version IC23.1, November 2023

schHiCreateInst

schHiCreateInst(
[ ?libraryName t_libraryName ]
[ ?cellName t_cellName ]
[ ?viewName t_viewName ]
[ ?instanceName t_instanceName ]
[ ?rows x_rows ]
[ ?columns x_columns ] 
)
=> t

Description

Places an instance of a cellview in a schematic. Usable only when editing schematics.

Arguments

?libraryName t_libraryName

Library that contains the cellview; must be enclosed in quotation marks.

?cellName t_cellName

Cell name you want to use; must be enclosed in quotation marks.

?viewName t_viewName

View you want to use; must be enclosed in quotation marks.

?instanceName t_instanceName

Unique name to assign to your instance; must be enclosed in quotation marks. To name more than one instance, use a space as a delimiter. The schematic editor places the instances in the order in which you specified them.

?rows x_rows

Number of rows of instances to create. Range is limited by the system. If x_rows is greater than 1, you are prompted to click at a location to place the first instance in the second row. The schematic editor places the first components of the remaining columns, then drags all first row components and places all remaining components. It names each instance with the names that you specified in t_instanceName. If t_instanceName is empty, unique names are generated for each instance placed.

?columns x_columns

Number of columns of instances to create. Range is limited by the system. If x_columns is greater than 1, you are prompted to click at a location to place the first instance in the second column. The schematic editor places the first components of the remaining columns, then drags all first row components and places all remaining components. It names each instance with the names that you specified in t_instanceName. If t_instanceName is empty, unique names are generated for each instance placed.

Value Returned

Always returns t.

Examples

Drags the requested AND2 symbol from the SAMPLE library until you click to place it. Symbol view name is SYMBOL and the instance name is IO.

schHiCreateInst( ?libraryName "SAMPLE" ?cellName "AND2" ?viewName "SYMBOL" ?instanceName "IO" )
Creates an array of 12 components. Names the first two instances in the first row A and B. Automatically generates unique instance names for the remaining instances in the array.
schHiCreateInst( ?libraryName "SAMPLE" ?cellName "AND2" ?viewName "SYMBOL" "A B" 4 3 )

Return to top
 ⠀
X