Balun: Create a Symmetric Balun
Balun (NAME:LEN:W1:(W2):S:N:(METAL:METAL2:XORG:YORG:ORIENT))
Aliases: balun,b,balunt,symt
Summary: Create a symmetric planar transformer of specifieddimensions. The center tap of the primary and secondary can thus belocated and used to build baluns. At the completion of the commandtwo spirals will reside in memory, the primary and the secondaryspiral, forming a 6-port circuit.
Example:
Balun name=a:len=250:w1=10:w2=15:s=5:n=5:metal=m5:metal2=m4

If no arguments are supplied, you will be prompted for the spiral
dimensions. The input parameters are as follows:
- Name : NAME --The unique name of the spiral.
- Outer Dimension L : LEN --The outer dimensions in microns of the spiral measured from edge to edge.
- Primary Metal Width : W1 --The metal trace width in microns.
- Secondary Metal Width : W2 (optional) --The metal trace width in microns.
- Spacing : S --The spacing from metal edge to metal edge.
- Turns : N --The number of spiral turns. Fractional amounts divisible by .25can be used to specify partial turns. The turns must not exceedthe upper limit.
- Metal Layer : METAL --The metal layer to use to wind the spirals.
- Transition Metal Layer : METAL2 --The metal layer to use to make transitions to inner turns.
- Origin of Spiral : XORG : YORG (optional) --The physical origin of the spiral relative to the lower lefthand corner of the chip. The origin of the spiral is the lowerleft corner rather than the physical center of the spiral. Donot place the spiral outside of the chip boundary, and avoidabutting the spiral against the chip boundaries.
- Orientation : ORIENT --The orientation of the spiral relative to the x-axis. Angles arespecified in units of degrees and the counter-clockwisedirection is considered positive.
Mmsquare: Create a Multi-Metal Series Connected Square Spiral
MMSquare (NAME:LEN | ILEN:(WID | IWID)):W:S:N:(METAL:EXIT:XORG:YORG:ORIENT:PHASE))
Aliases: mmsquare,mmsq,sqmm,rectmm
Summary: Create a multi-metal series connected square spiral of specifieddimensions and place the spiral in memory. The spirals are wound insuch a way that the magnetic field of each layer adds to the totalmagnetic field so as to increase the inductance of the overallstructure. Thus, for a two layer structure, the inductance willincrease to L1+L2+2*M12 where M12 is the mutual inductance. Agraphical representation of the spiral should appear at the completionof the command.
Example:
(A three layer spiral on M5 - M3) SQMM NAME=A:LEN=150:W=8:S=2:N=5:METAL=M5:EXIT=M3:XORG=200:YORG=2


If no arguments are supplied, you will be prompted for the spiral
dimensions. The input parameters are as follows:
- Name : NAME --The unique name of the spiral.
- Outer Dimension : LEN : ILEN --The outer dimension in microns of the spiral measured from edgeto edge. Note: If you enter "-1" for the dimension you will beprompted for the inner dimension of the spiral.
- Metal Width : W --The metal trace width in microns.
- Spacing : S --The spacing from metal edge to metal edge.
- Turns : N --The number of spiral turns. Fractional amounts divisible by .25can be used to specify partial turns. If you specify the outerdimensions of the spiral, then the turns must not exceed theupper limit.
- Metal Layer : METAL --The metal layer to use to wind the spiral.
- Exit Metal Layer : EXIT --This is the last layer of the spiral. Spirals will be created oneach metal layer in between METAL and EXIT.
- Origin of Spiral : XORG : YORG --The physical origin of the spiral relative to the lower lefthand corner of the chip. The origin of the spiral is the lowerleft corner rather than the physical center of the spiral. Donot place the spiral outside of the chip boundary, and avoidabutting the spiral against the chip boundaries.
Note that you can specify all of the above options through the command
line. You also can specify the following optional parameters:
- Orientation : ORIENT --The orientation of the spiral relative to the x-axis. Angles arespecified in units of degrees and the counter-clockwisedirection is considered positive.
- Phase : PHASE --The electrical phase of the spiral. If phase = +1 then thecurrent flows from the outer port into the inner port of thespiral. In other words, the PLUS terminal of the spiral is theouter port. If phase = -1, the PLUS terminal is the inner portof the spiral. The phase specification is useful for joiningspirals (see join).
Ring: Create Polygon Ring
Ring (NAME:RAD:W:GAP:SIDES:(METAL:XORG:YORG:ORIENT:PHASE))
Aliases: ring,halo,circle,circ
Example:
ring name=halo:rad=100:w=10:gap=30:metal=msub:xorg=200:yorg=200

