home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 31 / CDASC_31_1996_juillet_aout.iso / vrac / tsnum13.zip / TSNUM.INF < prev    next >
Text File  |  1996-03-15  |  8KB  |  218 lines

  1.                                   - 1 -
  2. Fri 15-March-1996
  3.  
  4. About TSNUM in General                           All rights reserved
  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
  9. any way. (Repacking with another method  is  ok,  though.)  For  ANY
  10. other  usage,  such as use in a business enterprise or a university,
  11. contact the author for registration. Uploading to bulletin boards is
  12. encouraged.  Please  do  not  distribute  any  part  of this package
  13. separately.
  14.  
  15. The programs are under development. If you have any comments or  bug
  16. reports,   please  do  not  hesitate  to  use  electronic  mail  for
  17. communication.
  18.  
  19. The author shall not be liable to the user for any direct,  indirect
  20. or  consequential loss arising from the use of, or inability to use,
  21. any program or file howsoever caused. No warranty is given that  the
  22. programs will work under all circumstances.
  23.  
  24. Timo Salmi (email: ts@uwasa.fi WWW: http://uwasa.fi/~ts/)
  25. Professor of Accounting and Business Finance
  26. Faculty of Accounting & Industrial Management
  27. University of Vaasa
  28. P.O. BOX 700, FIN-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.  
  41. TSNUM13         Numerical Analysis by Timo Salmi
  42. Filename        Comment
  43. --------        --------------------------------
  44. BISE.EXE        Solves f(x)=0, Bisection Method
  45. EQ2.EXE         Solve linear equations of 2 vars
  46. FILE_ID.DIZ     Brief characterization of tsnum
  47. IC.EXE          Line's intercepts with the axes
  48. LINE.EXE        Equation of line thru two points
  49. POLYR.EXE       All roots of a polynomial
  50. SECA.EXE        Solves f(x)=0, Secant Method
  51. SINTEG.EXE      Integrates f(x), Simpson's rule
  52. TSNUM.INF       Document and a readme
  53. TSNUM.NWS       News announcements about tsnum
  54. TSPROG.INF      List of PD programs from T.Salmi
  55. VAASA.INF       Info: Finland, Vaasa, U of Vaasa
  56. ----            ------             ------  -----
  57. 0012
  58.  
  59.  
  60.                                   - 2 -
  61.  
  62.  
  63. 2. COMMON FEATURES
  64.    ===============
  65.  
  66. The TSNUM programs are for numerical analysis.
  67.  
  68. The general format of the calls to programs involving functions is
  69. PROGRAM {function} [the parameters]
  70. e.g. SECA x^2-7*x+5 1.0
  71.              │       └─a parameter
  72.              └─the function
  73.  
  74. No blanks are allowed in a function. The variable must be denoted by
  75. the letter x (case-independent).
  76.  
  77. To get more information about an individual program use ? in the
  78. program call: e.g. SECA ?
  79.  
  80. The operators available are + - * / ^ ( )
  81. The functions available are
  82.  abs()      Absolute value         arctan()   Arctangent
  83.  cos()      Cosine                 deg()      Radians to degrees
  84.  ep()       Exponentation          fact()     Factorial
  85.  frac()     Extract decimals       int()      Delete decimals
  86.  ln()       Natural logarithm      log()      Base 10 logarithm
  87.  pi()       The value of Pi        rad()      Degrees to radians
  88.  rnd()      Random value           sin()      Sine
  89.  sqrt()     Square root
  90.  
  91. Many of the potential errors are trapped and pinpointed by the
  92. programs. Still, if you get the message "Runtime error 205 at
  93. xxxx:xxxx" it means that your formula has caused a floating overflow
  94. or underflow, or is otherwise invalid.
  95.  
  96. For the theory and methods of numerical analysis see any good
  97. text-book on numerical analysis. Also many programming text-books
  98. give useful information on the subject.
  99.  
  100.  
  101. 3. INDIVIDUAL PROGRAM ABSTRACTS
  102.    ============================
  103.  
  104. BISE.EXE (Ver. 1.1a)  Solves f(x)=0, Bisection Method
  105. ====================
  106.  
  107. The program uses the bisection method for finding a root of f(x) = 0
  108. between the initial values. To find the suitable initial values,
  109. first draw the function, e.g. with FNP.EXE, and/or tabulate it with
  110. FNT.EXE. They both are available in
  111.  ftp://garbo.uwasa.fi/pc/ts/tsfunc13.zip
  112.  Calculates, tabulates, and plots your functions
  113.  
  114. Usage: BISE f(x) {initial value left} {initial value right} [decimals]
  115.   e.g. BISE x^2-7*x+5 0 5 5
  116.  
  117. The parameters in the brackets [] are optional.
  118. By giving -1 as [decimals] you get the exponential representation.
  119.  
  120.  
  121.                                   - 3 -
  122.  
  123.  
  124. EQ2.EXE (Ver. 1.1a)  Solve linear equations of 2 vars
  125. ===================
  126.  
  127. The program solves simultaneous equations of two variables.
  128.   a1*x1 + b1*x2 = c1         e.g.    5X1 +   5X2 =  400
  129.   a2*x1 + b2*x2 = c2               200X1 + 300X2 = 2100
  130.  
  131. Usage: EQ2 a1 b1 c1 a2 b2 c2 [decimals]
  132.   e.g. EQ2 5 5 400 200 300 2100 5
  133.  
  134. The parameter in the brackets [] are optional.
  135. By giving -1 as [decimals] you get the exponential representation.
  136. ------------------------------------------------------------------------------
  137.  
  138.  
  139. IC (Ver. 1.1)  Line's intercepts with the axes
  140. =============
  141.  
  142. The program solves the intercepts of a line with the axes.
  143.  
  144. Usage: IC a b c [decimals]
  145.   e.g. IC 200 300 2100 5
  146. ------------------------------------------------------------------------------
  147.  
  148.  
  149. LINE.EXE (Ver. 1.1a)  Equation of line thru two points
  150. ====================
  151.  
  152. Calculates the equation of a line passing through two given points.
  153.  
  154. The equation of the line will be given in two different formats:
  155.  1) Y = a + bX
  156.  2) aX + bX = c
  157. If the latter contains fractional coefficients, the program will
  158. attempt to find an equivalent equation with integer coefficients.
  159.  
  160. Usage: LINE x1 y1 x2 y2 [number of decimals]
  161.    or: LINE ?
  162.  
  163. By giving -1 as the optional [number of decimals] parameter you get
  164. the exponential representation.
  165. ------------------------------------------------------------------------------
  166.  
  167.  
  168. POLYR.EXE (Ver. 1.0a)  All roots of a polynomial
  169. =====================
  170.  
  171. Usage: POLYR a(0) a(1) a(2) ... a(N)
  172. To solve a(0) + a(1)X + a(2)X^2 + ... + a(N)X^N = 0
  173.    or: POLYR ?
  174.  
  175. This programs solves all the roots of a polynomial of the Nth
  176. degree. The algorithm is Laguerre's method as presented in Turbo
  177. Pascal 4.0 numerical toolbox by Borland International Inc. It is
  178. used in accordance with Borland's no-nonsense licence statement.
  179. ------------------------------------------------------------------------------
  180.  
  181.  
  182.                            - 4 -
  183.  
  184.  
  185. SECA.EXE (Ver. 1.1a)  Solves f(x)=0, Secant Method
  186. ====================
  187.  
  188. The program uses the secant method for finding a root of f(x) = 0
  189. near the initial value. To find a suitable initial value, first draw
  190. the function, e.g. with FNP.EXE, and/or tabulate it with FNT.EXE.
  191. They both are available in TSFUNCxx.ZIP. This is particularly useful
  192. if the function has several roots.
  193.  
  194. Usage: SECA f(x) [initial value] [decimals]
  195.   e.g. SECA x^2-7*x+5 1.0 5
  196. ------------------------------------------------------------------------------
  197.  
  198.  
  199. SINTEG.EXE (Ver. 1.1a)  Integrates f(x), Simpson's rule
  200. ======================
  201.                                                                        ⌠a
  202. The program uses Simpson's method for evaluating the definite integral │ f(x)
  203.                                                                        ⌡b
  204.  
  205. Usage: SINTEG f(x) {lower bound} {upper bound} [intervals] [decimals]
  206.   e.g. SINTEG x+ln(x) 1 2.7182818 100 5
  207. ------------------------------------------------------------------------------
  208.  
  209.  
  210. 4. RELEASE NOTES
  211.    =============
  212.  
  213. Since versions 1.1 the programs recognize e.g. .1 as 0.1. Earlier
  214. using a decimal value without the leading zero caused an error. This
  215. resulted from the way Turbo Pascal converts strings into numerical
  216. values. Version 1.2 of the package introduces the POLYR.EXE program.
  217. For later release notes please see TSNUM.NWS.
  218.