home *** CD-ROM | disk | FTP | other *** search
/ Collection of Hack-Phreak Scene Programs / cleanhpvac.zip / cleanhpvac / GENCSRC.ZIP / VC.DOC < prev    next >
Text File  |  1987-11-21  |  13KB  |  307 lines
  1.               The Visual Calculator - Version 1.10
  2.  
  3.         The visual calculator was written to be used for quick
  4.      calculations of the variety that would ordinarily be done
  5.      with a hand held calculator. There is no allowance for
  6.      programming loops, or indirect variables, or any of the
  7.      other facilities of a modern programming language. There
  8.      are no complications either, and this program should not
  9.      require more than a few minutes for the experienced com-
  10.      puter user to learn to use, and only slightly longer for
  11.      the person inexperienced with computers.
  12.  
  13.         It is suggested that you slowly run through the tutor-
  14.      ial first, performing the operations suggested, then read
  15.      the following comments for a description of the visual
  16.      calculator. This program is intended to be much more comp-
  17.      rehensive than the little on-screen calculators that have
  18.      become popular, but it is not memory resident. Due to the
  19.      expected future popularity of such programs as "Windows",
  20.      this program can be as convenient as the present memory
  21.      resident programs.
  22.  
  23.  
  24.                 The Visual Calculator Tutorial
  25.  
  26.      1. Copy all files to another working diskette with your
  27.         operating system or to a single directory on your hard
  28.         disk.
  29.  
  30.      2. Type VC <return>
  31.            You will get the beginning screen containing the vari-
  32.         able boxes and the help box at the top. The center of the
  33.         screen contains the transcript box, and at the bottom you
  34.         will find the Input box.
  35.  
  36.      3. Type A = 123.45 <return>
  37.            You will find that the value is displayed in the top
  38.         box and the value will also be displayed at the left of
  39.         the input equation in the transcript box.
  40.  
  41.      4. Type B = SQRT(A) <return>
  42.            You will find the square root of A displayed in both
  43.         places next to the variable B. You may have noticed that
  44.         the system doesn't care if you use upper or lower case,
  45.         it forces it to upper case. You now have defined some
  46.         values for the variables A and B.
  47.  
  48.      5. Type D = 1.23*SIN(SQRT(1.2345 + B*B/A)) <return>
  49.            Spaces between variables don't matter and you can put
  50.         them in where you desire to make it look nice. If you get
  51.         an error message, simply use the left and right cursor
  52.         keys along with the delete key to fix up the error and
  53.         hit the return again. You don't even have to be at the
  54.         end of the line to hit the return.
  55.  
  56.      6. Hit the F6 key then <return>
  57.            The F6 requests a file to be read in and if you don't
  58.         specify a filename, it reads in the file named "HELP".
  59.         This would be a good place to store a list of your other
  60.         files in the same manner as this file.
  61.  
  62.      7. Hit the F6 key then type AMORT <return>
  63.            This reads in the file named "AMORT" and calculates
  64.         each line as it reads it in. Notice that it also changed
  65.         the names of the variables that it uses to make them more
  66.         meaningful to you.
  67.  
  68.      8. Type PRINC = 30000 <return>
  69.            This changes the amount of the loan. We would like to
  70.         recalculate the payment which we will in the next few steps.
  71.  
  72.      9. Move the arrow up to the line that starts "PMNT=..." by
  73.         using the up and down arrow keys. When the arrow is point-
  74.         ing at the line in question,...
  75.  
  76.     10. Hit the F9 key.
  77.            This moves the line pointed at, by the little arrow,
  78.         into the input box where it can be modified or used again
  79.         as is.
  80.  
  81.     11. Hit the <return> key.
  82.            This will recalculate the payment based on the new
  83.         principal and the old interest rates and time of repay-
  84.         ment. These could also be changed and the payment
  85.         recalculated.
  86.  
  87.     12. Make sure your printer is ready and hit the F3 key.
  88.            This will cause a "Print on" message to be printed on
  89.         your printer and a little "Print" message to be displayed
  90.         in the upper right of your screen. All equations and the
  91.         results will be printed for a hardcopy of your calculating
  92.         session.
  93.  
  94.     13. Hit the F6 key again
  95.            You will get another prompt for a file name.
  96.  
  97.     14. Type PAYMENT <return>
  98.            This file will be read in that will give you the results
  99.         of your mortgage after the first payment. The results will
  100.         also be printed out.
  101.  
  102.     15. Hit the F6 key again and <return>
  103.            The last file read in will be reused again and the result
  104.         of making the second payment will be displayed on the moni-
  105.         tor and the printer.
  106.  
  107.     16. Repeat step 15 three or four times.
  108.  
  109.     17. Hit the F1 key.
  110.            A help screen will appear describing the various math
  111.         functions available. They can be nested to whatever level
  112.         you desire.
  113.  
  114.     18. Hit the F2 key.
  115.            A help screen will appear with a very brief description
  116.         of the system functions available.
  117.  
  118.     19. Hit the "Home" key.
  119.            You will be immediately transported to the very top of
  120.         the transcript where the welcome message was originally
  121.         seen. The Pgup, Pgdn, Home, and End keys will get you
  122.         through the transcript window very quickly.
  123.  
  124.     20. Move the little arrow to the line that starts "# A-PRINC",
  125.         and hit the F4 key once.
  126.            You will see that the asterisk appears in front of the
  127.         line. This will "mark" the line. Continuing to hit the F4
  128.         key will toggle the asterisk on and off.
  129.  
  130.     21. Move the arrow to the line that starts "# E-EQUITY" and mark
  131.         this line too.
  132.  
  133.     22. Hit the F5 key
  134.            The system is now prompting you for a file name to
  135.         output to.
  136.  
  137.     23. Type STUFF <return>
  138.            This is simply a filename. Any valid filename could be
  139.         used. All lines in the transcript box that are "marked"
  140.         will be output to the file "STUFF".
  141.  
  142.     24. Hit the F6 key and type STUFF <return>
  143.            All of the lines that were just output will be read in
  144.         and all calculations will be done.
  145.  
  146.     25. Hit the F3 key if the printer is still on.
  147.  
  148.     26. Hit the F6 key and <return>
  149.            The file will be read in again without printing.
  150.  
  151.     27. Hit the F10 key and answer the prompt with Y to end the
  152.         session.
  153.  
  154.     28. Type VC <return> again to restart the program.
  155.  
  156.     29. Hit the F6 key, type TEST <return>
  157.            A file with 50 lines will be read in and all calcu-
  158.         lations performed as an example of the kinds of equations
  159.         that can be evaluated.
  160.  
  161.     30. Type the following; # I-D J-O K-H L-X <return>
  162.            This tells the system that we want the variable "I" to
  163.         print out in Decimal notation, the variable "J" to print
  164.         out in Octal notation, and "K" and "L" to print out in
  165.         HeXadecimal notation. (Note - the # must be in the first
  166.         column.)
  167.  
  168.     31. Type I = 12345 <return>
  169.            The variable I will be displayed in all three notations
  170.         in the top box and in decimal notation in the transcript
  171.         box.
  172.  
  173.     32. Type J = 12345 <return>
  174.            The variable J will be displayed in Octal notation in
  175.         the transcript box and on the printer if it is turned
  176.         on and ready.
  177.  
  178.     33. Type K = 12345 <return>
  179.            The variable K will be displayed in Hex notation in the
  180.         transcript box.
  181.  
  182.     34. Type I = 012345 <return>
  183.            The value of I is read in as an octal value due to the
  184.         leading zero, but is still displayed as a decimal value.
  185.  
  186.     35. Type J = 0X12345 <return>
  187.            The value of J is read in as a hexadecimal value due to
  188.         the leading 0X.
  189.  
  190.     36. Type M = 0XFFFF <return>
  191.            The variable M is read in as Hexadecimal and displayed
  192.         in all three formats in the top box, but as decimal in the
  193.         transcript box. The default display for the integers is
  194.         decimal.
  195.  
  196.  
  197.     37. Type I = SQRT(48) <return>
  198.            The square root is calculated using 15 significant
  199.         digits and the result is truncated to the next lower
  200.         value. All calculations are done this way and the result
  201.         is truncated to the integer value before display.
  202.  
  203.     38. Type A = FACT(170)/FACT(169) - 170 <return>
  204.            The very small result will indicate to you a measure
  205.         of the accuracy of calculations. It may not be apparent
  206.         to you that we are using a factorial function. Calculate
  207.         the value of FACT(170) to get an idea of the dynamic
  208.         range available with this system.
  209.  
  210.     39. Hit the F10 key and answer the prompt with Y.
  211.  
  212.     40. Restart the program and try some of your favorite math
  213.         exercises.
  214.  
  215.  
  216.                          Additional Comments
  217.  
  218.  
  219.      1. Files on the distribution disk.
  220.  
  221.         VC.DOC - The file you are reading.
  222.  
  223.         VC.EXE - The executable file for the Visual Calculator.
  224.  
  225.         HELP - The users index of files.
  226.  
  227.         AMORT - The loan amortization equations.
  228.  
  229.         PAYMENT - The monthly payment calculations.
  230.  
  231.         TEST - A group of 50 "nonsense" equations.
  232.  
  233.  
  234.      2. Inputting equations.
  235.  
  236.            All equations are typed into the input box in a normal
  237.         mathematical expression. Only single valued expressions
  238.         can be evaluated, no simultaneous equations can be solved
  239.         with this system.
  240.  
  241.            To raise "A" to the power of "B", use;
  242.         C = EXP(B*LOG(A))  $ any variables can be used
  243.  
  244.            A dollar sign anywhere in a line renders the remainder
  245.         of that line as a comment only.
  246.  
  247.            Nesting is allowable to any depth but the entire expres-
  248.         sion must fit in the input window. Longer expressions must
  249.         be broken down into smaller statements.
  250.  
  251.            The variables "I" through "J" can be mixed in with the
  252.         variables "A" through "F" in any manner. The "I" variables
  253.         are truncated after evaluation so can only be used to
  254.         store integer values, but that would be acceptable in many
  255.         cases, such as the original value of the loan in the above
  256.         example.
  257.  
  258.  
  259.      3. Naming variables
  260.  
  261.            In order to make the equations easier to read, the names
  262.         of the variables "A" through "F" can be changed to any
  263.         names you like with up to 6 characters. The first must be
  264.         alphabetic and the rest can be alphabetic or numeric. To
  265.         change the names, use the # sign in the first column of the
  266.         statement and any order of variable name groups. A variable
  267.         group is composed of a variable name "A" through "F", then
  268.         a minus sign, and finally the new name with no blanks any-
  269.         where in the group. Any number of blanks can be used between
  270.         the groups, and you can put as many as you like on one input
  271.         line, and additional groups on other lines.
  272.  
  273.            Intermixed with the above, or placed on their own input
  274.         line, you can put as many "base" groups as you like for the
  275.         variables "I" through "N". A base group consists of the
  276.         variable name, a minus sign, and one of the letters, "D",
  277.         "O", "H", or "X".
  278.  
  279.            If, after naming the variables, you wish to rename them
  280.         to something else, the original names are used for the new
  281.         name changes. Thus if "A" were named "PLACE" and you wished
  282.         to rename it to "WHERE" the proper method would be to use
  283.         "# A-WHERE".
  284.  
  285.  
  286.      4. Limitations
  287.  
  288.            This version of the Visual Calculator has a limit of
  289.         approximately 800 lines in the transcript box. That should
  290.         be enough for most applications. If you need more, I would
  291.         suggest you write the program in a high level language.
  292.  
  293.            The limit of numbers is about ten to the plus or minus
  294.         power of 308. Of course both positive and negative numbers
  295.         can be used everywhere. The limit for the "I" variables is
  296.         about 16 million, and can only be zero or positive. The
  297.         exact number in 2 to the 24th power minus 1. It is the
  298.         number displayed in the variable "N" when you load the
  299.         system.
  300.  
  301.            The biggest limitation of the system is the limit of your
  302.         own creativity. It is up to you to use it in a productive
  303.         manner or simply to allow it to collect dust like so many
  304.         of your other programs. I might add that I also have many
  305.         dust collectors that I have failed to learn to use.
  306.  
  307.