home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 1 / ARM_CLUB_CD.iso / contents / education / n / spice / docs / FTE / LPR / SCONVERT < prev    next >
Encoding:
Text File  |  1988-01-27  |  4.4 KB  |  199 lines
  1.  
  2.  
  3.  
  4. SCONVERT(1)         UNIX Programmer's Manual          SCONVERT(1)
  5.  
  6.  
  7.  
  8. NAME
  9.      sconvert - convert spice formats
  10.  
  11. SYNOPSIS
  12.      sconvert fromtype fromfile totype tofile
  13.      sconvert fromtype totype
  14.      sconvert
  15.  
  16. DESCRIPTION
  17.      Sconvert translates spice output files among three formats:
  18.      the old binary format, a new binary format, and a new ascii
  19.      format.  The formats are specified by the fromtype and
  20.      totype arguments: `o' for the old format, `b' for the new
  21.      binary format, and `a' for the new ascii format.  Fromtype
  22.      specifies the format to be read, and totype specifies the
  23.      format to be written.  If fromfile and tofile are given,
  24.      then they are used as the input and output, otherwise stan-
  25.      dard input and output are used.  If no arguments are given,
  26.      the parameters are prompted for.
  27.  
  28.      Binary format is the preferred format for general use, as it
  29.      is the most economical in terms of space and speed of
  30.      access, and ascii is provided to make it easy to modify data
  31.      files and transfer them between machines with different
  32.      floating-point formats.  The old format is provided only for
  33.      backward compatibility. The three formats are as follows:
  34.  
  35.      Old:
  36.  
  37.               What          Size in Bytes
  38.  
  39.           title                    80
  40.           date                8
  41.           time                8
  42.           numoutputs               2
  43.           the integer 4            2
  44.           variable names --
  45.                char[numoutputs][8] numoutputs * 8
  46.           types of output               numoutputs * 2
  47.           node index               numoutputs * 2
  48.           plot title               numoutputs * 24
  49.           the actual data               numpoints * numoutputs * 8
  50.  
  51.      Ascii:
  52.  
  53.           Title: Title Card String
  54.           Date: Date
  55.           [ Plotname: Plot Name
  56.             Flags: complex or real
  57.             No. Variables: numoutputs
  58.             No. Points: numpoints
  59.             Command: nutmeg command
  60.  
  61.  
  62.  
  63. Printed 12/9/85          20 January 1985                        1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. SCONVERT(1)         UNIX Programmer's Manual          SCONVERT(1)
  71.  
  72.  
  73.  
  74.             Variables:   0 varname1 typename1
  75.                     1 varname2 typename2
  76.                     etc...
  77.             Values:
  78.               0     n    n    n    n    ...
  79.               1     n    n    n    n    ...
  80.               And so forth...
  81.           ] repeated one or more times
  82.  
  83.  
  84.      If one of the flags is complex, the points look like r,i where r and i
  85.      are floating point (in %e format). Otherwise they are in %e format.
  86.      Only one of real and complex should appear.
  87.  
  88.      The lines are guaranteed to be less than 80 columns wide (unless the
  89.      plot title or variable names are very long), so this format is safe
  90.      to mail between systems like CMS.
  91.  
  92.      Any number of Command: lines may appear between the No. Points:
  93.      and the Variables: lines, and whenever the plot is loaded into
  94.      nutmeg they will be executed.
  95.  
  96.      Binary:
  97.  
  98.           Title Card            (a NULL terminated string)
  99.           Date, Time            (a NULL terminated string)
  100.           [
  101.             Plot title          (a NULL terminated string)
  102.             Number of variables   (an int)
  103.             Number of data points (an int)
  104.             flags          (a short)
  105.             variable header struct (repeated numoutputs times)
  106.                variable name    (a NULL terminated string)
  107.                variable type    (an int)
  108.             set of outputs      (repeated numpoints times)
  109.           ] repeated one or more times.
  110.  
  111.  
  112.      A set of outputs is a vector of doubles of length numoutputs, or
  113.      a vector of real-imaginary pairs of doubles if the data is complex.
  114.  
  115. SEE ALSO
  116.      spopshow(1), nutmeg(1), spice(1), spop(1)
  117.  
  118. AUTHOR
  119.      Wayne Christopher (faustus@cad.berkeley.edu)
  120.  
  121. BUGS
  122.      If variable names and the title and plotname strings have
  123.      trailing blanks in them they will be stripped off when the
  124.      file is read, if it is in ascii format.
  125.  
  126.  
  127.  
  128.  
  129. Printed 12/9/85          20 January 1985                        2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. SCONVERT(1)         UNIX Programmer's Manual          SCONVERT(1)
  137.  
  138.  
  139.  
  140.      If a plot title begins with "Title:" nutmeg will be fooled
  141.      into thinking that this is an ascii format file. Sconvert
  142.      always requires the type to be specified, however.
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195. Printed 12/9/85          20 January 1985                        3
  196.  
  197.  
  198.  
  199.