If no arguments are supplied, you will be prompted for the ring
data. The input parameters are as follows:
- Name : NAME -- The unique name of the spiral.
- Radius : RAD -- The radius in microns of the spiral measured from outer edge to edge.
- Metal Width : W -- The metal trace width in microns.
- Gap Angle : GAP -- Angle of gap in degrees. For instance, 90degrees will create a `ring' spanning 270 degrees.
- Number of Sides : SIDES -- The number of sides to use. For 4 sides use the square command. SIDES can take on any value and for SIDES > 64 the structure will approach a circular structure.
Note that you can specify all of the above options through the command
line. You also can specify the following optional parameters:
- Metal Layer : METAL -- The metal layer to use to wind the spiral.
- Origin of Spiral : XORG : YORG -- The physical origin of the spiral relative to the lower left hand corner of the chip. The origin of the spiral is the lower left corner rather than the physical center of the spiral. Do not place the spiral outside of the chip boundary, and avoid abutting the spiral against the chip boundaries.
- Orientation : ORIENT -- The orientation of the spiral relative to the x-axis. Angles are specified in units of degrees and the counter-clockwise direction is considered positive.
- Phase : PHASE -- The electrical phase of the spiral. If phase = +1 then the current flows from the outer port into the inner port of the spiral. In other words, the PLUS terminal of the spiral is the outer port. If phase = -1, the PLUS terminal is the inner port of the spiral. The phase specification is useful for joining spirals (see join).
Shuntsquare: Create a Multi-Metal Shunt Connected (Stacked) Square Spiral
ShuntSq (NAME:LEN | ILEN:(WID | IWID)):W:S:N:(METAL:EXIT:XORG:YORG:ORIENT:PHASE))
Aliases: shuntsquare,shsq,sqsh,shuntsq
Summary: Create a multi-metal shunt connected (stacked) square spiral ofspecified dimensions and place the spiral in memory. The spirals areplaced directly on top of on another and a virtual electrical shortis placed at the beginning and ending of each segment. The connection iscalled virtual since it is not show and no vias will physicallyappear in the layout. This is similar to the joinshunt command.
Example:
(A three layer spiral on M5 - M3) SQSH NAME=A:LEN=150:W=10:S=1:N=5:METAL=M5:EXIT=M3:XORG=200:YORG=200:CBEGIN:CEND:EXIT90

If no arguments are supplied, you will be prompted for the spiral
dimensions. The input parameters are as follows:
- Name : NAME --The unique name of the spiral.
- Outer Dimension : LEN : ILEN --The outer dimension in microns of the spiral measured from edgeto edge. Note: If you enter "-1" for the dimension you will beprompted for the inner dimension of the spiral.
- Metal Width : W --The metal trace width in microns.
- Spacing : S --The spacing from metal edge to metal edge.
- Turns : N --The number of spiral turns. Fractional amounts divisible by .25can be used to specify partial turns. If you specify the outerdimensions of the spiral, then the turns must not exceed theupper limit.
- Metal Layer : METAL --The metal layer to use to wind the spiral.
- Exit Metal Layer : EXIT --This is the last layer of the spiral. Spirals will be created oneach metal layer in between METAL and EXIT. The underpasswill reside on metal layer EXIT-1.
- Origin of Spiral : XORG : YORG --The physical origin of the spiral relative to the lower lefthand corner of the chip. The origin of the spiral is the lowerleft corner rather than the physical center of the spiral. Donot place the spiral outside of the chip boundary, and avoidabutting the spiral against the chip boundaries.
Note that you can specify all of the above options through the command
line. You also can specify the following optional parameters:
- Orientation : ORIENT --The orientation of the spiral relative to the x-axis. Angles arespecified in units of degrees and the counter-clockwisedirection is considered positive.
- Phase : PHASE --The electrical phase of the spiral. If phase = +1 then thecurrent flows from the outer port into the inner port of thespiral. In other words, the PLUS terminal of the spiral is theouter port. If phase = -1, the PLUS terminal is the inner portof the spiral. The phase specification is useful for joiningspirals (see join).
- Begin Center : CBEGIN -- Begin winding the spiral at the center of the spiral.
- End Center : CEND -- End the spiral winding at the center of the spiral.
- Exit90 : EXIT90 -- Layout the exit segment perpendicular to the default direction.
Square: Create a Square Spiral
Square (NAME:LEN|ILEN:(WID|IWID)):W:S:N:(METAL:EXIT:XORG:YORG:ORIENT:PHASE)):CBEGIN:CEND:EXIT90
Aliases: square,sq,sqr,rect
Summary: Create a square or rectangular spiral of specified dimensions and place the spiral in memory. A graphical representation of the spiral should appear at the completion of the command.
Example:
SQ NAME=A:LEN=170:W=10:S=3:N=4.75:METAL=M3:EXIT=M2:XORG=200:YORG=200

If no arguments are supplied, you will be prompted for the spiral
data. The input parameters are as follows:
- Name : NAME -- The unique name of the spiral.
- Outer Dimension : LEN : ILEN -- The outer dimension in microns of the spiral measured from edge to edge. Note: If you enter "-1" for the dimension you will be prompted for the inner dimension of the spiral.
- Metal Width : W -- The metal trace width in microns.
- Spacing : S -- The spacing from metal edge to metal edge.
- Turns : N -- The number of spiral turns. Fractional amounts divisible by .25 can be used to specify partial turns. If you specify the outer dimensions of the spiral, then the turns must not exceed the upper limit.
- Metal Layer : METAL -- The metal layer to use to wind the spiral.
- Exit Metal Layer : EXIT -- An exit metal segment is used to provide a connection to the inner port of the spiral. A different metal layer must be use to avoid shorting the spiral. The exit layer is constructed to continue the last turn of the spiral. In other words, it is in the direction of the last segment of the spiral. To place the exit layer in another direction, do not use an exit layer but use the WIRE command.
- Origin of Spiral : XORG : YORG -- The physical origin of the spiral relative to the lower left hand corner of the chip. The origin of the spiral is the lower left corner rather than the physical center of the spiral. Do not place the spiral outside of the chip boundary, and avoid abutting the spiral against the chip boundaries.
Note that you can specify all of the above options through the command
line. You also can specify the following optional parameters:
- Orientation : ORIENT -- The orientation of the spiral relative to the x-axis. Angles are specified in units of degrees and the counter-clockwise direction is considered positive.
- Phase : PHASE -- The electrical phase of the spiral. If phase = +1 then the current flows from the outer port into the inner port of the spiral. In other words, the PLUS terminal of the spiral is the outer port. If phase = -1, the PLUS terminal is the inner port of the spiral. The phase specification is useful for joining spirals (see join).
- Begin Center : CBEGIN -- Begin winding the spiral at the center of the spiral.
- End Center : CEND -- End the spiral winding at the center of the spiral.
- Exit90 : EXIT90 -- Layout the exit segment perpendicular to the default direction.
Squaretaper: Create a Tapered Square Spiral
Square (NAME:LEN:(WID):W0:W1:S:N:(METAL:EXIT:XORG:YORG:ORIENT:PHASE))
Aliases: squaretaper,sqtaper,tapersq,sqt
Summary: The square taper spiral has constant spacing but the metalwidth is tapered continuously in a linear fashion. The first segmentis wound with a metal width of <W0> and the final turn with metalwidth <W1>. For every other segment i, W(i) = W0 + (W1-W0)*i/(4*N).
Example:
sqt name=taper:len=200:w0=20:w1=5:s=3:n=5:metal=m5

If no arguments are supplied, you will be prompted for the spiral
data. The input parameters are as follows:
- Name : NAME -- The unique name of the spiral.
- Outer Dimension : LEN : ILEN -- The outer dimension in microns of the spiral measured from edge to edge. Note: If you enter "-1" for the dimension you will be prompted for the inner dimension of the spiral.
- Initial Metal Width : W0 -- The initial metal trace width in microns.
- Final Metal Width : W1 -- The final metal trace width in microns.
- Spacing : S -- The spacing from metal edge to metal edge.
- Turns : N -- The number of spiral turns. Fractional amounts divisible by .25 can be used to specify partial turns. If you specify the outer dimensions of the spiral, then the turns must not exceed the upper limit.
- Metal Layer : METAL -- The metal layer to use to wind the spiral.
- Exit Metal Layer : EXIT -- An exit metal segment is used to provide a connection to the inner port of the spiral. A different metal layer must be use to avoid shorting the spiral. The exit layer is constructed to continue the last turn of the spiral. In other words, it is in the direction of the last segment of the spiral. To place the exit layer in another direction, do not use an exit layer but use the WIRE command. (Currently ignored)
- Origin of Spiral : XORG : YORG -- The physical origin of the spiral relative to the lower left hand corner of the chip. The origin of the spiral is the lower left corner rather than the physical center of the spiral. Do not place the spiral outside of the chip boundary, and avoid abutting the spiral against the chip boundaries.
Note that you can specify all of the above options through the command
line. You also can specify the following optional parameters:
- Orientation : ORIENT -- The orientation of the spiral relative to the x-axis. Angles are specified in units of degrees and the counter-clockwise direction is considered positive.
- Phase : PHASE -- The electrical phase of the spiral. If phase = +1 then the current flows from the outer port into the inner port of the spiral. In other words, the PLUS terminal of the spiral is the outer port. If phase = -1, the PLUS terminal is the inner port of the spiral. The phase specification is useful for joining spirals (see join).
Sympoly: Create a Polygon Symmetric Spiral
SymPoly (NAME:RAD:W:S:N:(ILEN:SIDES:METAL:METAL2:XORG:YORG:ORIENT:PHASE))
Aliases: sympoly,balpoly,centerpoly,symsp
Summary: Create a polygon symmetric spiral of specified dimensions and place the spiral in memory. A graphical representation of the spiral should appear at the completion of the command. This spiral will have both ports on the outside and the spiral impedance should be fairly symmetric, i.e. both ports should present the same impedance. This is accomplished by winding the spirals symmetrically from turn to turn. Thus the center of this spiral, accessible from the inside of the structure, represents the true center "tap" of inductance and resistance. This structure is the building block for designing polygon baluns as well.
Example:
SYMPOLY NAME=D:RAD=80:W=10:S=4:ILEN=14:N=5:METAL=M3:METAL2=M2:XORG=200:YORG=200

If no arguments are supplied, you will be prompted for the spiral dimensions. The input parameters are as follows:
- Name : NAME -- The unique name of the spiral.
- Radius : RAD --The outer dimension in microns of the spiral measured from edge to edge.
- Metal Width : W --The metal trace width in microns.
- Spacing : S --The spacing from metal edge to metal edge.
- Space for Transitions : ILEN --The length of the spacing used to construct the inter-turnconnections. Note that ILEN > (W+S).
- Turns : N --The number of spiral turns. This must be an integer as partialturns are not allowed in a symmetric structure.
- Metal Layer : METAL --The metal layer to use to wind the spiral.
- Transition Metal Layer : EXIT --The Transition Metal Layer is used to connect adjacent turns ofthe spiral without shorting the "primary" to the "secondary" ofthe inductor. This layer must differ from the Metal Layer.
- Origin of Spiral : XORG : YORG --The physical origin of the spiral relative to the lower lefthand corner of the chip. The origin of the spiral is thephysical center of the spiral. Do not place the spiral outsideof the chip boundary, and avoid abutting the spiral against thechip boundaries.
Note you can specify all of the above options through the command line. You also can specify the following optional parameters:
- Orientation : ORIENT --The orientation of the spiral relative to the x-axis. Angles arespecified in units of degrees and the counter-clockwisedirection is considered positive.
- Phase : PHASE --The electrical phase of the spiral. If phase = +1 then thecurrent flows from the top port into the bottom port of thespiral. In other words, the PLUS terminal of the spiral is thetop port. If phase = -1, the PLUS terminal is the bottom port ofthe spiral. The phase specification is useful for joiningspirals.(see JOIN)
Note: This above only applies to a spiral with ORIENT=0.
Symsq: Create a Square Symmetric Spiral
SymSquare (NAME:LEN::W:S:N:(ILEN:METAL:METAL2:XORG:YORG:ORIENT:PHASE))
Aliases: symsq,balsq,centersq,symsquare
Summary: Create a square symmetric spiral of specified dimensions and place the spiral in memory. A graphical representation of the spiral should appear at the completion of the command. This spiral will have both ports on the outside and the spiral impedance should be fairly symmetric, i.e. both ports should present the approximately equal impedance. This is accomplished by winding the spirals symmetrically from turn to turn. Thus the center of this spiral, accessible from the inside of the structure, represents the true center "tap" of inductance and resistance. This structure is the building block for designing a balun.
Example:
SYMSQ NAME=C:LEN=150:W=10:S=3:ILEN=13:N=5:METAL=M3:METAL2=M2:XORG=200:YORG=200

If no arguments are supplied, you will be prompted for the spiral dimensions. The input parameters are as follows:
- Name : NAME -- The unique name of the spiral.
- Outer Dimension : LEN : WID -- The outer dimension in microns of the spiral measured from edge to edge.
- Metal Width : W -- The metal trace width in microns.
- Spacing : S -- The spacing from metal edge to metal edge.
- Space for Transitions : ILEN : IWID -- The spacing used for transitions from turn to turn. Note that ILEN > (W+S)
- Turns : N -- The number of spiral turns. This must be an integer as partial turns are not allowed in a symmetric structure.
- Metal Layer : METAL -- The metal layer to use to wind the spiral.
- Transition Metal Layer : METAL2 -- The Transition Metal Layer is used to connect adjacent turns of the spiral without shorting the "primary" to the "secondary" of the inductor. This layer must differ from the Metal Layer.
- Origin of Spiral : XORG : YORG -- The physical origin of the spiral relative to the lower left hand corner of the chip. Do not place the spiral outside of the chip boundary, and avoid abutting the spiral against the chip boundaries.
Note that you can specify all of the above options through the command line. You also can specify the following optional parameters:
- Orientation : ORIENT -- The orientation of the spiral relative to the x-axis. Angles are specified in units of degrees and the counter-clockwise direction is considered positive.
- Phase : PHASE -- The electrical phase of the spiral. If phase = +1 then the current flows from the top port into the bottom port of the spiral. In other words, the PLUS terminal of the spiral is the top port. If phase = -1, the PLUS terminal is the bottom port of the spiral. The phase specification is useful for joining spirals. (see join)
Note: This above only applies to a spiral with ORIENT=0.
See Also: $CREATE_BALUN
Trans: Create a Planar Transformer
Trans (NAME|PNAME:(SNAME):LEN:(WID):W|WP:(WS):S:N|NP:(NS):(METAL:EXIT:XORG:YORG:ORIENT:PHASE))
Aliases: trans,t,transformer,tr
Summary: Create a planar spiral transformer of specified dimensions. Thetransformer is constructed by interwinding two planar square spirals.At the completion of the command two spirals will reside in memory,the primary and the secondary spiral, forming a 4-port circuit.
Example:
TRANS PNAME=A:SNAME=B:LEN=150:W=7:S=3:N=3.5:METAL=M3:EXIT=M2:XORG=200:YORG=200

If no arguments are supplied, you will be prompted for the spiral
dimensions. The input parameters are as follows:
- Primary Name : NAME|PNAME --The unique name of the "primary" spiral.
- Secondary Name : SNAME --The unique name of the "secondary" spiral. Generated fromprimary name if not specified.
- Outer Dimension : LEN --The outer dimension in microns of the spiral measured from edge to edge.
- Primary Metal Width : W | WID | WP --The primary metal trace width in microns.
- Secondary Metal Width : WS --The secondary metal trace width in microns. Defaults to primary width.
- Spacing : S --The spacing from metal edge to metal edge.
- Turns : N|NP --The number of primary spiral turns. Fractional amounts divisible by .25can be used to specify partial turns. The turns must not exceedthe upper limit.
- Turns : NS --The number of secondary spiral turns. Default to primary turns.
- Metal Layer : METAL --The metal layer to use to wind the spiral.
- Exit Metal Layer : EXIT --An exit metal segment is used to provide a connection to theinner port of the spiral. A different metal layer must be usedto avoid shorting the spiral. The exit layer is constructed tocontinue the last turn of the spiral. In other words, it is inthe direction of the last segment of the spiral. To place theexit layer in another direction, do not use an exit layer butuse the WIRE command.
- Origin of Spiral : XORG : YORG --The physical origin of the spiral relative to the lower lefthand corner of the chip. The origin of the spiral is the lowerleft corner rather than the physical center of the spiral. Donot place the spiral outside of the chip boundary, and avoidabutting the spiral against the chip boundaries.
Note that you can specify all of the above options through the command line. You also can specify the following optional parameters:
- Orientation : ORIENT --The orientation of the spiral relative to the x-axis. Angles arespecified in units of degrees and the counter-clockwisedirection is considered positive.
- Phase : PHASE --The electrical phase of the spiral. If phase = +1 then thecurrent flows from the outer port into the inner port of thespiral. In other words, the PLUS terminal of the spiral is theouter port. If phase = -1, the PLUS terminal is the inner portof the spiral. The phase specification is useful for joiningspirals (see join).
If no arguments are supplied, you will be prompted for the via
dimensions. The input parameters are as follows:
Wire: Create a Wire (rectangle)
Wire (NAME:LEN:W|WID:(METAL:(XORG:YORG:ORIENT:PHASE)))
Aliases: wire,w
Summary: Create a wire of specified dimensions and place the wire inmemory. A graphical representation of the wire should appear at thecompletion of the command. A wire is a single rectangular segment. Awire can be used to build arbitrary structures by interconnectingwires in series or in shunt through the join andjoinshunt command.
Example:
WIRE NAME=B:LEN=200:WID=50:METAL=M3:XORG=200:YORG=200

If no arguments are supplied, you will be prompted for the wire
dimensions. The input parameters are as follows:
- Name : NAME --The unique name of the spiral.
- Length : LEN --The length of the wire.
- Width : WID --The width of the wire.
- Metal Layer : METAL --The metal layer of the wire segment.
- Origin of Spiral : XORG : YORG --The physical origin of the wire relative to the lower left handcorner of the chip.
Note that you can specify all of the above options through the command
line. You also can specify the following optional parameters:
- Orientation : ORIENT --The orientation of the wire relative to the x-axis. Angles arespecified in units of degrees and the counter-clockwisedirection is considered positive.
- Phase : PHASE --The electrical phase of the wire. If phase = +1 then the current(assuming ORIENT = 0) flows from the left port into the rightport of the wire. In other words, the PLUS terminal of the wireis on the left side. If phase = -1, the PLUS terminal is theright port of the wire. The phase specification is useful forjoining wires (see join).