home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 September / Simtel20_Sept92.cdr / msdos / calcultr / tsfunc13.arc / TSFUNC.INF < prev    next >
Text File  |  1988-12-27  |  5KB  |  142 lines
  1.                            - 1 -
  2. 27th December, 1988
  3.  
  4. About TSFUNCxx.xxx in General
  5. =============================
  6.  
  7. This package may be used and distributed freely for NON-COMMERCIAL,
  8. NON-INSTITUTIONAL, PRIVATE purposes, provided it is not changed in any way.
  9. No part of this package may be distributed separately. No charge for the
  10. programs is allowed without an explicit consent of the author.
  11.  
  12. The programs are under development. Comments and contacts are welcome. If
  13. you have any comments, please do not hesitate to use electronic mail for
  14. communication.
  15. Funet address:    VAKK::SALMI
  16. Internet address: SALMI@VAKK.UWASA.FI
  17. Bitnet address:   SALMI@FINFUN
  18. FidoNet address:  2:515/1 (Micro Maniacs Opus, To: Timo Salmi)
  19.  
  20. The author shall not be liable to the user for any direct, indirect or
  21. consequential loss arising from the use of, or inability to use, any program
  22. or file howsoever caused. No warranty is given that the programs will work
  23. under all circumstances.
  24.  
  25. Timo Salmi
  26. Professor of Accounting and Business Finance
  27. School of Business Studies, University of Vaasa
  28. P.O. BOX 297, SF-65101 Vaasa, Finland
  29.  
  30. CONTENTS:
  31.  
  32.   1. Summary
  33.   2. Common Features
  34.   3. Individual Program Abstracts
  35.   4. Release Notes
  36.  
  37.  
  38. 1. SUMMARY
  39.  
  40. TSFUNC13 - Plot/calculate functions T.Salmi
  41.                                                                     
  42. Filename        Comment                             Date      Time  
  43. --------        --------------------------------    ----      ----  
  44. FN.EXE          Calculator (evaluates functions)  12-20-88  07:40:16
  45. FNP.EXE         Plots any function                12-20-88  07:43:28
  46. FNT.EXE         Tabulates user's function         12-20-88  07:46:34
  47. TSFUNC.INF      Document                          12-20-88  07:53:26
  48. TSPROG.INF      List of PD programs from T.Salmi  12-19-88  14:32:02
  49.  
  50.                            - 2 -
  51.  
  52.  
  53. 2. Common Features
  54.  
  55. The TSFUNC programs are for evaluating expressions, for tabulating function
  56. values, and for plotting functions (in the graphics mode).
  57.  
  58. The general format of the program call is
  59. FNx {expression or function} [the parameters]
  60. e.g. FN  23.4+11.5/2.3
  61. or   FNT 0.01*x^1.5 -1
  62.              │       └─a parameter
  63.              └─the function
  64.  
  65. No blanks are allowed in the expression or function. In a function, the
  66. variable must be denoted by the letter x (case-independent).
  67.  
  68. To get more information about an individual program at run-time, use ? in the
  69. program call: e.g. FNP ?
  70.  
  71. The operators available are + - * / ^ ( )
  72. The functions available are
  73.  abs()      Absolute value         arctan()   Arctangent
  74.  cos()      Cosine                 deg()      Radians to degrees
  75.  ep()       Exponentation          fact()     Factorial
  76.  frac()     Extract decimals       int()      Delete decimals
  77.  ln()       Natural logarithm      log()      Base 10 logarithm
  78.  pi()       The value of Pi        rad()      Degrees to radians
  79.  rnd()      Random value           sin()      Sine
  80.  sqrt()     Square root
  81.  
  82. Many of the potential errors are trapped and pinpointed by the programs. Still,
  83. if you get the message  Runtime error 205 at xxxx:xxxx  it means that your
  84. formula has caused a floating overflow or underflow, or is otherwise invalid.
  85.  
  86.  
  87. 3. INDIVIDUAL PROGRAM ABSTRACTS
  88.  
  89. FN FuNction evaluator, (Ver. 1.2)
  90. =================================
  91.  
  92. Usage: FN expression [decimals]
  93.   e.g. FN 3^2+5.5*sin(rad(90/2))-ln(2) 5
  94.  
  95. Some invalid values:     .6   3.     -2^2.5    (see release notes)
  96. Some valid values  :    0.6   3.5   -(2^2.5)
  97.  The parameter [decimals] is optional. If you omit it, FN selects the output
  98. format. By giving -1 as [decimals] you get the exponential representation.
  99.  FN owes much to the brilliant recursive formula evaluation algorithm in
  100. Stephen K. O'Brien, Turbo Pascal, The Complete Reference. However, the
  101. user interface, validity checks of the formula, and many of the functions
  102. are entirely due to the present author.
  103.  
  104.                            - 3 -
  105.  
  106.  
  107.  
  108. FNT FuNction Table, (Ver. 1.2)
  109. ==============================
  110.  
  111. Usage: FNT expression [first x-value] [last x-value] [increment] [decimals]
  112.   e.g. FNT x^2+5.5*sin(rad(x/2))-ln(x+2) 0.0 10.0 1.0 5
  113.  
  114. The parameters in the brackets [] are optional.
  115. By giving -1 as [decimals] you get the exponential representation.
  116.  
  117.  
  118. FNP FuNction Plotter, (Ver. 1.2)
  119. ================================
  120.  
  121. FNP expression {from x-value} {to x-value} [increment][max x-axis][max y-axis]
  122. e.g. FNP 30-0.1*(x-5)^2 -20 30 1.0 75 50
  123.  
  124. The parameters {from x-value} and {to x-value} are compulsory while
  125. [increment] [max x-axis] and [max y-axis] are optional with defaults
  126. 1.0, 75, and 50. If given, the optional parameters must be positive.
  127.  
  128. The upper left-hand corner of the graphical display gives the plotted
  129. expression. The lower right-hand corner gives the scale of the figure
  130. by displaying the distance between the notches in the axes.
  131.  
  132.  
  133. 4. RELEASE NOTES
  134.  
  135.    The versions 1.1 of all the programs add a leading zero to the formula
  136. if this starts with a minus sign. (E.g. -x^2-4*x+3 would be converted into
  137. 0-x^2-4*x+3.) This is necessary in order to avoid ambiguity in the recursive
  138. function evaluation algorithm in cases of powers of negative values.
  139.    The versions of 1.2 of all the programs no longer require a zero before
  140. the decimal point. Thus e.g. .2 is now valid for 0.2.
  141.    The versions 1.3 have been recompiled with Turbo Pascal 5.0.
  142.