techCreateWidthSpacingPattern

techCreateWidthSpacingPattern(
d_techFileId
t_name
l_patternSpecs
[ g_offset ]
[ b_repeatOffset ]
[ b_shiftColor ]
[ t_allowedRepeatMode ]
[ t_defaultRepeatMode ]
)
=> d_WidthSpacingPatternId / nil

Description

(Virtuoso Advanced Node for Layout Only) Creates a width spacing pattern in the specified technology file.

Arguments

d_techFileId	Specifies the ID of the technology file in which the width spacing pattern is to be created.
t_name	Specifies the width spacing pattern name.
l_patternSpecs	Specifies a list of track group specifications. `list` (l_patternSpec) where, l_patternSpec is a track group specification. l_patternSpec`: list(`l_specs `[`d_repeat `[`l_wireTypes `[`l_colorNames`] [l_displayPacketNames]]])` l_specs is the list of individual track specifications for the specified track group. `list`(l_spec) l_spec is the track specification. l_spec`: list(`g_width g_space `[`t_wireType `[`t_colorName `[`t_displayPacketName`]]])` g_width is the width of shapes on this track. g_space is the center-line distance of the next track from the current track, in the period direction. t_wireType is a string that represents the wire type. It can only be specified if d_repeat l_wireTypes is not specified. Default value is an empty string (`""`). t_colorName is the color of the specified track. It can only be specified if d_repeat l_wireTypes is not specified. By default, tracks are not colored. Valid values: `mask1Color`, `mask2Color`, and `mask3Color`. t_displayPacketName is the name of a display packet that can be specified to control how the track should be drawn on the screen. It can be specified only if t_colorName is specified.
	d_repeat is a number of repeats for the track group. A value of 1 creates the track group from the specified l_specs (1x). A value of 2 creates the track group from the specified l_specs that are repeated once (2x). Default value is 1. If specified, t_wireType and t_colorName cannot be specified in the l_specs. l_wireTypes is a list of wire types for the track group (only if d_repeat is specified). l_wireTypes`: list([t_wireType …])` An empty string in the list can be used if you do not want to specify a wire type for a track. If the number of tracks in the track group is greater than the number of wire types in this list, then the wire types list is repeated across the track group until all tracks are assigned a wire type, one-by-one. Default value: An empty list. t_wireType is a string that represents the wire type. For example, for a track group with 6 tracks: If l_wireTypes is `list("a" "b")`, then tracks 1, 3, and 5 are wire type a; tracks 2, 4, and 6 are wire type b. If l_wireTypes is `list("a" "a" "b")`, then tracks 1, 2, 4, and 5 are wire type a; tracks 3 and 6 are wire type b. l_colorNames is a list of track colors for the track group (only if d_repeat is specified). Default value: An empty list. l_colorNames`: list([t_colorName …])`
	The `grayColor` entry can be used if you do not want to specify a color for a track. If the number of tracks in the specified track group is greater than the number of colors in this list, then the color list is repeated across the track group until all tracks are assigned a color, one-by-one. t_colorName is a color of the specified track. Valid values: `mask1Color`, `mask2Color`, `mask3Color`, and `grayColor`. l_displayPacketNames is a list of display packet names for the track group (only if d_repeat is specified). Default value: An empty list. l_displayPacketName`: list([t_displaypacketName …])` t_displayPacketName is the display packet name for the specified track.
g_offset	Specifies the distance of the first track from the period track. Default value: 0
b_repeatOffset	Specifies a flag to indicate whether the offset is applied when a pattern is repeated. Default value: `nil`
b_shiftColor	Specifies a flag to indicate whether track colors are shifted when a pattern is repeated. This attribute is used only when all tracks are individually colored. No automatic color assignment is done. If no color is specified for a track, it will be gray. Default value: `nil`
t_allowedRepeatMode	Specifies the allowed repeat mode. Valid values: `any` (default), `none`, `steppedOnly`, and `flippedOnly`.
t_defaultRepeatMode	Specifies the default repeat mode. Valid values: `noRepeat` (default), `stepped`, `flippedStartsWithOdd`, and `flippedStartsWithEven`.

Value Returned

d_widthSpacingPatternId
	Returns the ID of the created width spacing pattern.
`nil`	Returned in case of failure.

Examples

Example 1

techCreateWidthSpacingPattern( 
    tech 
    "wsp" 
    '((((0.04 0.08 "mywire1" "mask1Color") (0.09 0.12)))) 
    0.05 
    )

Creates wsp width spacing pattern in the specified technology file as shown in the figure below.

Example 2

techCreateWidthSpacingPattern(tech "wsp1"
    '(
     (
   (
    (0.04 0.08)
   ) 
   4 
   ("vdd1" "sig1")
   ("mask2Color" "mask3Color")
  )
  (
   (   
    (0.04 0.08 nil "mask2Color") 
    (0.09 0.012 "big")
   )
  )
 )
 0.007 
 t 
 nil 
 "steppedOnly" 
 "stepped"
)

In this example, a width spacing pattern wsp1 is created in the technology database tech with two track groups, defining a total of six tracks.

For the first track group:
- The width of the track is 0.04.
- The distance of the next track from the current track, in the period direction is 0.08.
- The track group is repeated 4 times resulting in a total of 4 tracks.
- The offset distance of the first track from the period track is 4.
- The wire type of the first and third track is vdd1. The wire type of the second and fourth track is sig1.
- The track color of the first and third track is mask2Color. The track color of the second and fourth track is mask3Color.
For the second track group:
- For the first track in this group:
  - The width is 0.04.
  - The distance of the next track from this track, in the period direction is 0.08.
  - No wire type is specified.
  - The track color is mask2Color.
- For the second track in this group and the sixth track in the pattern:
  - The width is 0.09.
  - The distance of the next track from this track, in the period direction is 0.012.
  - The wire type is big.
  - No track color is specified.
- The second track group is not repeated, and the wire type and track color of each track are specified on individual tracks.
The distance of the first track from the period grid is 0.007.
The repeatOffset attribute is set to t. This means the height of the pattern includes the offset of the first track.
The shiftColor attribute is set to nil. This means the track colors are not shifted when the pattern repeats.
allowedRepeatMode is steppedOnly, which implies that the pattern can only be stepped, but not flipped. In conformance, defaultRepeatMode is stepped.

Return to top

Virtuoso Technology Data SKILL ReferenceProduct Version IC23.1, June 2023