Provided by: magic_8.3.105+ds.1-1.1_amd64 bug

NAME

       ext2sim - convert hierarchical ext(5) extracted-circuit files to flat sim(5) files

SYNOPSIS

       ext2sim [ -a aliasfile ] [ -l labelsfile ] [ -o simfile ] [ -A ] [ -B ] [ -F ] [ -L ] [ -t
       ]  [  extcheck-options  ]  [  -y  num  ]  [  -f  mit|lbl|su  ]  [  -J  hier|flat  ]  [  -j
       device:sdRclass[/subRclass]/defaultSubstrate ] root

DESCRIPTION

       Ext2sim  will  convert  an  extracted  circuit from the hierarchical ext(5) representation
       produced by Magic to the flat sim(5) representation required  by  many  simulation  tools.
       The  root  of  the  tree  to  be  extracted  is the file root.ext; it and all the files it
       references are recursively flattened.  The result is a single, flat representation of  the
       circuit  that  is written to the file root.sim, a list of node aliases written to the file
       root.al, and a list of the  locations  of  all  nodenames  in  CIF  format,  suitable  for
       plotting,  to  the  file  root.nodes.  The file root.sim is suitable for use with programs
       such as crystal(1), esim(1), or sim2spice(1).

       The following options are recognized:

       -a aliasfile
                 Instead of leaving node aliases in the file root.al, leave it in aliasfile.

       -l labelfile
                 Instead of leaving a CIF file with the locations of all node names in  the  file
                 root.nodes, leave it in labelfile.

       -o outfile
                 Instead of leaving output in the file root.sim, leave it in outfile.

       -A        Don't produce the aliases file.

       -B        Don't  output  transistor or node attributes in the .sim file.  This option will
                 also disable the output of information such as the area and perimeter of  source
                 and drain diffusion and the fet substrate. For compatibitlity reasons the latest
                 version of ext2sim outputs this information as node attributes.  This option  is
                 necessary  when  preparing  input for programs that don't know about attributes,
                 such as sim2spice(1) (which is actually made obsolete by ext2spice(1),  anyway),
                 or rsim(1).

       -F        Don't output nodes that aren't connected to fets (floating nodes).

       -L        Don't produce the label file.

       -tchar    Trim  characters  from  node names when writing the output file.  Char should be
                 either "#" or "!".  The option may be used twice if both characters are desired.

       -f MIT|LBL|SU
                 Select the output format. MIT is  the  traditional  sim(5)  format.   LBL  is  a
                 variant of it understood by gemini(1) which includes the substrate connection as
                 a fourth terminal before length and width.  SU is the internal  Stanford  format
                 which  is  described  also  in  sim(5)  and includes areas and perimeters of fet
                 sources, drains and substrates.

       -y num    Select the precision for outputting capacitors. The default  is  1  which  means
                 that the capacitors will be printed to a precision of .1 fF.

       -J hier|flat
                 Select  the  source/drain  area  and  perimeter extraction algorithm. If hier is
                 selected then the areas and perimeters are extracted only within  each  subcell.
                 For  each fet in a subcell the area and perimeter of its source and drain within
                 this subcell are output.  If two or more fets share a source/drain node then the
                 total  area  and perimeter will be output in only one of them and the other will
                 have 0.  If flat is selected the same rules apply only that the scope of  search
                 for  area  and  perimeter  is  the  whole netlist. In general flat (which is the
                 default)  will  give  accurate  results  (it  will  take  into  account   shared
                 sources/drains)  but  hier  is provided for backwards compatibility with version
                 6.4.5. On top of this selection you can individually control how a terminal of a
                 specific  fet  will  be  extracted  if you put a source/drain attribute. ext:aph
                 makes the extraction for that specific terminal hierarchical and  ext:apf  makes
                 the  extraction  flat (see the magic tutorial about attaching attribute labels).
                 Additionally to ease  extraction  of  bipolar  transistors  the  gate  attribute
                 ext:aps forces the output of the substrate area and perimeter for a specific fet
                 (in flat mode only).

       -j device:sdRclass[/subRclass]/defaultSubstrate
                 Gives ext2sim information about the source/drain resistance  class  of  the  fet
                 type  device.  Makes  device  to  have  sdRclass  source drain resistance class,
                 subRclass substrate (well) resistance class and the node named  defaultSubstrate
                 as  its  default  substrate.  The defaults are nfet:0/Gnd and pfet:1/6/Vdd which
                 correspond to the MOSIS technology file but things might vary in your site.  Ask
                 your local cad administrator.

       The  way  the  extraction  of  node  area  and perimeter works in magic the total area and
       perimeter of the source/drain junction is summed up on a single node.  That is why all the
       junction  areas  and  perimeters  are  summed  up on a single node (this should not affect
       simulation results however).

       Special care must be taken when the substrate of a fet is tied to a node  other  than  the
       default  substrate  (eg in a bootstraping charge pump).  To get the correct substrate info
       in these cases the fet(s) with separate wells should be in their own separate subcell with
       ext:aph  attributes  attached to their sensitive terminals (also all the transistors which
       share sensitive  terminals  with  these  should  be  in  another  subcell  with  the  same
       attributes).

       In addition, all of the options of extcheck(1) are accepted.

SCALING AND UNITS

       If  all  of  the  .ext  files  in the tree read by ext2sim have the same geometrical scale
       (specified in the scale line in each .ext file), this scale is reflected  through  to  the
       output, resulting in substantially smaller .sim files.  Otherwise, the geometrical unit in
       the output .sim file is a centimicron.

       Resistance and capacitance are always output in ohms and femptofarads, respectively.

SEE ALSO

       extcheck(1), ext2dlys(1), ext2spice(1), magic(1), rsim(1), ext(5), sim(5)

AUTHOR

       Walter Scott additions/fixes by Stefanos Sidiropoulos.

BUGS

       Transistor gate capacitance is typically  not  included  in  node  capacitances,  as  most
       analysis  tools  compute  the  gate  capacitance directly from the gate area.  The -c flag
       therefore provides a limit only on non-gate capacitance.  The areas and perimeters of  fet
       sources  and  drains  work  only  with  the  simple  extraction algorithm and not with the
       extresis flow. So you have to model them as linear capacitors (create a special extraction
       style) if you want to extract parasitic resistances with extresis.