home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 411a.lha / MortCalc / MortCalc.doc < prev    next >
Encoding:
Text File  |  1990-09-08  |  5.9 KB  |  141 lines
  1.                            MortCalc.doc
  2.                            ~~~~~~~~~~~~                    
  3.             MortCalc is freeware. Enjoy and pass it around with all
  4.             the    included files.
  5.  
  6. OPERATION
  7. ~~~~~~~~~
  8. -from the CLI:   MortCalc  <-c -f -s>
  9.  
  10.     where  -c change the default calculation mode from USA to Canada 
  11.            -f change the default language from English to French
  12.            -s displays raw data (6 decimals, not rounded) to the
  13.               standard output (CLI). Can be redirected to the printer 
  14.               with the command line: MortCalc >PRT: -s.
  15.  
  16.     "MortCalc ?" displays a help screen on the CLI.
  17.  
  18. -from the Workbench: just double click on the icon. See PRESELECTION.
  19.  
  20. BUTTONS AND BOXES 
  21. ~~~~~~~~~~~~~~~~~
  22. If you are fluent with Amigese, run MortCalc right away and read
  23. this doc later for the fine points.
  24.  
  25. Select the operation you want to do by clicking in one of the
  26. buttons at the left (PRINCIPAL, RATE, PERIOD, BALANCE or PAYMENT).
  27. The amortization PERIOD is the length of the loan. The selected
  28. button stays highlighted and the STATUS line confirms your selection.
  29. At startup, MortCalc will compute the monthly payments for the figures
  30. displayed in the value boxes (PAYMENT selected). 
  31.  
  32. To change a value, select a box by clicking in it and edit the digits
  33. with the keyboard or the keypad (DEL, Backspace and the left and right
  34. cursor keys work the usual way). You may click CALCULATE anytime. If 
  35. you hit <RETURN> instead, the cursor jumps to the next box. 
  36.  
  37. To clear a box, you may use the Right Amiga-X combination (press X
  38. while holding down the right fancy A key). Clearing a box just makes
  39. room to enter a new value; to really change a value, you have to click
  40. CALCULATE. This button enters all the displayed figures and the result
  41. is highlighted by the cursor in the selected value box.
  42.  
  43. Clicking on the CALCULATE button updates the display and formats the
  44. output with $, %, etc. The value boxes accept any character but will 
  45. read in only digits and decimal points. Naturally, any non-numerical
  46. entry will generate an error message.
  47.  
  48. When the RATE is computed, an error message will be displayed if
  49. real INTEREST equal or exceed PAYMENT.
  50.  
  51. The INTEREST box shows the interest part of the payment (average
  52. monthly value). This is the only box that doesn't accept a direct
  53. input; this value is updated each time a new payment is calculated.
  54. Because it is an average value, it may not always change, for
  55. exemple when you switch from USA to Canada mode. For the same reason,
  56. in some borderline cases, INTEREST may be higher than PAYMENT. This
  57. is also the case, of course, when BALANCE is growing.
  58.  
  59. The CANADA button changes the default mode from USA (monthly 
  60. compounded) to Canada (semiannually compounded). With the startup
  61. values, PAYMENT is $132.15 (USA) and $131.04 (Canada). MortCalc values
  62. have been verified with annuity tables and are very reliable.
  63.  
  64. You can enter any multiple of 12 (1, 2, 3, 4, 6 or 12) in the
  65. "Compounded over ...  months" box. For instance, enter 3 to get
  66. "quarterly compounded".
  67.  
  68. The PRINT button gets you a hard copy of all the values. 
  69. CAUTION: MortCalc may hang if this option is selected while the    
  70. printer is not on-line.
  71.  
  72. To QUIT, hit the Close button in the upper left corner of the
  73. MortCalc window.
  74.  
  75. SHORT CUTS
  76. ~~~~~~~~~~
  77. All the value boxes (exept PERIOD) accept digits only, so you don't
  78. need to enter any comma, $ or % ; CALCULATE does that for you. 
  79.  
  80. As for the PERIOD box, it uses any non-digit character(s) to separate 2
  81. integer fields (years and months). So, the following entries are
  82. equivalent:
  83.  
  84.             10 yrs 2 mo.
  85.             10 ans 2 mois
  86.             10/2
  87.             0y122        (122 months is 10 years and 2 months)
  88.  
  89. Please note that the PERIOD box accepts integers only. All the other
  90. boxes take both integer and decimal values. 
  91.  
  92. You may operate MortCalc without the mouse if you use the arrow keys 
  93. within a box and the <RETURN> key to move from box to box. Place the
  94. mouse pointer on CALCULATE  and simultaneously press left Alt-left Amiga
  95. to simulate a mouse click...
  96.  
  97. ROAD TEST
  98. ~~~~~~~~~
  99. MortCalc can do a lot of things besides calculating your monthly
  100. instalments. For instance, using the startup values, you may want to
  101. know how long it would take to pay the principal if the payments
  102. were set at $150. To find out, select the PERIOD box, then edit
  103. the PAYMENT value box to $150.00 and click CALCULATE. 
  104.     
  105. You may wish to know the balance on a loan after, say, one year.
  106. Just select BALANCE, and enter 1 in the PERIOD box. 
  107.  
  108. Watch out for asymptotic values, else you may have to pay your
  109. mortgage for the whole eternity. For instance, click PERIOD and try
  110. to increment the PRINCIPAL until you get an error message (which
  111. will show up when the PERIOD exceeds 9999 months). You will find out
  112. that at some point just before the error message, a difference of
  113. one miserable dollar in the principal adds *years* of payments. 
  114.  
  115. If you add fractions of cent (say $0.003) to the PAYMENT, you may
  116. notice an increment of a few dollars in PRINCIPAL. The rounding down
  117. of figures also explains why you may have in few cents left in BALANCE
  118. when the amortization PERIOD is over. Use the CLI -s option (raw data)
  119. if you need a precision of more than two decimals. 
  120.   
  121. MortCalc gives you all the figures you need to shop for a mortgage.
  122. You no longer have to take for granted everything your loan agent
  123. tells you, and you may even teach him a trick or two.
  124.  
  125. PRESELECTION OF DEFAULT VALUES
  126. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  127. You may change some startup values by editing the Tool Types
  128. box of the icon (Workbench ICON menu item). ARG1=CAN and ARG2=FR
  129. will change the defaults options to Canada and French, respectively.
  130. Delete these entries to get the default values (USA and English).
  131. Invisible language selection is a welcome feature in a small world
  132. like ours.
  133.  
  134. AGITPROP
  135. ~~~~~~~~
  136. The next version of MortCalc will incorporate weekly and biweekly 
  137. (each other week) compounding if enough users ask for it.
  138.  
  139.                                       
  140.                                                Michel Laliberté
  141.