home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR3 / LENA.ZIP / LE_APX_A.TXT < prev    next >
Text File  |  1994-01-31  |  10KB  |  265 lines
  1. .
  2.  
  3.  
  4.      APPENDIX A - LENA DATA FILE ORGANIZATION
  5.      ========================================
  6.  
  7.      GENERAL FORMAT
  8.  
  9.      All data files for LENA are essentially text files, alphanumeric
  10.      information recorded in ASCII characters.  In the following
  11.      descriptions, the format of each data field is:
  12.  
  13.         Field = Number of character spaces, total, for one item or value.
  14.  
  15.         Record = Contiguous fields terminated by <CR><LF> (Hex 0D 0A).
  16.                  Note:  There are no field separators or indicators that
  17.                  the first record has begun.
  18.  
  19.         Character string:  An
  20.  
  21.             where:  A = Indicator for character text.
  22.                     n = Maximum Number of characters in data field.
  23.  
  24.             alignment:  Left-justified in data field, blanks (Hex 20)
  25.                         padding trailing byte spaces.
  26.  
  27.             example:  'A48' indicates a 48-character-maximum string.
  28.  
  29.         Integer number:  In
  30.  
  31.             where:  I = Indicator for Integer value.
  32.                     n = Maximum number of characters in data field.
  33.  
  34.             alignment:  Recorded right-justified in data field, blanks
  35.                         (Hex 20) padding in leading character spaces.
  36.  
  37.             polarity:   Positive, unless leading numeral character is
  38.                         preceded by a negative sign (dash, Hex 2D).
  39.  
  40.         Real (floating-point) number:  En.m
  41.  
  42.             where:  E = Indicator for floating point ("has Exponent")
  43.                         value.
  44.                     n = Number of total characters in field.
  45.                     m = Number of characters in fractional part of
  46.                         mantissa.
  47.  
  48.             alignment:  Recorded right-justified in data field, blanks
  49.                         padding in leading character spaces.
  50.  
  51.             sub-field organization, in order, first to last (left-to-
  52.             right):
  53.  
  54.                a.  leading padding blanks (if any)
  55.                b.  Mantissa sign (negative or dash character if Mantissa
  56.                    negative, no indicator character if Mantissa positive).
  57.                c.  integer part of Mantissa (LENA floating-point mantissa
  58.                    integers have only one digit).
  59.                d.  Mantissa decimal point (Hex 2E).
  60.  
  61.  
  62.  
  63.                            LENA Appendix A - Page 1 of 4
  64.  
  65.  
  66. .
  67.  
  68.  
  69.                e.  Mantissa fractional part.
  70.                f.  Letter E (Hex 45, indicates start of decimal exponent).
  71.                g.  Exponent sign (Hex 2B if positive, equal or greater than
  72.                    unity; Hex 2D if negative or less than unity).
  73.                h.  Exponent (LENA always formats 2 exponent digits).
  74.  
  75.             example:  E11.4 format of value -12345 would be -1.2345E+04
  76.                                                                ~~~~      m
  77.                                                             ~~~~~~~~~~~  n
  78.  
  79.  
  80.      A file examination program such as Vernon Buerg's "LIST" may be used
  81.      to examine Data files to see contents in detail.
  82.  
  83.  
  84.      CIRCUIT DATA FILES
  85.      ------------------
  86.  
  87.      ORGANIZATION
  88.  
  89.      The first record of every Circuit file begins with an integer denoting
  90.      the number of total branches in a Circuit.  The total of all following
  91.      records will equal that value.  Second and subsequent records
  92.      correspond to the branches in a Circuit.  Fields in each Record are
  93.      sequential, in order of listing.
  94.  
  95.  
  96.      FIRST RECORD
  97.  
  98.         Format      Description
  99.         ------      ----------------------------------------------------
  100.           I6        Number of branches in circuit.
  101.           I6        Hour in circuit creation/alteration time-date.
  102.           I6        Minutes in circuit creation/alteration time-date.
  103.           I6        Day of month in circuit creation/alteration time-date.
  104.           I6        Month in circuit creation/alteration time-date (1 =
  105.                     January, 12 = December).
  106.           I6        Year of creation/alteration time-date (4 digits).
  107.           A48       Remarks string.
  108.  
  109.      SECOND AND SUBSEQUENT RECORDS
  110.  
  111.         Format      Description
  112.         ------      ---------------------------------------------------
  113.           I6        Branch Type Number, coding:
  114.                        1 = Resistor                  8 = PRC
  115.                        2 = Capacitor                 9 = PRL
  116.                        3 = Inductor                 10 = SIG
  117.                        4 = LQ (inductor with Q)     11 = IDC
  118.                        5 = CQ (capacitor with Q)    12 = GMS
  119.                        6 = SRL                      13 = HFS
  120.                        7 = SRC
  121.                     1xxy = Transformer macromodel (4 digit) *
  122.                     2xxy = Transmission Line macromodel (4 digit) *
  123.                     3xxy = Bipolar Transistor macromodel (4 digit) *
  124.                     4xxy = Operational Amplifier macromodel (4 digit) *
  125.  
  126.                     * xx = 2-digit value equal to single branch type.
  127.     
  128.                            LENA Appendix A - Page 2 of 4
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.                     * y  = 1-digit value equal to macromodel branch order
  137.                            within macro.
  138.  
  139.           A8        Type Description of Branch.
  140.           I4        Plus Node.
  141.           I3        Minus Node.
  142.          E15.7      First Value.
  143.          E15.7      Second Value.
  144.           I5        Switch/Dependent-Branch-Number (minus if Open).
  145.                  
  146.                  
  147.      SOLUTION DATA FILES
  148.      -------------------
  149.      Solution files contain voltage or impedance data at one Node.
  150.      
  151.      FIRST RECORD
  152.  
  153.         Format      Description
  154.         ------      ----------------------------------------------------
  155.           I4        Node of solution.
  156.           I4        Number of frequencies solved for FREquency/IMPedance.
  157.           I4        <not used withe LENA>
  158.         3(I4)       Three internal values for LENA.
  159.           I4        Output format:  PRInt = 1; PLOt = 2
  160.           I4        Output type:  FREquency = 1; IMPedance = 2;
  161.                                   SPEctrum = 3; TIMe = 4; ENVelope = 5
  162.                             [time-related solution types apply only to
  163.                              LINEA files, cannot be handled by LENA]
  164.           A8        Solution filename (without file extension).
  165.           A8        Circuit filename (without file extension), Circuit
  166.                     being the one analyzed-solved.
  167.          A48        Remarks string attached to Circuit analyzed-solved.
  168.         5(I4)       Solution time-date, same hour-minute-day-month-year
  169.                     arrangement as Circuit time-date.
  170.  
  171.      SECOND RECORD
  172.  
  173.         Format      Description
  174.         ------      ----------------------------------------------------
  175.          E17.9      Zero db Reference Voltage.
  176.          E17.9      Most-negative degree scale limit for PLOt (may not
  177.                     apply to recorded solution).
  178.          E17.9      Most-positive degree scale limit for PLOt (may not
  179.                     apply to recorded solution).
  180.  
  181.      THIRD RECORD
  182.  
  183.      Third record quantities are Frequency Limits.
  184.  
  185.         Format      Description
  186.         ------      ----------------------------------------------------
  187.          E17.9      Minimum frequency of solution.
  188.          E17.9      Maximum frequency of solution.
  189.          E17.9      Delta frequency: positive is linear increment while
  190.                     negative's magnitude is multiplier for log increment.
  191.  
  192.  
  193.                            LENA Appendix A - Page 3 of 4 
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      FOURTH AND FOLLOWING RECORDS
  203.  
  204.         Format      Description
  205.         ------      ----------------------------------------------------
  206.          E17.9      Frequency of solution.
  207.          E17.9      Voltage or Impedance magnitude at Frequency.
  208.          E17.9      Voltage or Impedance phase-angle at Frequency.
  209.  
  210.  
  211.      WAVEFORM DATA FILES
  212.      -------------------
  213.  
  214.      LENA, as a smaller sub-set of LINEA, cannot handle repetitive waveform
  215.      solutions.  The following information is given for reference only.
  216.  
  217.         Format      Description
  218.         ------      ----------------------------------------------------
  219.           I4        Number of coefficients, number of records containing
  220.                     rectangular-form complex waveform coefficients.
  221.         5(I5)       Waveform creation time-date, same hour-minute-day-
  222.                     month-year arrangement as Circuit time-date.
  223.          A48        Remarks string, primarily for WAVESPEC use, not used by
  224.                     LENA.
  225.  
  226.      SECOND RECORD
  227.  
  228.         Format      Description
  229.         ------      ----------------------------------------------------
  230.          E15.7      R.F. carrier frequency; if this is Video waveform, will
  231.                     be zero.
  232.          E15.7      Coefficient incremental frequency, inverse of waveform
  233.                     repetition time.
  234.  
  235.      THIRD RECORD
  236.  
  237.         Format      Description
  238.         ------      -----------------------------------------------------
  239.          E15.7      Minimum coefficient frequency; if Video, this is 0.
  240.          E15.7      Maximum coefficient frequency.
  241.  
  242.  
  243.      FOURTH AND FOLLOWING RECORDS
  244.  
  245.      These are number pairs, the number of pairs equal to the number of
  246.      coefficients.  Default value is 200 complex coefficients, but it is
  247.      possible to generate a waveform data file with 100, 50, 25, 12, 6, or
  248.      3 coefficients.
  249.  
  250.         Format      Description
  251.         ------      ----------------------------------------------------
  252.          E15.7      Real part of complex waveform coefficient.
  253.          E15.7      Imaginary part of complex waveform coefficient.
  254.  
  255.  
  256.  
  257.  
  258.  
  259.                            LENA Appendix A - Page 4 of 4
  260.  
  261.  
  262.  
  263. .1/31/94
  264.  
  265.