dbCreateWidthSpacingPattern

dbCreateWidthSpacingPattern( 
d_cellView
t_name
l_patternSpecs
[ n_offset ]
[ g_repeatOffset ]
[ g_shiftColor ]
[ t_allowedRepeatMode ]
[ t_defaultRepeatMode ]
)
=> d_widthSpacingPattern / nil 

Description

Creates a width spacing pattern in the specified cellview.

Arguments

d_cellView	ID of the cellview for which the width spacing pattern must be created.
t_name	Name of the width spacing pattern.
l_patternSpecs	list(l_patternSpec) List of track group specifications.
	where, l_patternSpec: list(l_specs [d_repeat [l_wireTypes [l_colorNames] [l_displayPacketNames]]]) A track group specification. l_specs: list(l_spec) List of individual track specifications for the specified track group. l_spec: list(g_width g_space [t_wireType [t_colorName] [t_displayPacketName]]) A track specification. g_width Width of shapes on the specified track.
	g_space The centerline distance of the next track from the current track, in the period direction. t_wireType The type of wire. This parameter can be specified only when d_repeat l_wireTypes is not specified. It is used to refer to a specific group of tracks, for example, routing a set of tracks by name. The default value is an empty string "". t_colorName Color of the specified track. By default, tracks are not colored. This parameter can be specified only when d_repeat l_wireTypes is not specified. Valid values are "mask1Color", "mask2Color", and "mask3Color". t_displayPacketName 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 The number of times the track group is repeated. 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). l_wireTypes: list([t_wireType …]) List of wire types associated with the specified track group (only if d_repeat is specified on the track group). Use an empty string ("") to specify no wire type for an individual 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.
n_offset	Distance of the first track from the period track.
g_repeatOffset	Determines whether the offset is applied when a pattern repeats. When set to t the offset is repeated every time and when set to nil the offset is applied only once.
g_shiftColor	Determines whether the track colors are shifted when a pattern repeats. The parameter is optional and is used only when all tracks are individually colored. If no color is specified for a track, then it remains uncolored (or gray). The default value is nil. The tracks cannot be colored automatically.
t_allowedRepeatMode	Name of allowed repeat mode. Valid values: any, none, steppedOnly, and flippedOnly. The default value is "any".
t_defaultRepeatMode	Name of default repeat mode. Valid values are Valid values: noRepeat, stepped, flippedStartsWithOdd, and flippedStartsWithEven. The default value is "noRepeat".

Value Returned

d_widthSpacingPattern	The ID of the created width spacing pattern.
nil	Returned in case of failure.

Examples

Example 1

A width spacing pattern wsp1 is created in the cellview cv with two track specifications.

dbCreateWidthSpacingPattern(cv "wsp1" '((((0.04 0.08 "mywire1" "mask1Color") (0.09 0.12)))) 0.05 )

• For the first track,
  • 0.04 is the width of the shapes.
  • 0.08 is the distance of the next track from the current track, in the period direction.
  • mywire1 is the type of wire to use.
  • mask1Color is the mask color.
  • 0.05 is the distance of the first track from the period track.
• For the second track,
  • 0.09 is the width of the shapes.
  • 0.12 is the distance of the next track from the current track, in the period direction.
    
    

Example 2

This is similar to the previous example. However, the two tracks are repeated (repeat value of 2). Therefore, the pattern consists of 4 tracks, as shown below.

dbCreateWidthSpacingPattern(cv "wsp2" 
   '((((0.04 0.08 "mywire1" "mask1Color") (0.09 0.12)) 2)) 
   0.05 
)

Example 3

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

dbCreateWidthSpacingPattern(cv "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"
)

• 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