home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 12 / CD_ASCQ_12_0294.iso / maj / 969 / pc_ecap.doc < prev    next >
Text File  |  1994-01-23  |  113KB  |  2,455 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.                                   P C - E C A P
  21.  
  22.                                    Version 3.01
  23.  
  24.  
  25.  
  26.  
  27.                              Program Reference Manual
  28.  
  29.  
  30.                       Copyright (c) 1990-94 by Peter Volpa
  31.                                All Rights Reserved
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.                               _______
  45.                          ____|__     |                (R)
  46.                       --|       |    |-------------------
  47.                         |   ____|__  |  Association of
  48.                         |  |       |_|  Shareware
  49.                         |__|   o   |    Professionals
  50.                       -----|   |   |---------------------
  51.                            |___|___|    MEMBER
  52.  
  53.  
  54.  
  55.                                    Peter Volpa
  56.                                  Circuit Systems
  57.                                  418 Church Road
  58.                           Sicklerville, NJ 08081-1727  USA
  59.  
  60.  
  61.  
  62.  
  63.                                 Table of Contents
  64.                                 -----------------
  65.  
  66.  
  67.  
  68.           Introduction . . . . . . . . . . . . . . . . . . . . .  1
  69.               License  . . . . . . . . . . . . . . . . . . . . .  2
  70.               Ordering Information . . . . . . . . . . . . . . .  3
  71.                 (also registering by credit card)
  72.               Disclaimer, Trademarks, ASP info . . . . . . . . .  4
  73.               System Requirements  . . . . . . . . . . . . . . .  5
  74.               Installing PC-ECAP . . . . . . . . . . . . . . . .  6
  75.  
  76.           Quick Start  . . . . . . . . . . . . . . . . . . . . .  7
  77.  
  78.           Miscellaneous program information :
  79.               Printer configuration  . . . . . . . . . . . . . .  8
  80.               Data format  . . . . . . . . . . . . . . . . . . .  9
  81.               Accessing data files in other directories  . . . .  9
  82.               Memory requirements vs. maximum circuit nodes  . .  9
  83.               Network / Multi-User operation . . . . . . . . . .  10
  84.  
  85.           Getting Started  . . . . . . . . . . . . . . . . . . .  11
  86.           Main Menu Descriptions . . . . . . . . . . . . . . . .  11
  87.               Select input file  . . . . . . . . . . . . . . . .  11
  88.               Edit input file  . . . . . . . . . . . . . . . . .  12
  89.               Analyze circuit  . . . . . . . . . . . . . . . . .  16
  90.                 Plotting results . . . . . . . . . . . . . . . .  17
  91.               View output data . . . . . . . . . . . . . . . . .  18
  92.               Output to printer  . . . . . . . . . . . . . . . .  18
  93.               Change program settings  . . . . . . . . . . . . .  19
  94.                 (number of sample points, printer type, etc.)
  95.               Quit this program  . . . . . . . . . . . . . . . .  20
  96.  
  97.           Analyzing a Circuit Using PC-ECAP  . . . . . . . . . .  21
  98.               Input format . . . . . . . . . . . . . . . . . . .  22
  99.               Circuit element description  . . . . . . . . . . .  23
  100.               Specifying AC analysis parameters  . . . . . . . .  26
  101.                 (group delay, impedance, vswr, return loss)
  102.               Specifying transient analysis parameters . . . . .  28
  103.               Computational techniques for transient analysis  .  30
  104.               An example!  . . . . . . . . . . . . . . . . . . .  33
  105.               An example of transient analysis . . . . . . . . .  34
  106.               Another example (using the Model Maker)  . . . . .  36
  107.  
  108.           Models . . . . . . . . . . . . . . . . . . . . . . . .  38
  109.               References for modeling  . . . . . . . . . . . . .  39
  110.  
  111.           Revision History . . . . . . . . . . . . . . . . . . .  40
  112.  
  113.           Appendix A - Command Line Switches . . . . . . . . . .  42
  114.           Appendix B - Error Messages  . . . . . . . . . . . . .  43
  115.           Appendix C - PC-ECAP to Lotus 1-2-3 file conversion  .  48           PC-ECAP Reference Manual                          page 1
  116.  
  117.           Introduction
  118.  
  119.           PC-ECAP is an easy to use AC circuit analysis program which
  120.           analyzes circuits consisting of resistors, capacitors,
  121.           inductors, transformers, transmission lines, transistors
  122.           (both bipolar and FET's), operational amplifiers and
  123.           transconductance amplifiers.
  124.  
  125.           Totally integrated in one package, it contains a full screen
  126.           text editor for preparing analysis input, an electronic
  127.           circuit analyzer that calculates your circuit's frequency
  128.           and transient response, a high resolution display plotter
  129.           that supports all common graphics adapters and a high
  130.           resolution plotter compatible with most printers.
  131.  
  132.  
  133.           Features:
  134.  
  135.                *    Calculates Magnitude, Phase, Group Delay,
  136.                     Impedance, VSWR and Return Loss.
  137.  
  138.                *    Calculates Transient response for step, pulse,
  139.                     ramp, square wave, triangle wave and sine wave
  140.                     inputs.  Can also calculate impulse response.
  141.  
  142.                *    Completely menu driven - very easy to use.
  143.  
  144.                *    Can analyze circuits with up to 90 nodes,
  145.                     and with as many as 1000 components.
  146.  
  147.                *    Built in full screen editor with on-line help
  148.                     function.
  149.  
  150.                *    Free input format - common abbreviations such as
  151.                     P, U, N, M, K, MEG, G are recognized.  For
  152.                     example if your circuit has a 47pf capacitor, all
  153.                     you need to enter for its value is 47pf.
  154.  
  155.                *    Supports CGA, EGA, VGA, Hercules, MCGA, AT&T and
  156.                     even the Monochrome Display Adapter.
  157.  
  158.                *    All calculations are done in 15 digits of double
  159.                     precision.
  160.  
  161.                *    High resolution plots on IBM/Epson 9 and 24 pin
  162.                     compatible printers, HP LaserJet, and HP DeskJet.
  163.  
  164.                *    Program may be configured to send its output to
  165.                     LPT1, LPT2, LPT3 or a disk file.
  166.  
  167.                *    Bipolar transistor model maker.  Just enter your
  168.                     transistor's operating parameters and PC-ECAP will
  169.                     create a Hybrid-Pi model for your transistor.
  170.  
  171.                *    Will utilize a math coprocessor if available, but
  172.                     does NOT require one.
  173.  
  174.                *    Built-in network / multi-user support.           PC-ECAP Reference Manual                          page 2
  175.  
  176.           License
  177.  
  178.           PC-ECAP is distributed as "shareware".  It is NOT public
  179.           domain or free software.
  180.  
  181.           Non-registered users of this software are given the
  182.           opportunity to evaluate the complete PC-ECAP software
  183.           package for 30 days with no obligation.  If, after the
  184.           evaluation period, you find PC-ECAP to be suitable for your
  185.           needs, you must register your copy or discontinue using
  186.           PC-ECAP.
  187.  
  188.           What we're saying is if you use this program, then you
  189.           should pay for your copy.  That way Circuit Systems will be
  190.           able to provide updates, support, and generally stay in
  191.           business.
  192.  
  193.           PC-ECAP is distributed in two forms: a registered version
  194.           and an unregistered version.  The unregistered version is a
  195.           fully-functional program that has all the features of the
  196.           registered version.  However, the unregistered version
  197.           requires the user to go through an initialization procedure
  198.           each time PC-ECAP is started.  The initialization procedure
  199.           requires the user to enter a random number before PC-ECAP
  200.           will run.  The registered version does not have this
  201.           initialization procedure.
  202.  
  203.           The REGISTERED version of PC-ECAP is LICENSED TO THE SINGLE
  204.           PERSON WHO REGISTERED THE PROGRAM AND MAY NOT BE DISTRIBUTED
  205.           IN ANY MANNER.
  206.  
  207.           All users are granted a limited license to copy the
  208.           UNREGISTERED version of PC-ECAP for the trial use of others.
  209.           This license does NOT include distribution or copying of
  210.           this software:
  211.  
  212.  
  213.                *    In conjunction with any other product or service.
  214.  
  215.                *    In general use within a company or school.
  216.  
  217.                *    For any "disk fee" other than a small (generally
  218.                     $2.00 to $5.00) copying charge.
  219.  
  220.                *    For distribution in any modified form.  The file
  221.                     containing this license information MUST be
  222.                     included along with full documentation and all
  223.                     the files that make up this software package.           PC-ECAP Reference Manual                          page 3
  224.  
  225.           Ordering Information
  226.  
  227.           A PC-ECAP registration licenses you to use the product on a
  228.           regular basis.  Registration also entitles you to technical
  229.           support, update notices, and enables you to get future
  230.           releases of PC-ECAP at a minimal price.
  231.  
  232.           Individual registrations come in two forms.  The first,
  233.           registration only, costs $89 (plus $2.00 shipping and
  234.           handling).  Upon receipt of your paid registration form, we
  235.           will send you the latest registered version of PC-ECAP with
  236.           documentation on the disk.  We also offer PC-ECAP with a
  237.           printed manual.  For $99 (plus $4.00 shipping and handling)
  238.           we will send you the latest registered version of PC-ECAP
  239.           along with a professionally printed bound manual.  New
  240.           Jersey residents should include 6% sales tax.
  241.  
  242.           Site licensing is also available.  Prices are based on the
  243.           estimated number of users.  Please write for more
  244.           information.
  245.  
  246.           A PC-ECAP registration form is included in the distribution
  247.           package for your convenience.  It is in the file ORDERFRM.
  248.           Please take time to fill it out and return it.  If you would
  249.           like high-quality software to continue to be made available
  250.           on a try-first basis and for a reasonable cost, it is up to
  251.           YOU to support such programs.
  252.  
  253.           Please send your registration form, suggestions and any
  254.           comments that you might have to:
  255.  
  256.                     Peter Volpa         or       For questions only,
  257.                   Circuit Systems                 no orders.  Call
  258.                   418 Church Road                  (609) 875-5433
  259.             Sicklerville, NJ  08081-1727           12 - 10 PM EST
  260.  
  261.           Questions may also be sent by Email on CompuServe to
  262.           72202,3043 or via the Internet at '72202.3043@compuserve.com'.
  263.           I check for mail only about once a week, so it might be just
  264.           as quick to write if you live in the U.S.A.
  265.  
  266.  
  267.           Registering PC-ECAP by Credit Card
  268.  
  269.           We have established a special arrangement with the Public
  270.           (software) Library for those of you who wish to order by
  271.           credit card.  For credit card orders only, you can order
  272.           from PsL with your Master Card, Visa, AmEx or Discover card
  273.           by calling (800) 2424-PsL or (713) 524-6394.  You may also
  274.           FAX to (713) 524-6398 or CompuServe to 71355,470 or mail to
  275.           PsL, P.O. Box 35705, Houston, TX 77235-5705.  These numbers
  276.           are for ordering only.  For information about volume
  277.           discounts, site licensing, shipping of product, returns,
  278.           latest version number or other technical information, please
  279.           write to Circuit Systems or call (609) 875-5433.  All credit
  280.           card orders will be charged $4 for Shipping and Handling.           PC-ECAP Reference Manual                          page 4
  281.  
  282.           DISCLAIMER
  283.  
  284.           ALTHOUGH WE HAVE EXTENSIVELY TESTED PC-ECAP AND BELIEVE IT
  285.           WILL GIVE ACCURATE RESULTS IF USED CORRECTLY, WE SUPPLY THIS
  286.           PROGRAM AS IS.  CIRCUIT SYSTEMS DISCLAIMS ALL WARRANTIES,
  287.           EXPRESSED OR IMPLIED, THAT THIS PROGRAM IS FIT FOR ANY
  288.           PURPOSE.  CIRCUIT SYSTEMS ALSO ASSUMES NO LIABILITY FOR ANY
  289.           DAMAGES EITHER DIRECT OR CONSEQUENTIAL, WHICH MAY RESULT
  290.           FROM THE USE OF THIS PROGRAM.
  291.  
  292.  
  293.           Trademarks
  294.  
  295.           MS-DOS and Excel are registered trademarks of Microsoft
  296.                Corporation.
  297.  
  298.           PC-DOS, PC/AT, PC/XT, and PS/2 are registered trademarks of
  299.                IBM Corporation.
  300.  
  301.           Compaq is a registered trademark of Compaq Computer Corp.
  302.  
  303.           Hercules is a registered trademark of Hercules Computer
  304.                Technology.
  305.  
  306.           AT&T is a registered trademark of American Telephone and
  307.                Telegraph Company.
  308.  
  309.           Olivetti is a registered trademark of Ing. C. Olivetti.
  310.  
  311.           LaserJet and DeskJet are registered trademarks of
  312.                Hewlett-Packard Company.
  313.  
  314.           Lotus and 1-2-3 are registered trademarks of Lotus
  315.                Development Corporation.
  316.  
  317.           Quattro Pro is a registered trademark of Borland
  318.                International Corp.
  319.  
  320.           AS-EASY-AS is a trademark of TRIUS, Inc.
  321.  
  322.  
  323.           Association of Shareware Professionals
  324.  
  325.           This program is produced by a member of the Association of
  326.           Shareware Professionals (ASP).  ASP wants to make sure that
  327.           the shareware principle works for you. If you are unable to
  328.           resolve a shareware-related problem with an ASP member by
  329.           contacting the member directly, ASP may be able to help. The
  330.           ASP Ombudsman can help you resolve a dispute or problem with
  331.           an ASP member, but does not provide technical support for
  332.           members' products.  Please write to the ASP Ombudsman at 545
  333.           Grover Road, Muskegon MI 49442-9427 or send a Compuserve
  334.           message via CompuServe Mail to ASP Ombudsman 70007,3536.
  335.           The OMB may be contacted by FAX by sending to the ASP FAX
  336.           number: (616) 788-2765.  In communication with the OMB
  337.           please include a telephone number and/or FAX if available.           PC-ECAP Reference Manual                          page 5
  338.  
  339.           System Requirements:
  340.  
  341.  
  342.                *    IBM PC, XT, AT, PS/2 or compatible.
  343.  
  344.                *    PC or MS-DOS 2.0 or later.
  345.  
  346.                *    One floppy disk drive.
  347.  
  348.                *    384K of system memory.
  349.  
  350.                *    A graphics card is recommended for best
  351.                     performance.  But if all you have is a Monochrome
  352.                     Display Adapter, PC-ECAP will even graph its
  353.                     results on that - though the resolution will be
  354.                     much lower.
  355.  
  356.                *    An IBM/Epson, HP LaserJet or HP DeskJet compatible
  357.                     printer if hard copy is desired.  Most printers
  358.                     used with IBM and IBM compatible computers support
  359.                     one of these standards.
  360.  
  361.  
  362.  
  363.           Attention users of MS-DOS version 3.2
  364.  
  365.  
  366.           Version 3.20 of MS-DOS contains a bug that can cause
  367.           unexpected results in programs that use floating-point math
  368.           (eg. PC-ECAP).
  369.  
  370.           You do not need to read any further unless your system has
  371.           ALL of the following characteristics:
  372.  
  373.               1.    You use MS-DOS version 3.20.
  374.               2.    You boot from a hard-disk drive.
  375.               3.    Your system has a math coprocessor (for instance,
  376.                     an 8087 chip).
  377.               4.    You run programs that use floating-point math
  378.                     (eg. PC-ECAP).
  379.  
  380.           For systems that satisfy all of the preceding conditions,
  381.           you may be able to eliminate floating-point math problems by
  382.           installing a small patch in DOS.  Please contact Microsoft
  383.           for complete details on this.
  384.  
  385.           Since this bug has been fixed in later versions of MS-DOS,
  386.           you may also want to consider upgrading your DOS to a more
  387.           recent version.           PC-ECAP Reference Manual                          page 6
  388.  
  389.           Before You Begin
  390.  
  391.           The very first thing that you should do before going any
  392.           further is to make a backup copy of your distribution disk.
  393.           To do this just use the DOS command DISKCOPY.  This will
  394.           work whether or not you have two floppy disk drives.  It
  395.           also doesn't matter if the diskette that you want to copy to
  396.           is formatted or not.  DISKCOPY will format it for you.
  397.  
  398.           From the DOS prompt type this:
  399.  
  400.                DISKCOPY A: B:
  401.  
  402.           You will be asked to "Insert source diskette in drive A:"
  403.           This should be your original PC-ECAP disk.  Continue to
  404.           follow the directions on the screen and you will have your
  405.           backup copy.
  406.  
  407.  
  408.           Installing PC-ECAP
  409.  
  410.           We have included an "Install" program with PC-ECAP to make
  411.           installation very easy.  The Install program will not do
  412.           anything "funny".  It will not modify your AUTOEXEC.BAT or
  413.           your CONFIG.SYS files.  What it will do is create a
  414.           subdirectory on your hard drive called "\ECAP".  Then it
  415.           will copy all the needed PC-ECAP files from your floppy
  416.           drive to that subdirectory.  If you have any PC-ECAP program
  417.           files (NOT data files) prior to version 2.0, they will be
  418.           deleted.  That's all.  It is strictly for your convenience.
  419.           The default "from" drive is the drive where INSTALL.EXE is
  420.           located and the default "to" drive is drive C:.  These may
  421.           be changed to any other drives or directories as needed.
  422.  
  423.           If you don't have a hard drive, you don't need to proceed
  424.           any further.  Skip the rest of this section and use your
  425.           backup copy as your working disk.
  426.  
  427.           To use the install program, insert your backup copy of
  428.           PC-ECAP into your floppy drive and type:
  429.  
  430.                     A:INSTALL
  431.  
  432.           Follow the directions and before you know it, you will have
  433.           PC-ECAP on your hard drive.           PC-ECAP Reference Manual                          page 7
  434.  
  435.           Quick Start
  436.  
  437.           Although there is no substitute for reading this entire
  438.           manual, I know there are those of you who can't wait to try
  439.           a new program.  So for those who like to try-first-read-
  440.           later, this will give you a taste of what PC-ECAP can do.
  441.  
  442.           Start PC-ECAP by typing:
  443.  
  444.                ECAP
  445.  
  446.           at the DOS prompt.
  447.  
  448.           From the main menu choose the "Select input file" selection.
  449.           Select EXAMPLE1.DAT as your input file.  The circuit
  450.           described by EXAMPLE1.DAT is a simple RC low-pass filter and
  451.           is shown below.
  452.  
  453.  
  454.                         1        1.59K                 2
  455.                          ------/\/\/\/\------*---------
  456.                                              |
  457.                                              |
  458.                input                      ___|___  .1uf      output
  459.                                           _______
  460.                                              |
  461.                                              |
  462.                                           0  |
  463.                          --------------------*----------
  464.  
  465.  
  466.           Now from the main menu choose "Analyze circuit".  The
  467.           analysis will begin and you will see the results as the
  468.           program progresses.  When the analysis is complete, the
  469.           results will be plotted on your display.  First you will see
  470.           a plot of Magnitude vs. Frequency.  If you press any key
  471.           other than ESC you will get a plot of Phase vs. Frequency.
  472.           Pressing any key (other than ESC) again will show you
  473.           Magnitude again.  When you are finished, press ESC to return
  474.           to the main menu.
  475.  
  476.           As I said, this is a taste - for the details read on.           PC-ECAP Reference Manual                          page 8
  477.  
  478.           Printer Configuration
  479.  
  480.           PC-ECAP supports four printer types.  To properly print on
  481.           your printer, you must configure the program for the printer
  482.           that you are using.  The "Change program settings" choice of
  483.           the main menu has an option to "Pick a printer to use".
  484.           Select your printer from the list given.  One of these types
  485.           should be a good match for your printer.  Refer to the
  486.           "Change program settings" section in the manual for more
  487.           details.  Be sure to save your choice.
  488.  
  489.           There might be times when you want to print on single sheets
  490.           of paper instead of the more common continuous forms paper.
  491.           If this is the case, you will need to use the DOS MODE
  492.           command before running PC-ECAP.
  493.  
  494.           Each time that a single page has completed printing, the
  495.           printer stops and returns an error.  Depending on the
  496.           printer, this error may be "OFF-LINE" or "OUT-OF-PAPER".  In
  497.           any case, what gets reported to the program is a "WRITE
  498.           FAULT ERROR".  PC-ECAP was unable to write to the printer.
  499.  
  500.           The DOS MODE command provides a way around this problem.
  501.           MODE will enable an "infinite retry on printer".  Which
  502.           really means - return a printer busy signal and continue
  503.           retrying until the printer accepts the output.  When this is
  504.           done, a "WRITE FAULT ERROR" will not be reported to PC-ECAP
  505.           and the program will simply wait for the next sheet of
  506.           paper.
  507.  
  508.           If your DOS version is 4.01 or less, type this before
  509.           running PC-ECAP:
  510.  
  511.                MODE LPT1:,,P
  512.  
  513.           If you are running DOS 5 or DOS 6, MODE has a slightly
  514.           different format:
  515.  
  516.                MODE LPT1: RETRY=B
  517.  
  518.           If you are printing to a printer other than LPT1, you should
  519.           change the MODE command accordingly.  See your DOS manual if
  520.           you need more help on this.
  521.  
  522.           If you need to use the MODE command you should add it to
  523.           your AUTOEXEC.BAT file.  This setup will install it
  524.           automatically.           PC-ECAP Reference Manual                          page 9
  525.  
  526.           Users of PC-ECAP versions prior to version 2.0
  527.  
  528.           Before version 2.0, all numbers were represented and stored
  529.           in BCD format.  With version 2.0, numbers are now stored in
  530.           IEEE binary format.  However, PC-ECAP can read any result
  531.           files stored in BCD.  When you access an old file you will
  532.           see the message "Converting file format . . .".  This
  533.           conversion is done "on the fly", meaning the converted file
  534.           is not saved.  To avoid this file conversion every time you
  535.           view an old file, simply rerun an analysis.
  536.  
  537.  
  538.           Accessing PC-ECAP Circuit Files in Other Directories
  539.  
  540.           If you are running DOS 3.0 or later you may easily work with
  541.           circuit files in other directories or on other drives.  To
  542.           do this you must have the directory that contains the
  543.           PC-ECAP program files listed in your PATH.  You should have
  544.           a line similar to this in your AUTOEXEC.BAT file:
  545.  
  546.                PATH=C:\ECAP
  547.  
  548.           Yours will not be EXACTLY like this one.  You may have
  549.           additional directories listed or the drive letter may be
  550.           different.  The important thing is that the PC-ECAP drive
  551.           and directory be part of the PATH.  You may want to refer to
  552.           your DOS manual if you need more information on this.
  553.  
  554.           Once your PATH is set up, DOS will know where to find
  555.           PC-ECAP no matter where you are.  And under DOS 3.0 or
  556.           later, PC-ECAP will know where to find any additional files
  557.           it needs to run.
  558.  
  559.  
  560.           Memory Requirements
  561.  
  562.           As of PC-ECAP version 2.1, you can analyze circuits with up
  563.           90 nodes.  Older versions of the program had a limit of 40
  564.           nodes.  Analysis of a 90 node circuit requires that you have
  565.           450K bytes of free memory.  That is, memory left after you
  566.           load any memory resident programs.  If you don't have this
  567.           much memory available, don't worry.  You will just be
  568.           limited to circuits having fewer nodes.  If you have less
  569.           than 450K free, PC-ECAP will give you its estimate of the
  570.           largest circuit that you may analyze on program start up.
  571.           Keep in mind that this is an estimate and therefore it is
  572.           not exact.  Therefore, if you are told that you have enough
  573.           memory to analyze circuits with up 57 nodes, and you have a
  574.           circuit with 58, give it a try.  It may very well work.
  575.  
  576.           Also please note, that since node numbers start at 0, the
  577.           highest possible node number is 89.           PC-ECAP Reference Manual                          page 10
  578.  
  579.           PC-ECAP can also use upper memory blocks (UMB's) for its
  580.           memory needs.  You must be running DOS 5 or greater and have
  581.           a line similar to the following in your CONFIG.SYS file:
  582.  
  583.                DOS=UMB
  584.  
  585.           You can check on UMB availability with the DOS MEM command.
  586.           Typing "MEM /C" will list the conventional and upper memory
  587.           in your system.  If no upper memory is listed, either your
  588.           hardware doesn't support UMB's or your system is not set up
  589.           properly.  See your DOS manual if you need help with this.
  590.           PC-ECAP will try to use any free upper memory listed.
  591.  
  592.           The estimate given at program startup will not take into
  593.           account any UMB's.  These blocks can be highly fragmented,
  594.           so it is not possible to know if they are large enough to
  595.           use until they are needed.
  596.  
  597.  
  598.           Network / Multi-User Operation
  599.  
  600.           PC-ECAP has built-in support to run on a local area network.
  601.           Your network must support DOS file-sharing (added with DOS
  602.           version 3.0).  When running on a network, multiple users may
  603.           share circuit description and analysis result files.
  604.  
  605.           PC-ECAP imposes two main restrictions when accessing files
  606.           on a network.  If a file is being edited, no one else may
  607.           run an analysis on it.  If a circuit is being analyzed, no
  608.           one may view or output the results until the analysis is
  609.           complete.  In general, individual file access at any one
  610.           time is restricted to operations that make sense.  For
  611.           example, a circuit whose analysis is only partially complete
  612.           can't be viewed.  Of course you may do any operation you
  613.           choose if you are the only person using a particular file.
  614.  
  615.           If you attempt to access a file that is already in use,
  616.           PC-ECAP will display the message, "File is currently being
  617.           used by someone else".  You may wait until that file is
  618.           available or you may choose to work on a different file.
  619.  
  620.           You should also be aware that PC-ECAP maintains a single
  621.           configuration file.  So if you change some of the program
  622.           settings, and then write these changes to disk, the next
  623.           person on the network to run the program will get these new
  624.           settings.           PC-ECAP Reference Manual                          page 11
  625.  
  626.           Getting Started
  627.  
  628.           PC-ECAP is started by typing the following command at the
  629.           DOS prompt:
  630.  
  631.                     ECAP   [ options ]
  632.  
  633.           The optional command line switches are used to manually set
  634.           the video mode.  Since PC-ECAP is usually able to do this
  635.           automatically, these options should not be needed by 99% of
  636.           computers.  They are covered separately in Appendix A.  If
  637.           you have trouble seeing the main menu after the opening
  638.           screen, please refer to this appendix.
  639.  
  640.           When PC-ECAP is started, you will first see the main menu.
  641.           The program has been designed to be very easy to use, and
  642.           the menu system plays an important part in reaching this
  643.           goal.  All menu choices may be selected in either one of two
  644.           ways.  First, a selection may be made by typing the first
  645.           letter of an item.  These are highlighted so they stand out.
  646.           Selection may also be made by using the cursor keys (up
  647.           arrow, down arrow, home and end) to highlight a choice.
  648.           When "ENTER" is pressed the selection is made.  The program
  649.           will do its best to logically anticipate your next choice.
  650.           For example, after editing a circuit description and
  651.           returning to the main menu, the choice "Analyze circuit"
  652.           will be highlighted - assuming that after editing, you most
  653.           likely will want to analyze your circuit.
  654.  
  655.           MAIN MENU Descriptions
  656.  
  657.           Select input file
  658.  
  659.                This selection will display an alphabetically sorted
  660.                list of all the circuit description files in your
  661.                current directory.  Use the cursor keys to select a
  662.                file to use.  If you see "more . . ." displayed at the
  663.                beginning or end of the list, this means that there are
  664.                additional files on another page.  You can use the PgUp
  665.                or PgDn keys in addition to the up arrow, down arrow,
  666.                left arrow, right arrow, home and end keys to view
  667.                them.  Once your choice is highlighted just press ENTER
  668.                to select it.
  669.  
  670.                PC-ECAP also has a "Speed Search" feature.  To use it,
  671.                type the first letter of the file that you want to
  672.                select, followed by enough letters to uniquely specify
  673.                it.  In most cases all it takes is 2 or 3 letters.
  674.                Your desired file will be highlighted.  Press ENTER to
  675.                select it.           PC-ECAP Reference Manual                          page 12
  676.  
  677.                If you want to select a file that is not listed (for
  678.                example - a new circuit description that you want to
  679.                input) press F2.  A window will appear asking for the
  680.                filename.  Type the filename and press ENTER.  All
  681.                filenames should be eight characters or less in length.
  682.                If you type in more than eight, only the first eight
  683.                will be accepted.  A file extension is optional, if it
  684.                is omitted the extension ".DAT" will be appended to the
  685.                filename.  If a filename has an extension other than
  686.                ".DAT", the ".DAT" extension will be substituted in its
  687.                place.
  688.  
  689.                You can delete a highlighted file by pressing F3.  When
  690.                you do so, a window will appear asking, "Delete File?".
  691.                Answer "Yes" to delete.  "No" or ESC will abort the
  692.                operation.
  693.  
  694.           If at any time you want to abort the current operation,
  695.           pressing the ESC key will return you one level up in the
  696.           program.
  697.  
  698.           Edit input file
  699.  
  700.                This starts the built-in full screen editor.  The file
  701.                that you want to edit must be selected first.  If no
  702.                file is selected, you will be sent to the "Select input
  703.                file" screen and then returned to the editor.
  704.  
  705.                The editor is very straight forward to use, just type
  706.                each line followed by the ENTER key.  When in the
  707.                editor these keys have special meaning:
  708.  
  709.                Right Arrow  - move one character to the right.
  710.  
  711.                Left Arrow   - move one character to the left.
  712.  
  713.                Home         - move to the beginning of the line.
  714.  
  715.                End          - move to the end of the line.
  716.  
  717.                Up Arrow     - move one line up.
  718.  
  719.                Down Arrow   - move one line down.
  720.  
  721.                Ctrl Home    - move to the beginning of the file.
  722.  
  723.                Ctrl End     - move to the end of the file.
  724.  
  725.                PgDn         - move 20 lines down.
  726.  
  727.                PgUp         - move 20 lines up.
  728.  
  729.                Del          - will delete the character directly above
  730.                               the cursor.           PC-ECAP Reference Manual                          page 13
  731.  
  732.                Backspace    - will delete the character to the left of
  733.                               the cursor.
  734.  
  735.                Tab          - move cursor 4 spaces to the right.
  736.  
  737.                Shift-Tab    - move cursor 4 spaces to the left.
  738.  
  739.                Ins          - will toggle between the insert and
  740.                               replace modes.  In the insert mode the
  741.                               cursor will change to a block cursor and
  742.                               any characters typed will be inserted
  743.                               between any characters already on the
  744.                               screen.  When in replace mode, any
  745.                               characters typed will type over those on
  746.                               the screen.
  747.  
  748.                In addition to these special keys, five function keys
  749.                have special meaning.  Press them alone or in
  750.                combination with the "Alt" key to access the following
  751.                features.
  752.  
  753.                F1 Help
  754.  
  755.                     One of the features that has been added to make
  756.                     PC-ECAP easy to use is the on-line help.  When F1
  757.                     is pressed a window will appear containing useful
  758.                     information on items such as circuit element
  759.                     description formats, analysis range and sweep
  760.                     type, value types and examples.  You can move
  761.                     through these with the PgUp and PgDn keys.  When
  762.                     you are ready to continue editing, pressing F1
  763.                     again or the ESC key will close the window and let
  764.                     you edit.
  765.  
  766.                F2 Model Maker
  767.  
  768.                     The model maker allows you to more accurately
  769.                     model bipolar transistors.  The transistor model
  770.                     used is the Hybrid-Pi model.  Despite its
  771.                     simplicity, this model gives quite good results
  772.                     for analysis up to about one half of the
  773.                     transistor's cutoff frequency (Ft).
  774.  
  775.                     When the model maker is activated, a window will
  776.                     appear.  You will first be asked for the node
  777.                     numbers of the transistor.  Enter these pressing
  778.                     the ENTER key after each entry for base, emitter,
  779.                     and collector.  You next have to answer four
  780.                     questions.  You will be asked (and need to know)
  781.                     the following:
  782.                     
  783.                     Transistor DC collector current - hopefully you
  784.                     will know this.  If not, try your best guess.           PC-ECAP Reference Manual                          page 14
  785.  
  786.                     Transistor current gain or Beta - since the gain
  787.                     of bipolar transistors varies with collector
  788.                     current, the number that you enter here should be
  789.                     at the collector current specified above for best
  790.                     results.  Usually it is available in the data
  791.                     sheet for the transistor.
  792.  
  793.                     Transistor Gain-Bandwidth product (Ft) - this also
  794.                     should be at the collector current entered above
  795.                     (check the data sheet).
  796.  
  797.                     Transistor common base output capacitance - this
  798.                     is just the base to collector capacitance.
  799.                     Usually it is listed as Cobo in the transistor
  800.                     data.  (Which means output capacitance common base
  801.                     with the emitter open).
  802.  
  803.                     After all the information is entered, the window
  804.                     will close and components for the model will be
  805.                     inserted into your circuit description after the
  806.                     current cursor line.
  807.  
  808.                F3 Insert Line
  809.  
  810.                     Pressing F3 will insert a blank line above the
  811.                     current cursor line and move the cursor line and
  812.                     all lines below it down.
  813.  
  814.                F4 Delete Line
  815.  
  816.                     Pressing F4 will delete the current cursor line
  817.                     and move all lines below it up.  The deleted line
  818.                     will be placed in the cut buffer and can be pasted
  819.                     if desired.
  820.  
  821.                F5 Find Component
  822.  
  823.                     The Find Component feature is useful to find
  824.                     circuit elements in your circuit description file.
  825.                     Just press F5, enter the element to be found, and
  826.                     the line containing the element will be
  827.                     highlighted with the cursor positioned there.  If
  828.                     the element does not exist, a "Component not
  829.                     found" message will appear.
  830.  
  831.                Alt-F1 Net List
  832.  
  833.                     This feature can make it easier to track down
  834.                     errors in your circuit description.  The Net List
  835.                     is a node by node list of all the circuit elements
  836.                     that make up your description.  By comparing the
  837.                     connections in this list to your circuit's
  838.                     schematic, you can verify that your circuit is
  839.                     described properly.           PC-ECAP Reference Manual                          page 15
  840.  
  841.                     When the Net List is selected, you will be asked
  842.                     whether you want your list sent to the screen or
  843.                     to a defined printer.  If you select screen, a
  844.                     window will appear listing your circuit's nodes
  845.                     and their attached components.  Use the cursor
  846.                     keys to move through this list.  To close this
  847.                     window and return to editing, just press ESC.
  848.  
  849.                Alt-F2 Rename File
  850.  
  851.                     You may change the name of a circuit description
  852.                     file by selecting "Rename File".  A window will
  853.                     appear asking for your new file name.  Type the
  854.                     new name and press ENTER.  ESC will close the
  855.                     window and leave the existing file name unchanged.
  856.                     When you rename and save a file, the old named
  857.                     file will still exist.  This is useful if you have
  858.                     a circuit that is very similar to an existing
  859.                     circuit description.  You can modify the existing
  860.                     description and save it under a new name. If you
  861.                     want to delete the old named file, you can do so
  862.                     from the "Select input file" menu.
  863.  
  864.                Alt-F3 Paste Line
  865.  
  866.                     This option will insert a line saved in the cut
  867.                     buffer above the current cursor line and move the
  868.                     cursor line and all lines below it down.
  869.  
  870.                Alt-F4 Copy Line
  871.  
  872.                     Will copy the current line into the cut buffer.
  873.                     Used with the Paste Line feature above.
  874.  
  875.                Alt-F5 Find Next
  876.  
  877.                     This will find the next component meeting your
  878.                     search criteria as specified under "Find
  879.                     Component".  If you have asked for a unique
  880.                     component, you won't be able to find a "next".
  881.                     This option is most useful when you want to find
  882.                     all occurrences of a part, such as all capacitors
  883.                     or all resistors, etc.
  884.  
  885.                Leaving The Editor
  886.  
  887.                When you are finished with your editing, press the ESC
  888.                key.  If you have made any changes to the file, a
  889.                window will pop up and ask, "Save Changes?".
  890.                Answer "Y" to save all changes, or "N" to ignore all
  891.                changes.  An ESC will cancel the exit, if you have
  892.                changed your mind.           PC-ECAP Reference Manual                          page 16
  893.  
  894.           Analyze circuit
  895.  
  896.                This choice will begin the actual analysis of the
  897.                circuit selected.  If a file containing the circuit
  898.                description has not been selected, you will first be
  899.                sent to the "Select input file" screen and then
  900.                returned to begin analysis.
  901.  
  902.                PC-ECAP will subject your circuit to a 1 volt signal at
  903.                the selected input node and then calculate the desired
  904.                response at the selected output node.  The input signal
  905.                is from an ideal voltage source and therefore it can
  906.                drive any impedance.  Any output node selected will not
  907.                be loaded by PC-ECAP.
  908.  
  909.                This analysis is repeated for each of the frequency
  910.                points within the specified input range.  The number of
  911.                points is determined by the "Change the number of
  912.                sample points" option under the "Change program
  913.                settings" choice of the main menu.  Its use will be
  914.                fully explained under that heading.  If you are doing
  915.                an AC analysis, PC-ECAP will display magnitude and
  916.                phase results as the analysis progresses.  For a
  917.                transient analysis the individual points are not
  918.                available until the analysis is complete.  The results
  919.                of the analysis are also saved in a disk file.  The
  920.                file will have the same name as the circuit description
  921.                file but will have a file extension of ".OUT".           PC-ECAP Reference Manual                          page 17
  922.  
  923.           Plotting results
  924.  
  925.           When the analysis is finished, the results will be plotted
  926.           on your display.  For all display adapters other than VGA,
  927.           PC-ECAP will use the highest resolution that your display
  928.           adapter supports.  VGA adapters will be run in EGA mode (640
  929.           x 350).  The resolution used will be as follows:
  930.  
  931.                          CGA          640 x 200
  932.  
  933.                          EGA          640 x 350    enhanced display
  934.  
  935.                                       640 x 350    monochrome display
  936.  
  937.                                       640 x 200    color display
  938.  
  939.                          Hercules     720 x 348
  940.  
  941.                          VGA          640 x 350    monochrome or color
  942.  
  943.                          MCGA         640 x 480    monochrome or color
  944.  
  945.                          AT&T         640 x 400   
  946.  
  947.                          MDA          80 x 25
  948.  
  949.           When viewing the graphs on most display adapters you have
  950.           the options "Zoom", "Print", "Full" and ESC.  The MDA only
  951.           has "Print" and ESC.
  952.  
  953.           "Zoom" allows you to enlarge an area of a graph.  Press the
  954.           'Z' to display two vertical bars with an attached bottom.
  955.           You may continue to press 'Z' to narrow the bars.  The
  956.           number of times this is possible depends on the number of
  957.           sample point you have selected for this analysis.  When the
  958.           bars are at their narrowest, they encompass 35 sample
  959.           points.  When you have the bars at the desired width, you
  960.           can position them horizontally by pressing the Right arrow,
  961.           Left arrow, Home or End keys.  When the bars are where you
  962.           want them, press ENTER to zoom up on the area selected.
  963.  
  964.           When zooming, you may also use the Up arrow and Down arrow
  965.           keys to position the bottom dashed line.  Moving this bar
  966.           sets a minimum vertical scale for your graph.  This can be
  967.           very useful to help view small variations in amplitude.
  968.  
  969.           You may press 'F' at any time for a "Full" screen display of
  970.           your graph.  This simply presents the graph as it was
  971.           originally displayed.
  972.  
  973.           You may also press 'P' at any time to get a hard copy print
  974.           out of just your graphs.  The printout will be Zoomed if the
  975.           graph is Zoomed on your display.  All graphs for your
  976.           analysis will be printed.
  977.  
  978.           Pressing ESC will return you to the main menu.  Any other
  979.           key will cycle through the various plots.           PC-ECAP Reference Manual                          page 18
  980.  
  981.           View output data
  982.  
  983.                This selection allows you to view the results of
  984.                circuits that have been previously analyzed.  The
  985.                results will be listed in tabular form on the display.
  986.                You can use the cursor keys to move through them.  The
  987.                cursor keys that are active under this selection are
  988.                the following:
  989.  
  990.                     Up Arrow     - scroll up one line.
  991.  
  992.                     Down Arrow   - scroll down one line.
  993.  
  994.                     PgUp         - scroll up 19 lines.
  995.  
  996.                     PgDn         - scroll down 19 lines.
  997.  
  998.                     Home         - display the first 19 lines.
  999.  
  1000.                     End          - display the last 19 lines.
  1001.  
  1002.                The analysis results can also be plotted on the display
  1003.                by pressing the F1 function key.  Plotting works the
  1004.                same way as described in the "Analyze circuit" section.
  1005.                Pressing any key except 'Z', 'F', 'P' or ESC will cycle
  1006.                through the various plots.  Pressing ESC will return
  1007.                you to the tabular listing of the data. Press ESC again
  1008.                to return to the main menu.
  1009.  
  1010.           Output to printer
  1011.  
  1012.                PC-ECAP will normally send the results of an
  1013.                analysis to a printer selected under the "Change
  1014.                program settings" option.  If desired, the results can
  1015.                instead be sent to a disk file for printing later.  The
  1016.                file will have a filename that is the same as the file
  1017.                selected, but with a file extension of ".PRN".
  1018.  
  1019.                Partial output listing
  1020.  
  1021.                This choice will output a listing of the circuit
  1022.                description at the time of analysis and high resolution
  1023.                plots of the results.
  1024.  
  1025.                Full output listing
  1026.  
  1027.                Choosing this option will output a listing of
  1028.                the circuit description at the time of analysis, a
  1029.                tabular listing of the analysis results, and high
  1030.                resolution plots of these results.
  1031.  
  1032.                For printed output it is necessary to have a printer
  1033.                that is compatible with IBM/Epson, HP LaserJet or HP
  1034.                DeskJet printers.  Most printers used with IBM
  1035.                compatible computers support one of these standards,           PC-ECAP Reference Manual                          page 19
  1036.  
  1037.                although in a few cases it may be necessary to select
  1038.                the proper mode by means of a switch on the printer.
  1039.                Be sure you have configured PC-ECAP for your particular
  1040.                printer type.  This is done under the "Change program
  1041.                settings" option of the main menu.  (see next section
  1042.                for details).
  1043.  
  1044.           Change program settings
  1045.  
  1046.                PC-ECAP allows you to configure certain aspects of its
  1047.                operation.  The configuration information is saved in a
  1048.                disk file that is read every time the program is run.
  1049.                The name of this file is "PC-ECAP.CFG".  If this file
  1050.                is not present it will be created.  This should only be
  1051.                necessary the very first time you run PC-ECAP.  The
  1052.                file will have as defaults: 70 sample points for
  1053.                analysis, LPT1 selected as the output destination, and
  1054.                an IBM/Epson 9 pin printer selected as your printer
  1055.                type.  Any of these may be changed by means of this
  1056.                menu.
  1057.  
  1058.                Change number of sample points
  1059.  
  1060.                When an analysis is performed, the desired range is
  1061.                divided into a number of sample points.  The number of
  1062.                points may be set to 35, 70, 140, 280 or 560.  It
  1063.                should be noted that you must obviously make a choice
  1064.                between the high analysis resolution provided by
  1065.                selecting 560 sample points and the faster
  1066.                computational speed offered by selecting 35 points.
  1067.                The number of points you select really depends on the
  1068.                circuits that you analyze.  I have found that for most
  1069.                circuits 70 sample points works quite well.  You should
  1070.                increase the number of points if you have a circuit
  1071.                that has abrupt changes in its response.  You may also
  1072.                need to increase the number of points if you analyze
  1073.                circuits over a very wide frequency or time range.
  1074.  
  1075.                Select output destination
  1076.  
  1077.                The output from PC-ECAP can be sent to a printer
  1078.                designated as LPT1, LPT2, or LPT3.  Alternately output
  1079.                may be sent to a disk file for later printing.  For
  1080.                printed output, select the port that you have your
  1081.                printer attached to (normally this will be LPT1).
  1082.  
  1083.                Pick a printer to use
  1084.  
  1085.                PC-ECAP supports four different printer types.  One of
  1086.                these types should be a good match for just about any
  1087.                printer.  The supported printer types are: IBM/Epson 9
  1088.                pin, HP LaserJet (or HP DeskJet), Epson 24 pin and IBM
  1089.                24 pin.  Just choose the type that matches your
  1090.                printer.  Since some printers can emulate more than one
  1091.                type, be sure that your printer and PC-ECAP are both           PC-ECAP Reference Manual                          page 20
  1092.  
  1093.                configured for the same printer type.  After you make
  1094.                your selection, it is important that you "Write changes
  1095.                to disk" (see next choice).  If you don't save your
  1096.                printer configuration, PC-ECAP will not be setup
  1097.                properly the next time you use it.  This only needs to
  1098.                be done once.
  1099.  
  1100.                If you have an HP DeskJet printer, you should select HP
  1101.                LaserJet as your printer type.
  1102.  
  1103.                HP LaserJet or HP DeskJet users have an additional
  1104.                choice after the printer type is selected.  You will be
  1105.                asked "2 graphs on page?".  In almost all cases you
  1106.                should answer "Yes" to this question.  If you have an
  1107.                HP DeskJet, you MUST answer "Yes".  If you answer "No"
  1108.                and have an HP LaserJet, graphs will print in landscape
  1109.                mode (sideways).  This option was added mainly to
  1110.                support older HP LaserJet series I printers.  These
  1111.                printers don't have enough memory to print two graphs
  1112.                on a single sheet of paper.  The option to print in
  1113.                landscape mode may be occasionally useful to users of
  1114.                newer HP LaserJet printers.  But since graphic
  1115.                resolution is the same for either choice, most people
  1116.                will favor using less paper over full page graphs.
  1117.  
  1118.                Some printers allow you to manually set a particular
  1119.                font, pitch or mode.  DO NOT DO THIS.  On most printers
  1120.                this will override any printer commands that your
  1121.                computer may send, and PC-ECAP's printed output will
  1122.                not print properly.  If you have a problem with printed
  1123.                output, insure that your printer is in "Pgm" mode.
  1124.                When in "program" mode, your printer will follow your
  1125.                program's commands, and your printed output will appear
  1126.                as intended.
  1127.  
  1128.                Write changes to disk
  1129.  
  1130.                This selection will write any changes in configuration
  1131.                to the "PC-ECAP.CFG" file.  Select this option to make
  1132.                the changes you have made carry over to the next
  1133.                session of PC-ECAP.  If the changes are not written to
  1134.                disk, they will be in effect only for your current
  1135.                session.
  1136.  
  1137.                Return to main menu
  1138.  
  1139.                Returns you to the main menu.
  1140.  
  1141.           Quit this program
  1142.  
  1143.                Ends your current session with PC-ECAP and returns you
  1144.                to DOS.           PC-ECAP Reference Manual                          page 21
  1145.  
  1146.           Analyzing a Circuit Using PC-ECAP
  1147.  
  1148.           The first step in analyzing any circuit is to draw the
  1149.           circuit on a piece of paper.  Next number all the nodes in
  1150.           the circuit.  A node is any connection of 2 or more
  1151.           components.  Node numbers must be non-negative integers.
  1152.           There are two rules that you must follow when numbering
  1153.           nodes, first ground or the common connection between input
  1154.           and output must always be designated as node number 0.
  1155.           Secondly, although the nodes may be numbered in any order,
  1156.           none may be skipped.
  1157.  
  1158.           PC-ECAP has a limit of 90 nodes and can handle up to 1000
  1159.           components.  Some components count as more than one circuit
  1160.           element.  You can use the following as a guide;
  1161.  
  1162.  
  1163.                Resistors, Capacitors, Inductors, Transmission
  1164.                lines, Fet's and Transconductance amplifiers
  1165.                each count as one circuit element.
  1166.  
  1167.                OpAmps and Bipolar transistors count as two.
  1168.  
  1169.                Transformers count as four.
  1170.  
  1171.  
  1172.           So it is possible to have fewer than 1000 components in your
  1173.           circuit and still exceed this limit.  Although, in practice,
  1174.           it is highly unlikely that you will reach this limit.           PC-ECAP Reference Manual                          page 22
  1175.  
  1176.           Input Format
  1177.  
  1178.           The input format of a PC-ECAP circuit description is easy to
  1179.           learn and remember.  Fields describing a component are of
  1180.           the free format type and are simply separated by spaces.
  1181.           Circuit element names should begin with a letter designating
  1182.           the type of circuit element and may optionally be followed
  1183.           by up to 14 additional alphanumeric characters.
  1184.  
  1185.           Values used to describe a circuit element may be integer
  1186.           (100), floating point (1000.45), either an integer or
  1187.           floating point number followed by an integer exponent
  1188.           (1E-3, 4.7E6) or either an integer or floating point number
  1189.           followed by one of the following scale factors:
  1190.  
  1191.                P=1E-12   N=1E-9    U=1E-6    M=1E-3    K=1E3
  1192.  
  1193.                          MEG=1E6        G=1E9
  1194.  
  1195.           Letters immediately following a number that are not scale
  1196.           factors are ignored, and letters immediately following a
  1197.           scale factor are ignored.  So 10, 10ohms and 10Hz all
  1198.           represent the same number, and u, uf and umhos all represent
  1199.           the same scale factor.  Note that 1000, 1000.0, 1000Hz, 1E3,
  1200.           1.0E3, 1K and 1KHz all represent the same number.
  1201.  
  1202.           In addition, some values may also be expressed in "European"
  1203.           format.  This format has one or more digits followed by a
  1204.           scale factor that also takes the place of a decimal point,
  1205.           followed by one or more digits.  For example, 1500 would be
  1206.           expressed as 1K5.  When values are in this format, these
  1207.           scale factors are recognized: R, K, M.  `R' is equal to a
  1208.           factor of 1.  `K' is equal to 1000, as above.  `M' is equal
  1209.           to a factor of 1E6.  Please note the difference between this
  1210.           use of `M' and `M' in the non-European format above.  When
  1211.           `M' is placed at the end of a number it multiplies the
  1212.           number by 1E-3.  But when `M' is placed between two numbers,
  1213.           the multiplication factor is 1E6.  Be careful!
  1214.  
  1215.  
  1216.                Some examples:
  1217.  
  1218.                6R8 is 6.8,    5K1 is 5100,    4M7 is 4.7 million           PC-ECAP Reference Manual                          page 23
  1219.  
  1220.           Circuit Element Description
  1221.  
  1222.           Resistors
  1223.  
  1224.                Rxxxx N1 N2 Value
  1225.  
  1226.           N1 and N2 are the two element nodes.  Value is the
  1227.           resistance in ohms.
  1228.  
  1229.           Examples:
  1230.  
  1231.                R1 1 2 100
  1232.  
  1233.                RLOAD 12 15 1K
  1234.  
  1235.           Capacitors
  1236.  
  1237.                Cxxxx N1 N2 Value
  1238.  
  1239.           N1 and N2 are the two element nodes.  Value is the
  1240.           capacitance in farads.
  1241.  
  1242.           Examples:
  1243.  
  1244.                C4 8 9 1uf
  1245.  
  1246.                COSC 2 3 22pf
  1247.  
  1248.           Inductors
  1249.  
  1250.                Lxxxx N1 N2 Value
  1251.  
  1252.           N1 and N2 are the two element nodes.  Value is the inductor
  1253.           value in henries.
  1254.  
  1255.           Examples:
  1256.  
  1257.                L3 7 0 10mh
  1258.  
  1259.                LTANK 4 5 56uh
  1260.  
  1261.           Transformers
  1262.  
  1263.                Txxxx +Pri -Pri +Sec -Sec  N
  1264.  
  1265.           +Pri and -Pri are the nodes for the transformer primary.
  1266.           +Sec and -Sec are the nodes for the transformer secondary.
  1267.           N is the turns ratio between primary and secondary (Np/Ns).
  1268.           The + and - signs denote the phasing of the windings,
  1269.           e.g. the +Pri node will be in phase with the +Sec node.
  1270.  
  1271.           Example:
  1272.  
  1273.                T1 3 0 4 5 10turns           PC-ECAP Reference Manual                          page 24
  1274.  
  1275.           Transmission Lines  (lossless)
  1276.  
  1277.                Xxxxx N1 N2 Impedance Length
  1278.  
  1279.           N1 and N2 are the two ends of the transmission line.  The
  1280.           line model used is unbalanced, so N1 and N2 are referenced
  1281.           to ground.  The line impedance is in ohms.  The Length is
  1282.           specified in meters.
  1283.  
  1284.           Example:
  1285.  
  1286.                X1 1 2 50 3
  1287.  
  1288.           Bipolar Transistors (both NPN and PNP)
  1289.  
  1290.                Bxxxx NB NE NC Beta Rbe
  1291.  
  1292.           NB, NE, and NC are the base, emitter and collector nodes
  1293.           respectively.  Beta is the Transistor current gain.  Rbe is
  1294.           the equivalent base-emitter resistance (in ohms) used in the
  1295.           Hybrid-Pi transistor model.
  1296.  
  1297.           Example:
  1298.  
  1299.                B1 9 0 11 100 1250
  1300.  
  1301.           Field Effect Transistors  (both JFETs and MOSFETs)
  1302.  
  1303.                Fxxxx NG NS ND Gm
  1304.  
  1305.           NG, NS, and ND are the gate, source, and drain nodes
  1306.           respectively.  Gm is the FET transconductance in mhos
  1307.           (Amps/Volt).
  1308.  
  1309.           Example:
  1310.  
  1311.                F2 3 4 0 2000umhos
  1312.  
  1313.           Operational Amplifiers
  1314.  
  1315.                Oxxxx N+ N- NO Gain Rout
  1316.  
  1317.           N+, N-, and NO are the non-inverting input, inverting input
  1318.           and output nodes respectively.  The opamp output is
  1319.           referenced to ground (node 0).  Gain is the open loop gain
  1320.           of the opamp, usually somewhere between 10,000 and 1 million
  1321.           times.  Rout is the open loop output resistance for the
  1322.           opamp.  Real opamps usually have an output resistance
  1323.           between 10 and 150 ohms.
  1324.  
  1325.           Example:
  1326.  
  1327.                O1 1 2 2 100k 75           PC-ECAP Reference Manual                          page 25
  1328.  
  1329.           Transconductance Amplifiers
  1330.  
  1331.                Gxxxx N+ N- NO+ NO- Gm
  1332.  
  1333.           N+ and N- are the non-inverting input and inverting input.
  1334.           NO+ and NO- are the non-inverting output and the inverting
  1335.           output.  Please note that these outputs are floating.  In
  1336.           other words the actual output is not from either output to
  1337.           ground, but is developed between the outputs.  Either output
  1338.           (but not both) may be tied to ground if a single ended
  1339.           output is desired.  Gm is the amplifier transconductance in
  1340.           mhos (Amps/Volt).  The transconductance amplifier may be
  1341.           used in its own right or it may be used to perform a voltage
  1342.           to current conversion, sometimes useful when simulating
  1343.           other devices.
  1344.  
  1345.           Example:
  1346.  
  1347.                Gxxxx 1 2 3 0 100mmhos
  1348.  
  1349.  
  1350.           A Few Words About Transconductance Amplifiers
  1351.  
  1352.           Although most people are familiar with bipolar transistors
  1353.           and operational amplifiers, not as many know about
  1354.           transconductance amplifiers.  These amplifiers are another
  1355.           variation of a dependent source.  The common bipolar
  1356.           transistor is a current controlled current source; A small
  1357.           current entering the base controls a much larger current
  1358.           flowing between the collector and emitter.  The opamp is a
  1359.           voltage controlled voltage source; A very small input
  1360.           voltage effectively controls a much larger voltage swing at
  1361.           the output.  With this said, a transconductance amplifier
  1362.           can be described as a voltage controlled current source; A
  1363.           small voltage difference between the two inputs controls a
  1364.           current flowing either into or out of the output.  In our
  1365.           case this current will flow from one output to the other.
  1366.  
  1367.  
  1368.           Valid Circuit Elements
  1369.  
  1370.           All of the lines that make up a PC-ECAP circuit description
  1371.           file must either begin with one of the previously mentioned
  1372.           elements, be blank, or be a comment.  To add a comment to
  1373.           your circuit description, begin the line with a semicolon.
  1374.           An example comment might be:
  1375.  
  1376.                ; this begins the second filter section
  1377.  
  1378.           If a line begins with something other than a circuit
  1379.           element, a blank line, or a comment, PC-ECAP will abort the
  1380.           analysis and flag the bad line.           PC-ECAP Reference Manual                          page 26
  1381.  
  1382.           Specifying AC Analysis Parameters
  1383.  
  1384.  
  1385.           Once your circuit has been described you need to determine
  1386.           how it will be analyzed.  PC-ECAP will subject your circuit
  1387.           to a 1 volt signal at the selected input node and then
  1388.           calculate the response at the selected output node.  In an
  1389.           AC analysis, the frequency of the input signal can be swept
  1390.           over the specified range in either a linear or logarithmic
  1391.           fashion.
  1392.  
  1393.           The PLOT statement is used to tell PC-ECAP which node of
  1394.           your circuit will be used for the input, which node will be
  1395.           used for the output, the frequency range that you want to
  1396.           analyze, the sweep mode (linear or logarithmic) and the
  1397.           analysis type.  PLOT should be the last statement in your
  1398.           description.
  1399.  
  1400.           This is the AC format for the PLOT statement:
  1401.  
  1402.  
  1403.             PLOT NI NO Start-freq. Stop-freq. Plot-mode Plot-type
  1404.  
  1405.  
  1406.           PLOT may optionally be abbreviated to P.  NI is the
  1407.           circuit's input node.  NO is the circuit's output node.
  1408.           Start-frequency is simply the beginning frequency for the
  1409.           analysis.  Stop-frequency is the upper frequency limit of
  1410.           the analysis.  Plot-mode specifies whether a linear or a
  1411.           logarithmic frequency sweep is to be performed.  This may be
  1412.           abbreviated to 3 letters (LIN or LOG) if desired.
  1413.  
  1414.           Plot-type may optionally be used to specify the analysis
  1415.           type.  If it is not specified, magnitude and phase will be
  1416.           calculated.  To calculate group delay, impedance, VSWR or
  1417.           return loss, you must provide this parameter.
  1418.  
  1419.  
  1420.                for:                   Plot-type is:
  1421.  
  1422.           group delay                   Delay
  1423.  
  1424.           impedance in magnitude        ZPolar
  1425.            and phase format
  1426.  
  1427.           impedance in Real and         ZRectangular
  1428.            Imaginary format
  1429.  
  1430.             VSWR                        SWR    <reference impedance>
  1431.           (voltage standing
  1432.                wave ratio)
  1433.  
  1434.           return loss                   RLoss  <reference impedance>
  1435.  
  1436.  
  1437.           Plot-type may be abbreviated to the letters that are
  1438.           capitalized.           PC-ECAP Reference Manual                          page 27
  1439.  
  1440.           Impedance, VSWR (voltage standing wave ratio) and return
  1441.           loss calculations will be done at the input node specified.
  1442.           This doesn't mean that you can't calculate an output
  1443.           impedance instead.  If your circuit's output is node 8, and
  1444.           you are interested in its output impedance, just specify
  1445.           node 8 as the input node for the PLOT statement.  You can
  1446.           look at it this way, to determine impedance, PC-ECAP must
  1447.           apply an excitation signal to your circuit.  This signal is
  1448.           always applied to the node listed as the input node for your
  1449.           circuit.
  1450.  
  1451.           For VSWR and return loss, a reference impedance must also be
  1452.           specified.  This is the impedance that your circuit is
  1453.           supposed to be matched to.  This is usually 50 or 75 ohms,
  1454.           but it may be any positive value.
  1455.  
  1456.           As an example of what we have been discussing, we might have
  1457.           a circuit where node 2 is the input and node 5 is the
  1458.           output.  The lowest frequency that we want to look at is 100
  1459.           Hz and the highest frequency is 10 KHz.  We are only
  1460.           interested in magnitude and phase vs frequency.  And we want
  1461.           to sweep this range logarithmically.
  1462.  
  1463.           This PLOT statement will specify all this:
  1464.  
  1465.                PLOT 2 5 100HZ 10KHZ LOG
  1466.  
  1467.           For another example, we have a circuit with node 1 as its
  1468.           input.  We are interested in determining the input VSWR vs
  1469.           frequency.  The input is supposed to match 50 ohms, and
  1470.           operate from 7.0 MHz to 7.3 MHz.
  1471.  
  1472.           This is the PLOT statement that will do the job:
  1473.  
  1474.                PLOT 1 5 7MEG 7.3MEG LIN SWR 50
  1475.  
  1476.           Please note that for impedance, VSWR or return loss
  1477.           calculations, the output node specified in the PLOT
  1478.           statement is unimportant.  It is ignored.
  1479.  
  1480.  
  1481.           What is Group Delay anyway?
  1482.  
  1483.           If a circuit is designed to pass all important frequencies
  1484.           with equal amplitude and have absolutely linear amplitude
  1485.           characteristics, a waveform may still pass through badly
  1486.           distorted.  The problem is delay distortion; if all
  1487.           frequency components do not pass through a circuit with the
  1488.           same time delay, the output waveform will not look the same
  1489.           as the input.  Group delay is the rate of phase shift vs
  1490.           change of frequency, and is defined as:
  1491.  
  1492.                                    1    d0
  1493.                     group delay = --- x ---  seconds
  1494.                                   360   df           PC-ECAP Reference Manual                          page 28
  1495.  
  1496.           Specifying Transient Analysis Parameters
  1497.  
  1498.           PC-ECAP also has the capability to analyze the transient
  1499.           behavior of a circuit.  This feature can give you important
  1500.           information about a circuit's response vs time.  You have a
  1501.           choice of eight different input waveforms for analysis.  In
  1502.           addition, a circuit's impulse response can also be
  1503.           calculated.
  1504.  
  1505.           As with an AC analysis, the program will subject your
  1506.           circuit to a 1 volt (peak) signal from an ideal voltage
  1507.           source.  The input waveform can be one of the following: a
  1508.           step (unit step, and two modified step functions), pulse,
  1509.           ramp, square wave, triangle wave, or sine wave.  You may
  1510.           optionally add noise to any of these waveforms.
  1511.  
  1512.           The PLOT statement is used to specify all the parameters
  1513.           needed for a transient analysis.  This is its format:
  1514.  
  1515.  
  1516.             PLOT NI NO TStart TStop TRAN Wave-Type TPeriod NOISE
  1517.  
  1518.  
  1519.           PLOT may be abbreviated to P.  NI is the circuit's input
  1520.           node.  NO is the circuit's output node.
  1521.  
  1522.           TStart is a time offset for the input waveform.  The input
  1523.           waveform will be delayed by the amount specified by TStart.
  1524.           It can be helpful to delay the rising edge of the input when
  1525.           analyzing some circuits.
  1526.  
  1527.           TStop is just the final time for the analysis.  TRAN tells
  1528.           PC-ECAP that a transient analysis is desired.
  1529.  
  1530.           Wave-Type selects the waveform at the input and should be
  1531.           one of the these:
  1532.  
  1533.  
  1534.                STEP
  1535.  
  1536.                This is a unit step.  The wave is 0 volts when time
  1537.                is less then TStart.  At TStart, the voltage goes to 1
  1538.                volt and stays there.
  1539.  
  1540.  
  1541.                STEP1  [rise-time]
  1542.  
  1543.                This is a modified step function.  It behaves like the
  1544.                STEP just discussed, but has a rise time that is shaped
  1545.                by a COSINE function.  A rise time must be specified
  1546.                for this function.  The rise time is the amount of time
  1547.                the leading edge takes to go from 20% to 80% of its
  1548.                final value.  If a rise-time is not specified or is
  1549.                zero, it will default to TStop / 8.           PC-ECAP Reference Manual                          page 29
  1550.  
  1551.                STEP2  [rise-time]
  1552.  
  1553.                This is a another modified step function.  It behaves
  1554.                like the STEP discussed before, but has a rise time
  1555.                that is shaped by a RAMP function.  A rise time must be
  1556.                specified for this function.  The rise time is the
  1557.                amount of time the leading edge takes to go from 20% to
  1558.                80% of its final value.  If a rise-time is not
  1559.                specified or is zero, it will default to TStop / 8.
  1560.  
  1561.  
  1562.                PULSE  [pulse-width]
  1563.  
  1564.                This pulse is 0 volts at any time less than TStart.  At
  1565.                TStart, it goes to 1 volt and stays there for a time
  1566.                equal to "pulse-width".  After this time (TStart +
  1567.                pulse-width) the voltage returns to 0 for the remainder
  1568.                of the analysis.  "Pulse-width" must be specified.  If
  1569.                it is not or is zero, it will default to one-half
  1570.                "TStop".
  1571.  
  1572.  
  1573.                RAMP  [pulse-width]
  1574.  
  1575.                This waveform is 0 volts for any time less than TStart.
  1576.                At TStart the voltage will linearly increase, finally
  1577.                reaching 1 volt when time is equal to TStart + pulse-
  1578.                width.  At the next time step, the voltage will
  1579.                immediately return to 0.  As with the PULSE, "Pulse-
  1580.                width" determines the width of the RAMP and must be
  1581.                specified.  If it is not or is zero, it will default to
  1582.                one-half "TStop".
  1583.  
  1584.  
  1585.                SQRW  [frequency]
  1586.  
  1587.                This will generate a square wave.  At TStart the
  1588.                voltage will jump to +1 volts.  Half way through the
  1589.                cycle, the voltage will change to -1 volts.  This cycle
  1590.                will continue forever.  The frequency is determined by
  1591.                the "Frequency" parameter which must be specified.  If
  1592.                "Frequency" is missing, it will default to 1/TStop.
  1593.  
  1594.  
  1595.                TRIW  [frequency]
  1596.  
  1597.                This will generate a triangle wave.  At TStart the
  1598.                voltage will linearly increase to +1 volts.  A quarter
  1599.                way through the cycle, the voltage will begin to ramp
  1600.                down.  When the voltage reaches -1 volts, the ramp will
  1601.                reverse and start back up to +1 volts.  This cycle will
  1602.                continue forever.  The frequency is determined by the
  1603.                "Frequency" parameter which must be specified.  If
  1604.                "Frequency" is missing, it will default to 1/TStop.           PC-ECAP Reference Manual                          page 30
  1605.  
  1606.                SINW  [frequency]
  1607.  
  1608.                This will generate a sine wave.  At TStart the voltage
  1609.                will increase to +1 volts.  A quarter way through the
  1610.                cycle, the voltage will reverse direction.  When the
  1611.                voltage reaches -1 volts, the wave will reverse and
  1612.                start back up to +1 volts.  This cycle will continue
  1613.                forever.  The frequency is determined by the
  1614.                "Frequency" parameter which must be specified.  If
  1615.                "Frequency" is missing, it will default to 1/TStop.
  1616.  
  1617.  
  1618.                IMPULSE
  1619.  
  1620.                This option will compute the impulse response for your
  1621.                circuit.  The impulse function is defined as a pulse of
  1622.                infinitely high amplitude with an infinitely short
  1623.                duration.  The area under this pulse (voltage x time)
  1624.                is equal to 1.  Although this pulse can't truly exist
  1625.                in the real world, it is nevertheless useful in some
  1626.                situations.  The impulse response always starts at time
  1627.                0.  TStart is ignored (but a value MUST still be
  1628.                supplied).
  1629.  
  1630.  
  1631.                NOISE
  1632.  
  1633.                Noise is an optional parameter that can be added to any
  1634.                of the waveforms described other then IMPULSE.  When
  1635.                present, pseudorandom noise is added to the wave
  1636.                specified.
  1637.  
  1638.  
  1639.           Computational Techniques Used in PC-ECAP Transient Analysis
  1640.  
  1641.           The method PC-ECAP uses to compute transient response is a
  1642.           bit unconventional and deserves some explanation.  It's not
  1643.           necessary to understand all of this in detail, but a basic
  1644.           understanding of the principals involved will help you get
  1645.           the most out of the program.
  1646.  
  1647.           You may have heard of something called a Fourier transform.
  1648.           This is a mathematical operation that can convert from the
  1649.           time domain (amplitude vs. time) to the frequency domain
  1650.           (amplitude vs. frequency).  With the Fourier transform you
  1651.           can take a waveform and break it down into the series of
  1652.           individual frequency components that make it up.
  1653.  
  1654.           As with most mathematical operations, there exists an
  1655.           inverse to the Fourier transform.  The Inverse Fourier
  1656.           transform can take a set of frequency components and
  1657.           construct a waveform in the time domain.  This is a very
  1658.           powerful tool.  It allows you to work in the frequency
  1659.           domain when convenient and then convert to the time domain
  1660.           only when desired.           PC-ECAP Reference Manual                          page 31
  1661.  
  1662.           PC-ECAP can easily calculate the frequency response of a
  1663.           circuit (amplitude vs. frequency).  By using an Inverse
  1664.           Fourier transform, we can calculate what is called the
  1665.           Impulse response of the circuit.  If you know the Impulse
  1666.           response of a circuit, it is possible to find the response
  1667.           to ANY other waveform by a mathematical operation called
  1668.           convolution.  This is very powerful technique and certainly
  1669.           involves a lot of underlying mathematics.
  1670.  
  1671.           So, to calculate the transient response of a circuit,
  1672.           PC-ECAP first computes the magnitude and phase at a series
  1673.           of harmonically related frequencies.  Next it performs a
  1674.           Discrete Inverse Fast Fourier Transform.  At this point we
  1675.           have the Impulse response.  In the next step, a Discrete
  1676.           Convolution is performed between the Impulse response and
  1677.           the desired waveform that was specified at the circuit's
  1678.           input.  The result is the transient response of the circuit
  1679.           to the waveform specified.
  1680.  
  1681.           It is important to realize that the accuracy of the analysis
  1682.           depends on the number of sample points chosen.  The number
  1683.           of sample points determine not only the number of points
  1684.           that you wind up with in the time domain, but they also
  1685.           determine the number of frequencies used in the Inverse FFT.
  1686.           Choosing too few sample points will impair the accuracy of
  1687.           the analysis.
  1688.  
  1689.           How few is "too few"?  That depends on your circuit.  Every
  1690.           circuit that contains at least one capacitor or inductor has
  1691.           what is called a "natural frequency".  Also sometimes called
  1692.           the "natural response".  Some circuits have many "natural
  1693.           frequencies".  These are nothing more than the various time
  1694.           constants (for RC's or RL's) or resonant frequencies (for
  1695.           LC's) in a circuit.  If you have some background in
  1696.           electronic theory, these are the poles and zero's of a
  1697.           circuit.
  1698.  
  1699.           If you pick too few sample points, the program will not use
  1700.           enough frequencies to properly characterize your circuit.
  1701.  
  1702.           The time scale you select also effects the accuracy of your
  1703.           results.  If the time scale is large compared to the natural
  1704.           frequencies of your circuit, you will have to increase the
  1705.           number of sample points used.  If the time scale is too
  1706.           small, the analysis frequencies will start above the
  1707.           circuit's natural frequency and accuracy will suffer.
  1708.  
  1709.           For the problem of picking a time scale that is too short,
  1710.           the thing to remember is the Impulse response of a circuit
  1711.           must die out to zero in the time frame specified.  This is
  1712.           important and easily determined.  If you want to check this
  1713.           condition, specify IMPULSE as your Wave-Type.  You should
  1714.           see your circuit's response go to zero sometime before the
  1715.           TStop time.  If it doesn't, you must increase TStop.           PC-ECAP Reference Manual                          page 32
  1716.  
  1717.           A circuit that has a large span of natural frequencies will
  1718.           require the most care to analyze.  For the low natural
  1719.           frequencies, the TStop time must be set large enough so the
  1720.           Impulse response dies out to zero.  At the same time, the
  1721.           number of sample points must be great enough to properly
  1722.           characterize the high natural frequencies.
  1723.  
  1724.           All this will make more sense when you actually analyze a
  1725.           few circuits.  Vary the number of sample points to see the
  1726.           effect.  Try setting the TStop time much larger than the
  1727.           lowest natural frequency in your circuit.  Try setting the
  1728.           TStop time shorter than the highest natural frequency in the
  1729.           circuit.  By trying these things you will quickly get a feel
  1730.           for their effect and understand more than you can by just
  1731.           reading.           PC-ECAP Reference Manual                          page 33
  1732.  
  1733.           An Example Please!
  1734.  
  1735.           It's about time now to look at an example circuit.  We will
  1736.           analyze a simple RC low-pass filter.  The circuit is shown
  1737.           below.
  1738.  
  1739.  
  1740.                         1        1.59K                 2
  1741.                          ------/\/\/\/\------*---------
  1742.                                              |
  1743.                                              |
  1744.                input                      ___|___  .1uf      output
  1745.                                           _______
  1746.                                              |
  1747.                                              |
  1748.                                           0  |
  1749.                          --------------------*----------
  1750.  
  1751.  
  1752.           This circuit has 3 nodes and they have been numbered.
  1753.           Notice that we have numbered the common node between the
  1754.           input and the output as node 0.  This is required.
  1755.  
  1756.           The next thing to do is to describe the circuit to PC-ECAP
  1757.           so that it will know just what is connected to what and the
  1758.           component values associated with each part.  The next two
  1759.           lines will completely describe this circuit:
  1760.  
  1761.                R 1 2 1.59K
  1762.                C 2 0 .1UF
  1763.  
  1764.           The first line says to PC-ECAP that a resistor is connected
  1765.           between nodes 1 and 2 and has a value of 1.59K (notice that
  1766.           you don't have to enter 1590 for the resistor value, PC-ECAP
  1767.           understands what "K" means).
  1768.  
  1769.           The second line reads "a capacitor is connected between
  1770.           nodes 2 and 0 and has a value of .1uf".  Now all we have to
  1771.           tell PC-ECAP is where we want to put the input signal, where
  1772.           we want to look for the output and what frequency range we
  1773.           want to cover.  This is done with the PLOT statement.  For
  1774.           this circuit we want node 1 to be our input and node 2 to be
  1775.           our output.  Also we want to sweep the input frequency from
  1776.           100Hz to 10KHz in a logarithmic fashion.  The next line will
  1777.           tell PC-ECAP all this.
  1778.  
  1779.                PLOT 1 2 100 10KHZ LOG
  1780.  
  1781.           On your distribution disk (or in the archive file if you got
  1782.           this program from a BBS) you will find EXAMPLE1.DAT.  This
  1783.           file contains the circuit description for this circuit.           PC-ECAP Reference Manual                          page 34
  1784.  
  1785.           If you haven't started PC-ECAP yet do so now.  From the
  1786.           main menu choose the "Select input file" selection.  Select
  1787.           EXAMPLE1.DAT as your input file.  Next from the main menu
  1788.           choose "Edit input file".  The editor will load EXAMPLE1.DAT
  1789.           and you will see the following:
  1790.  
  1791.  
  1792.           ; Example1.dat - RC low-pass filter with a cutoff frequency
  1793.           ;                 of 1 KHz.
  1794.  
  1795.           R 1 2 1.59k
  1796.           C 2 0 .1UF
  1797.           PLOT 1 2 100 10KHZ LOG
  1798.  
  1799.           This circuit description tells PC-ECAP all that it needs to
  1800.           know about this circuit and how you want to analyze it.
  1801.  
  1802.           Press ESC to get back to the main menu and now choose
  1803.           "Analyze circuit".  The analysis will begin and you will see
  1804.           the results as the program progresses.  When the analysis is
  1805.           complete, the results will be plotted on your display.
  1806.           First you will see a plot of Magnitude vs. Frequency.  If
  1807.           you press any key other than ESC you will get a plot of
  1808.           Phase vs. Frequency.  Pressing any key (other than ESC)
  1809.           again will show you Magnitude again.  If you have an EGA
  1810.           with 256K of memory or a Hercules or VGA card, both pages of
  1811.           graphics memory will be used and the change from Phase to
  1812.           Magnitude and back will be instantaneous.
  1813.  
  1814.  
  1815.           An Example of Transient Analysis
  1816.  
  1817.           EXAMPLE2.DAT is the same circuit as EXAMPLE1.DAT.  But this
  1818.           time we're going to run a transient analysis.  We'll pick a
  1819.           Stop time of 3 ms and a 1.5 ms Pulse for the input.  The
  1820.           input pulse will be delayed .1 ms to show the leading edge
  1821.           better.  This is the circuit listing:
  1822.  
  1823.           ; Example2.dat - RC low-pass filter with cutoff frequency of
  1824.           ;   1 KHz.  This example shows how to analyze a circuit's
  1825.           ;   transient response.
  1826.  
  1827.           R 1 2 1.59K
  1828.           C 2 0 .1UF
  1829.           PLOT 1 2 .1MS 3MS TRAN PULSE 1.5MS
  1830.  
  1831.           That's all there is to it.  Select EXAMPLE2.DAT and run an
  1832.           analysis on it.  Try varying the Stop time or the Pulse
  1833.           width.           PC-ECAP Reference Manual                          page 35
  1834.  
  1835.           Another Example
  1836.  
  1837.           We have included a few other sample circuits with PC-ECAP.
  1838.           EXAMPLE3.DAT is a 75 ohm high-pass filter that can be used
  1839.           to reject television interference.  EXAMPLE4.DAT is a
  1840.           band-pass filter for use as a modem receive filter.  This
  1841.           example shows how group delay is calculated.  EXAMPLE6.DAT
  1842.           is an LC low-pass filer for which input impedance is
  1843.           calculated.  EXAMPLE7.DAT is an example of the calculation
  1844.           of return loss.  EXAMPLE8.DAT is an LC band-pass filter for
  1845.           which VSWR is calculated.  EXAMPLE9.DAT is an LC low-pass
  1846.           filter with a Square wave as input (for another example of
  1847.           transient analysis).  If you'd like, take a look at them and
  1848.           run an analysis.  You may want to draw them on a piece of
  1849.           paper first to really see what you are doing.           PC-ECAP Reference Manual                          page 36
  1850.  
  1851.           For our last example we're going to take a look at
  1852.           EXAMPLE5.DAT.  This circuit is a single stage transistor
  1853.           amplifier made with a 2N3904 NPN transistor.  We will
  1854.           demonstrate the use of the "Model Maker" that is part of the
  1855.           full screen editor.  Here's the circuit:
  1856.  
  1857.  
  1858.                                                    +10 volts
  1859.                                              0  |
  1860.                                                 \   R4
  1861.                                                 /   470 ohms
  1862.                                                 \
  1863.                                                 /
  1864.                                        R3       |
  1865.                                       8.2K      |  3
  1866.                                   +--\/\/\/\----*---------
  1867.                                   |             |         output
  1868.                                   |            /
  1869.                         R1        |         | /
  1870.               1        270 ohms   |   2     |/       2N3904
  1871.                 -------/\/\/\/\---*---------|
  1872.                                   |         |\
  1873.           input              R2   \         | \
  1874.                             1.2K  /           _\/
  1875.                                   \             |
  1876.                                   /             |
  1877.                                   |   0         |
  1878.                 ------------------*-------------*---------
  1879.  
  1880.  
  1881.  
  1882.           As you can see the first thing you need to do is to number
  1883.           the nodes.  Please take a look at the top of R4.  This end
  1884.           of the resistor connects to the +10 supply voltage but we
  1885.           have numbered it as node 0.  This is an important point.
  1886.           Any node that has a DC voltage connection should always be
  1887.           connected to ground.  For the sake of an AC analysis, any DC
  1888.           voltage source is the same thing as ground.
  1889.  
  1890.           Now that we have numbered the nodes, we can describe the
  1891.           circuit:
  1892.  
  1893.                R1 1 2 270
  1894.                R2 2 0 1.2K
  1895.                R3 2 3 8.2K
  1896.                R4 3 0 470
  1897.  
  1898.           Alright, now we are ready for the NPN transistor.  The
  1899.           transistor that we are using is a 2N3904.  We could use a
  1900.           simple one line description for this transistor, but that
  1901.           wouldn't show what happens to the transistor at high
  1902.           frequencies.  What we need is a more sophisticated
  1903.           transistor model.  One that will change its characteristics
  1904.           as the frequency changes like a real transistor.           PC-ECAP Reference Manual                          page 37
  1905.  
  1906.           PC-ECAP has the capability to create just such a model.  But
  1907.           first you need to know some information about the transistor
  1908.           that you want to model.  This is what is required:
  1909.  
  1910.  
  1911.           DC collector current -
  1912.  
  1913.                          For this circuit about 10 milli-amps flows
  1914.                          from the collector to emitter.
  1915.  
  1916.           Transistor current gain -
  1917.  
  1918.                          At 10 ma. this is a minimum of 100.  This is
  1919.                          the same as Beta (the current gain at DC).
  1920.  
  1921.           Transistor Gain-bandwidth product -
  1922.  
  1923.                          For the 2N3904 with a collector current of 10
  1924.                          ma. this is 300 MHz minimum.  This is also
  1925.                          known as Ft.
  1926.  
  1927.           Common base output capacitance -
  1928.  
  1929.                          This is just the capacitance from the base to
  1930.                          the collector.  For the 2N3904 it is 4 pf
  1931.                          maximum.
  1932.  
  1933.  
  1934.           Now that we have the required information we can make a
  1935.           transistor model.  Please note that it doesn't matter for an
  1936.           AC analysis whether the transistor is NPN or PNP.
  1937.  
  1938.           From the editor press F2.  This will start the Model Maker
  1939.           function.  A window will appear and ask first for the node
  1940.           numbers for base, emitter and collector.  You would just
  1941.           enter 2, 0, and 3.  Then you will be asked for the
  1942.           information mentioned above.  After answering all the
  1943.           questions your model will be created and inserted into your
  1944.           circuit description on the line following the cursor.
  1945.  
  1946.           For this circuit we might want to know just how good a
  1947.           frequency response we have, so let's sweep a frequency range
  1948.           of 1 KHz to 100 MHz.  And let's do it logarithmically.  With
  1949.           node 1 as the input and node 3 as the output, this line
  1950.           should make PC-ECAP do what we want:
  1951.  
  1952.                     P 1 3 1KHZ 100MEG LOG
  1953.  
  1954.           As you might notice, PLOT can be abbreviated to P.
  1955.  
  1956.           That's all there is to it.  Run an analysis and see what
  1957.           kind of amplifier we have.  You should also try changing
  1958.           some component values to see what happens.  What happens if
  1959.           you decrease R1?  Or increase it?           PC-ECAP Reference Manual                          page 38
  1960.  
  1961.           Models
  1962.  
  1963.           The circuit models that PC-ECAP uses for Transformers,
  1964.           Bipolar transistors, FET's, Operational Amplifiers, and
  1965.           Transconductance Amplifiers are ideal models.  If you
  1966.           desire, you can easily create models that are more complex.
  1967.  
  1968.           For Bipolar transistors if your need a better model just use
  1969.           the "Model Maker" feature in the editor.  As previously
  1970.           discussed, a Hybrid-Pi transistor model will be created and
  1971.           inserted into your circuit description.
  1972.  
  1973.           For the transformer, the addition of two inductors will make
  1974.           a transformer that is quite "real".  You can add an inductor
  1975.           in parallel with the primary to model the transformer's
  1976.           magnetizing inductance.  This inductor should be equal to
  1977.           the transformer's primary inductance.  The transformer's
  1978.           manufacturer can supply the inductor value for this or you
  1979.           can measure it yourself (the secondary should be open for
  1980.           this test).  A second inductor can be added in series with
  1981.           the primary winding (and the inductor paralleling the
  1982.           primary).  This inductor will model the transformer's
  1983.           "leakage" inductance.  This inductance is due to the
  1984.           magnetic field that does not couple the primary and
  1985.           secondary windings.  Again, the transformer's manufacturer
  1986.           can supply this or you can measure it (measure the primary
  1987.           inductance as before, but this time short out the
  1988.           secondary).  By adding these two inductors, you will create
  1989.           a transformer that has a finite bandwidth.  The parallel
  1990.           inductor affects the low frequencies and the series inductor
  1991.           will affect the high frequencies.
  1992.  
  1993.           For FET's, the addition of a capacitor to model the gate to
  1994.           source capacitance and a second one to model the gate to
  1995.           drain capacitance will improve accuracy at high frequencies.
  1996.           You can get the appropriate values from your transistor's
  1997.           data sheet.  Also the Siliconix Low Power Discretes data
  1998.           book is an excellent source for more information on this.
  1999.  
  2000.           For FET's:     Cgs = Ciss - Cgd = Ciss - Crss
  2001.  
  2002.                          Cgd = Crss
  2003.  
  2004.           Operational Amplifiers today are usually frequency
  2005.           compensated internally.  Most of the time a method called
  2006.           "dominant pole compensation" is used.  This method inserts a
  2007.           pole in the opamp's frequency response at a very low
  2008.           frequency.  This pole will dominate the response (hence the
  2009.           name) and roll off at a 20 db/decade rate.  The opamp model
  2010.           that PC-ECAP uses is not frequency dependent.  The open-loop
  2011.           gain that you ask for is the gain that you will get for all
  2012.           frequencies.  It's not that difficult to make an opamp model
  2013.           that will decrease its gain as frequency increases.  Such a
  2014.           model is included on your disk as OPAMPMOD.DAT.  Please take
  2015.           a look at it.           PC-ECAP Reference Manual                          page 39
  2016.  
  2017.           References for Modeling
  2018.  
  2019.           Although we have tried to give you some useful information
  2020.           to use for modeling circuit elements, a full treatment of
  2021.           the subject is beyond the scope of this manual.  For those
  2022.           of you who are interested, a good college library should
  2023.           have several books that might help.  Two references that may
  2024.           be more readily available for many people are:
  2025.  
  2026.           "National Semiconductor Linear Applications Handbook" from
  2027.  
  2028.           National Semiconductor Corporation
  2029.           2900 Semiconductor Drive
  2030.           Santa Clara, CA 95052-8090
  2031.  
  2032.           This handbook has an excellent paper entitled "The
  2033.           Monolithic Operational Amplifier: A Tutorial Study".  This
  2034.           paper tells you just about everything that you would want to
  2035.           know about the inner workings of opamps.
  2036.  
  2037.           A good reference for FET's in general is:
  2038.  
  2039.           "Siliconix Low Power Discretes Data Book" by
  2040.  
  2041.           Siliconix Incorporated
  2042.           2201 Laurelwood Rd.
  2043.           Santa Clara, CA 95054-1516
  2044.  
  2045.           They have several interesting application notes on the use
  2046.           of FET's.
  2047.  
  2048.  
  2049.           Parting Comments
  2050.  
  2051.           A considerable amount of time and effort was expended to
  2052.           develop PC-ECAP.  We sincerely hope that you feel it was all
  2053.           worth it.  We want you to know that we don't intend to stop
  2054.           here.  We have even more ideas for enhancements we would
  2055.           like to add in future releases.  But it is you that will
  2056.           make it possible.  By registering your copy of PC-ECAP, you
  2057.           will help make the possible into reality.  Thanks for your
  2058.           support.           PC-ECAP Reference Manual                          page 40
  2059.  
  2060.           Revision History
  2061.  
  2062.           Version 3.01 - 1/24/94
  2063.           Some Super VGA cards using Western Digital 90C31 or 90C31
  2064.           chips have a bug in their video BIOS.  This causes PC-ECAP
  2065.           to hang on program startup.  A work around has been added
  2066.           to solve this problem.  Added /v and /vm switches to force
  2067.           640x480 graphics modes.  Also added the tab key to editor.
  2068.  
  2069.           Version 3.00 - 11/01/93
  2070.           Added Transient analysis calculations.  Added transmission
  2071.           lines as circuit elements.  Added zoom and print features to
  2072.           plot screen.  Added support for HP DeskJets.  Improved
  2073.           support for HP LaserJet Series I.  Now displays more digits
  2074.           of frequency when plotting narrow band high frequency
  2075.           graphs.  Analysis routine is now 40-100% faster.
  2076.  
  2077.           Version 2.10a - 8/18/93
  2078.           In some rare situations, graphs would autoscale improperly.
  2079.           Fixed.
  2080.  
  2081.           Version 2.10 - 11/09/92
  2082.           Now handles circuits with up to 90 nodes.  Added option to
  2083.           print only circuit description and graphs.  Negative
  2084.           inductor values are now accepted.  Changed listing format
  2085.           for frequencies of 10 GHz and above.  Added network (LAN)
  2086.           support.  Fixed "border flash" when switching from graphics
  2087.           to text mode on some CGA cards.  Added table of contents to
  2088.           manual.
  2089.  
  2090.           Version 2.01 - 2/03/92
  2091.           Improved syntax checking on the circuit description files.
  2092.           More input errors are spotted and flagged.
  2093.  
  2094.           Version 2.00 - 10/14/91
  2095.           Added group delay, impedance, VSWR and return loss
  2096.           calculations.  Now has full support for 24 pin printers.
  2097.           Now supports HP LaserJet.  Editor has been enhanced.
  2098.           Analysis routine is now twice as fast as previous versions.
  2099.           Added AT&T and MCGA support.  Added support for a math
  2100.           coprocessor.  European format for element values now
  2101.           accepted.  Improved error checking on circuit description
  2102.           files.  International time and date on printouts now
  2103.           supported.  Numbers are now stored in IEEE binary format.
  2104.           No longer supports "non-compatible" video.  Now requires
  2105.           384K of system memory.
  2106.  
  2107.           Version 1.11 - 11/23/90
  2108.           Added the filename to the headers and plot sheet of the
  2109.           printout.  Negative resistance values are now accepted.
  2110.           Fixed bug in hard copy plotting routine - plot would display
  2111.           spurious points if the plot exceeded the maximum range.
  2112.           Fixed bug in analysis routine; Occasionally, a circuit with
  2113.           a very wide range of reactive component values could create
  2114.           an internal numeric overflow.           PC-ECAP Reference Manual                          page 41
  2115.  
  2116.           Version 1.10 - 9/14/90
  2117.           Added the option of 35 sample points to the select number of
  2118.           sample points menu.  Greatly increased the number of plot
  2119.           ranges available when displaying results.  Magnitude now
  2120.           spans .1 db/div to 80 db/div and Phase now spans 22.5
  2121.           degrees/div to 720 degrees/div.
  2122.  
  2123.           Version 1.02 - 1/30/90
  2124.           First release widely distributed.           PC-ECAP Reference Manual                          page 42
  2125.  
  2126.                         Appendix A - Command Line Switches
  2127.  
  2128.  
  2129.           PC-ECAP will automatically determine the type of video
  2130.           display adapter that your computer uses and will set itself
  2131.           accordingly.  There are a few situations where it is not
  2132.           possible to accurately determine the adapter type.  For
  2133.           example, if a monochrome monitor is used with a CGA card,
  2134.           the program has no way of knowing that.  Also, there are
  2135.           some advanced EGA cards that will change their display mode
  2136.           to match a given program.  Since PC-ECAP is trying to change
  2137.           its mode to match the video adapter, there can be no
  2138.           guarantee as to what you will actually wind up with.
  2139.  
  2140.           In order to accommodate these situations (as well as others
  2141.           that may be unforeseen at this time) PC-ECAP has a series of
  2142.           optional command line switches that can be used to set the
  2143.           video display mode.
  2144.  
  2145.           To start PC-ECAP with a command line option, type this at
  2146.           the DOS prompt:
  2147.  
  2148.                     ECAP    [ option ]
  2149.  
  2150.           Where "option" is one of the following:
  2151.  
  2152.                /H        Hercules Monochrome Graphics card (or
  2153.                          compatible).
  2154.  
  2155.                /C        Color/Graphics Adapter with color monitor.
  2156.  
  2157.                /CM       Color/Graphics Adapter with monochrome
  2158.                          monitor.  For use with Compaq monochrome
  2159.                          display or computers having LCD displays.
  2160.  
  2161.                /E        Enhanced Graphics Adapter with EGA monitor.
  2162.  
  2163.                /EC       Enhanced Graphics Adapter with CGA monitor.
  2164.  
  2165.                /EM       Enhanced Graphics Adapter with monochrome
  2166.                          monitor.
  2167.  
  2168.                /MC       Multi-Color Graphics Array.
  2169.  
  2170.                /M        Monochrome Display Adapter.
  2171.  
  2172.                /A        AT&T or Olivetti video adapter with color
  2173.                          monitor.
  2174.  
  2175.                /AM       AT&T or Olivetti video adapter with
  2176.                          monochrome monitor.  May also be useful for
  2177.                          some Laptop computers.
  2178.  
  2179.                /V        VGA Adapter with color monitor.  640x480
  2180.  
  2181.                /VM       VGA Adapter with monochrome monitor.  640x480           PC-ECAP Reference Manual                          page 43
  2182.  
  2183.                            Appendix B - Error Messages
  2184.  
  2185.  
  2186.           ABORT -- Bad circuit description
  2187.  
  2188.                The PLOT statement must be the last line of your
  2189.                circuit description.  You have entered additional
  2190.                circuit elements after the PLOT statement.  Move these.
  2191.  
  2192.  
  2193.           ABORT -- Blinking nodes have been skipped
  2194.  
  2195.                You have skipped over one or more nodes in your circuit
  2196.                description.  Node numbers must begin at 0, and be
  2197.                numbered consecutively.
  2198.  
  2199.  
  2200.           ABORT -- Blinking nodes have less than two components
  2201.  
  2202.                Your circuit description has one or more "dangling"
  2203.                components.  All nodes (other than the input) must have
  2204.                at least two components attached.
  2205.  
  2206.  
  2207.           ABORT -- Insufficient memory for operation
  2208.  
  2209.                PC-ECAP makes extensive use of dynamic memory.  That
  2210.                is, memory that it allocates only when needed.
  2211.                Although this makes for very efficient memory usage,
  2212.                peak memory requirements can not be known up front.
  2213.                Your only choice here is to do without the feature
  2214.                that gave you this error or get more RAM memory for
  2215.                your computer.  PC-ECAP can use Upper Memory Blocks
  2216.                (UMB's) if you have DOS 5 or greater.  Be sure you
  2217.                have UMB support enabled.
  2218.  
  2219.  
  2220.           ABORT -- Invalid circuit element
  2221.  
  2222.                You have an unknown circuit element in your circuit
  2223.                description file.  Valid lines must be either blank,
  2224.                begin with a semicolon ";" (if a comment), or begin
  2225.                with one of the letters of a circuit element.
  2226.  
  2227.  
  2228.           ABORT -- Invalid node number
  2229.  
  2230.                You have a circuit element that has one or more node
  2231.                numbers that is not an integer, is negative or is
  2232.                greater than 89.           PC-ECAP Reference Manual                          page 44
  2233.  
  2234.           ABORT -- Invalid reference impedance
  2235.  
  2236.                You have asked to compute the VSWR or return loss for a
  2237.                circuit, but have not specified an impedance to
  2238.                reference these calculations to.  Or your impedance is
  2239.                negative or zero.  Must be a positive value.
  2240.  
  2241.  
  2242.           ABORT -- Too many circuit nodes
  2243.  
  2244.                You have 1 or more circuit nodes with a number greater
  2245.                than 89, either because you actually have a circuit
  2246.                with more than 90 nodes or you have made a typo and
  2247.                have inadvertently skipped some.
  2248.  
  2249.  
  2250.           ABORT -- Too many circuit elements
  2251.  
  2252.                You have exceeded the limit of 1000 circuit elements.
  2253.                R, C, L, Transmission lines, Fet's and Transconductance
  2254.                amplifiers each count as one circuit element.  OpAmps
  2255.                and Bipolar transistors count as two.  Transformers
  2256.                count as four.
  2257.  
  2258.  
  2259.           ABORT -- Too many transmission lines
  2260.  
  2261.                You have more than 64 transmission lines in your
  2262.                circuit.
  2263.  
  2264.  
  2265.           ABORT -- Unknown parameter specified
  2266.  
  2267.                You have listed a parameter that is unrecognized and
  2268.                unexpected.  Recheck the syntax of the line displayed.
  2269.  
  2270.  
  2271.           ABORT -- Unknown sweep type
  2272.  
  2273.                You have specified a sweep type that is something other
  2274.                than LINear, LOGarithmic or TRANsient (may be
  2275.                abbreviated to the letters shown capitalized).
  2276.  
  2277.  
  2278.           ABORT -- Wave type not specified
  2279.  
  2280.                You have asked for a transient analysis, but have
  2281.                omitted the type of waveform to be used as input.           PC-ECAP Reference Manual                          page 45
  2282.  
  2283.           CAUTION! Conflicting transistor parameters supplied
  2284.  
  2285.                The data that you have entered for your transistor
  2286.                doesn't make any sense.  For example - you may have
  2287.                said that your transistor has a very high cutoff
  2288.                frequency and then specified a huge base to collector
  2289.                capacitance.  Or you may have specified a very low
  2290.                collector current and a high cutoff frequency.  Things
  2291.                that contradict each other.  Recheck your data and
  2292.                change if necessary.
  2293.  
  2294.  
  2295.           ECAPHERC.DRV is not found
  2296.  
  2297.                You have a Hercules or Hercules compatible graphics
  2298.                card, and the required driver ECAPHERC.DRV is missing.
  2299.                This driver is needed to display text when PC-ECAP is
  2300.                in graphics mode.  If you have DOS version 3.0 or
  2301.                greater, PC-ECAP will look for this file in the same
  2302.                directory that contains ECAP.EXE.  This may be
  2303.                different than the directory that contains your circuit
  2304.                files.  Otherwise, ECAP.EXE and ECAPHERC.DRV should be
  2305.                in the current directory.
  2306.  
  2307.  
  2308.           File is currently being used by someone else
  2309.  
  2310.                You can get this message when you are running PC-ECAP
  2311.                on a network or multi-user system and you attempt to
  2312.                access a file that is already in use.  Wait until the
  2313.                file is available or pick a different file.
  2314.  
  2315.  
  2316.           Floating point math error -
  2317.  
  2318.                It should not be possible to get this error.  If it has
  2319.                occurred, please send us a complete description of what
  2320.                you did to get it, so that we may look into the
  2321.                problem.
  2322.  
  2323.  
  2324.           Input File Size Limit Reached
  2325.  
  2326.                PC-ECAP allocates a 500 line buffer for its editor.
  2327.                Your circuit description file has exceeded this amount.
  2328.                The only way this should happen is if you have filled
  2329.                your circuit description file with comments or other
  2330.                nonessential information.  Remove the extra data.
  2331.  
  2332.  
  2333.           Insufficient disk space
  2334.  
  2335.                Well, what can we say, your disk is full.  Delete those
  2336.                files that you really don't need or get a bigger disk.           PC-ECAP Reference Manual                          page 46
  2337.  
  2338.           LPT1, LPT2 or LPT3 is not ready
  2339.  
  2340.                You requested PC-ECAP to print something but your
  2341.                printer isn't ready.  Check to see that your printer's
  2342.                power is turned on.  Also check to see if your
  2343.                printer's cable is connected.  You will also get this
  2344.                message if you try to print on a printer that does not
  2345.                exist.
  2346.  
  2347.  
  2348.           No files found.  Enter name of new file.
  2349.  
  2350.                When you tried to select an input file, PC-ECAP didn't
  2351.                find any that had the extension ".DAT".  If you
  2352.                actually believe that there should be circuit
  2353.                description files in you current directory, quit
  2354.                PC-ECAP and check to see if you are in the correct
  2355.                directory.
  2356.  
  2357.  
  2358.           Not enough space for . . .
  2359.  
  2360.                You are out of memory and PC-ECAP is unable to load.
  2361.                Remove any TSR programs from memory or get more memory
  2362.                for your computer.
  2363.  
  2364.  
  2365.           Please create this file or select another
  2366.  
  2367.                You have asked for an analysis of a circuit that does
  2368.                not exist.  Use the text editor to create a circuit
  2369.                description file for your circuit.
  2370.  
  2371.  
  2372.           Please run an analysis or select another
  2373.  
  2374.                You have asked to see the results of a circuit that you
  2375.                haven't analyzed yet.  Run an analysis.
  2376.  
  2377.  
  2378.           Unable to delete "filename"
  2379.  
  2380.                You tried to delete a file that was most likely marked
  2381.                as Read Only.  Check to see if this is the case and
  2382.                change the file's attribute if necessary.
  2383.  
  2384.  
  2385.           You have enough memory to analyze circuits with
  2386.                up to ## nodes.
  2387.  
  2388.                If your computer has less than 450K of free memory
  2389.                available, you will see this message when you start
  2390.                PC-ECAP.  The program is giving an estimate of the
  2391.                maximum circuit size you can analyze based on the
  2392.                amount of memory in your system.           PC-ECAP Reference Manual                          page 47
  2393.  
  2394.           Your copy of PC-ECAP has been damaged!
  2395.  
  2396.                Someone or something (another program perhaps) has
  2397.                changed your copy of ECAP.EXE.  PC-ECAP checks itself
  2398.                every time it runs and this check has failed.
  2399.                Reinstall the program.           PC-ECAP Reference Manual                          page 48
  2400.  
  2401.                                    Appendix C
  2402.                     PC-ECAP to Lotus 1-2-3 file conversion
  2403.  
  2404.  
  2405.           Included with the REGISTERED version of PC-ECAP is the
  2406.           utility program ECAP2WKS.  This program can be used to
  2407.           convert PC-ECAP ".OUT" files into Lotus 1-2-3 compatible
  2408.           spreadsheets.  This can be very useful if you want to do
  2409.           additional operations on your data, such as normalizing
  2410.           circuit gain at a particular frequency or plotting several
  2411.           quantities on the same graph.
  2412.  
  2413.           These PC-ECAP spreadsheets can be used with just about all
  2414.           of the popular spreadsheet programs such as Lotus 1-2-3,
  2415.           Quattro Pro, Microsoft Excel and the excellent shareware
  2416.           program AS-EASY-AS.
  2417.  
  2418.           To convert a file just type:
  2419.  
  2420.  
  2421.                ECAP2WKS  filename.out
  2422.  
  2423.  
  2424.           Filename.out should of course be the name of the PC-ECAP
  2425.           file that you want to convert.  If you don't specify a file
  2426.           extension, ".OUT" will be assumed.  As an option, you can
  2427.           also specify the name of the converted ".WKS" file.  To do
  2428.           this, just add its name after "filename.out".  The ".WKS"
  2429.           file extension is optional:
  2430.  
  2431.  
  2432.                ECAP2WKS  filename.out   filename.wks
  2433.  
  2434.  
  2435.           ECAP2WKS will accept wildcards.  For example, to convert all
  2436.           files beginning with "BAND", such as "BAND_ONE", "BAND_TWO",
  2437.           etc., type:
  2438.  
  2439.  
  2440.                ECAP2WKS  band*.out
  2441.  
  2442.  
  2443.           And finally, you may also specify full drive and path
  2444.           specifications along with the filenames.  For example:
  2445.  
  2446.  
  2447.                ECAP2WKS  D:\ecap\lowpass.out  C:\lotus\123files\
  2448.  
  2449.  
  2450.           will convert "LOWPASS.OUT" to "LOWPASS.WKS" and place it in
  2451.           the \LOTUS\123FILES subdirectory on drive C:.
  2452.  
  2453.           ECAP2WKS checks to see if the file specified is really a
  2454.           PC-ECAP ".OUT" file before attempting a conversion. 
  2455.