home *** CD-ROM | disk | FTP | other *** search
/ CD Actual 14 / CDACTUAL.iso / cdactual / demobin / share / program / Basic / REALFUN.ZIP / COMPTOP.TXT < prev    next >
Encoding:
Text File  |  1991-06-01  |  11.8 KB  |  205 lines
  1.  
  2.  
  3. RealFun:  Real & Complex Math Libraries for QuickBASIC
  4.  
  5. COMPTOP.TXT
  6.  
  7.  
  8.  
  9. All the functions and subprograms included in the compfun library, organized
  10.  
  11. by topic:
  12.  
  13.  
  14.  
  15.         Minimum & Maximum (real only)
  16.  
  17. Usage                           Inputs          Outputs         Notes
  18.  
  19. z = amin(x, y)                  x, y; sp        z, sp           min of x, y
  20.  
  21. z# = dmin(x#, y#)               x#, y#; dp      z#, dp          min of x#, y#
  22.  
  23. z = amax(x, y)                  x, y; sp        z, sp           max of x, y
  24.  
  25. z# = dmax(x#, y#)               x#, y#; dp      z#, dp          max of x#, y#
  26.  
  27.  
  28.  
  29.         Cosine
  30.  
  31. Usage                           Inputs          Outputs         Notes
  32.  
  33. y = COS(x)                      x, sp           y, sp           x in radians
  34.  
  35. y# = COS(X#)                    x#, dp          y#, dp          x# in radians
  36.  
  37. y = cosd(x)                     x, sp           y, sp           x in degrees
  38.  
  39. y# = dcosd(x#)                  x#, dp          y#, dp          x# in degrees
  40.  
  41. call ccos(x, y, u, v)           x, y; sp        u, v; sp        complex
  42.  
  43. call cdcos(x#, y#, u#, v#)      x#, y#; dp      u#, v#; dp      complex
  44.  
  45.  
  46.  
  47.         Sine
  48.  
  49. Usage                           Inputs          Outputs         Notes
  50.  
  51. y = SIN(x)                      x, sp           y, sp           x in radians
  52.  
  53. y# = SIN(X#)                    x#, dp          y#, dp          x# in radians
  54.  
  55. y = sind(x)                     x, sp           y, sp           x in degrees
  56.  
  57. y# = dsind(x#)                  x#, dp          y#, dp          x# in degrees
  58.  
  59. call csin(x, y, u, v)           x, y; sp        u, v; sp        complex
  60.  
  61. call cdsin(x#, y#, u#, v#)      x#, y#; dp      u#, v#; dp      complex
  62.  
  63.  
  64.  
  65.         Tangent
  66.  
  67.  
  68.  
  69. Usage                           Inputs          Outputs         Notes
  70.  
  71. y = TAN(x)                      x, sp           y, sp           x in radians
  72.  
  73. y# = TAN(X#)                    x#, dp          y#, dp          x# in radians
  74.  
  75. y = tand(x)                     x, sp           y, sp           x in degrees
  76.  
  77. y# = dtand(x#)                  x#, dp          y#, dp          x# in degrees
  78.  
  79. call ctan(x, y, u, v)           x, y; sp        u, v; sp        complex
  80.  
  81. call cdtan(x#, y#, u#, v#)      x#, y#; dp      u#, v#; dp      complex
  82.  
  83.  
  84.  
  85.         Inverse Cosine
  86.  
  87.  
  88.  
  89. Usage                           Inputs          Outputs         Notes
  90.  
  91. y = acos(x)                     x, sp           y, sp           y in radians
  92.  
  93. y = acosd(x)                    x, sp           y, sp           y in degrees
  94.  
  95. y# = dacos(x#)                  x#, dp          y#, dp          y# in radians
  96.  
  97. y# = dacosd(x#)                 x#, dp          y#, dp          y# in degrees
  98.  
  99. call cacos(x, y, u, v)          x, y; sp        u, v; sp        complex
  100.  
  101. call cdacos(x#, y#, u#, v#)     x#, y#; dp      u#, v#; dp      complex
  102.  
  103.  
  104.  
  105.         Inverse Sine
  106.  
  107.  
  108.  
  109. Usage                           Inputs          Outputs         Notes
  110.  
  111. y = asin(x)                     x, sp           y, sp           y in radians
  112.  
  113.  
  114. y = asind(x)                    x, sp           y, sp           y in degrees
  115.  
  116. y# = dasin(x#)                  x#, dp          y#, dp          y# in radians
  117.  
  118. y# = dasind(x#)                 x#, dp          y#, dp          y# in degrees
  119.  
  120. call casin(x, y, u, v)          x, y; sp        u, v; sp        complex
  121.  
  122. call cdasin(x#, y#, u#, v#)     x#, y#; dp      u#, v#; dp      complex
  123.  
  124.  
  125.  
  126.         Inverse Tangent
  127.  
  128.  
  129.  
  130. Usage                           Inputs          Outputs         Notes
  131.  
  132. y = ATN(x)                      x, sp           y, sp           y in radians
  133.  
  134. y = atnd(x)                     x, sp           y, sp           y in degrees
  135.  
  136. z = atan(y, x)                  x, y; sp        z, sp           z in radians
  137.  
  138.         use to determine proper quadrant of z
  139.  
  140. z = atand(y, x)                 x, y; sp        z, sp           z in degrees
  141.  
  142.         use to determine proper quadrant of z
  143.  
  144. y# = ATN(X#)                    x#, dp          y#, dp          y# in radians
  145.  
  146. y# = datnd(x#)                  x#, dp          y#, dp          y# in degrees
  147.  
  148. z# = datan#(y#, x#)             x#, y#; dp      z#, dp          z in radians
  149.  
  150.         use to determine proper quadrant of z#
  151.  
  152. z# = datand#(y#, x#)            x#, y#; dp      z#, dp          z in degrees
  153.  
  154.         use to determine proper quadrant of z#
  155.  
  156. call catan(x, y, u, v)          x, y; sp        u, v; sp        complex
  157.  
  158. call cdatan(x#, y#, u#, v#)     x#, y#; dp      u#, v#; dp      complex
  159.  
  160.  
  161.  
  162.         Hyperbolic Cosine
  163.  
  164. Usage                           Inputs          Outputs         Notes
  165.  
  166. y = cosh(x)                     x, sp           y, sp           real
  167.  
  168. y# = dcosh(x#)                  x#, dp          y#, dp          real
  169.  
  170. call ccosh(x, y, u, v)          x, y; sp        u, v; sp        complex
  171.  
  172. call cdcosh(x#, y#, u#, v#)     x#, y#; dp      u#, v#; dp      complex
  173.  
  174.  
  175.  
  176.         Hyperbolic Sine
  177.  
  178. Usage                           Inputs          Outputs         Notes
  179.  
  180. y = sinh(x)                     x, sp           y, sp           real
  181.  
  182. y# = dsinh(x#)                  x#, dp          y#, dp          real
  183.  
  184. call csinh(x, y, u, v)          x, y; sp        u, v; sp        complex
  185.  
  186. call cdsinh(x#, y#, u#, v#)     x#, y#; dp      u#, v#; dp      complex
  187.  
  188.  
  189.  
  190.         Hyperbolic Tangent
  191.  
  192. Usage                           Inputs          Outputs         Notes
  193.  
  194. y = tanh(x)                     x, sp           y, sp           real
  195.  
  196. y# = dtanh(x#)                  x#, dp          y#, dp          real
  197.  
  198. call ctanh(x, y, u, v)          x, y; sp        u, v; sp        complex
  199.  
  200. call cdtanh(x#, y#, u#, v#)     x#, y#; dp      u#, v#; dp      complex
  201.  
  202.  
  203.  
  204.         Inverse Hyperbolic Cosine
  205.  
  206. Usage                           Inputs          Outputs         Notes
  207.  
  208. y = acosh(x)                    x, sp           y, sp           real
  209.  
  210. y# = dacosh(x#)                 x#, dp          y#, dp          real
  211.  
  212. call cacosh(x, y, u, v)         x, y; sp        u, v; sp        complex
  213.  
  214. call cdacosh(x#, y#, u#, v#)    x#, y#; dp      u#, v#; dp      complex
  215.  
  216.  
  217.  
  218.         Inverse Hyperbolic Sine
  219.  
  220. Usage                           Inputs          Outputs         Notes
  221.  
  222. y = asinh(x)                    x, sp           y, sp           real
  223.  
  224.  
  225. y# = dasinh(x#)                 x#, dp          y#, dp          real
  226.  
  227. call casinh(x, y, u, v)         x, y; sp        u, v; sp        complex
  228.  
  229. call cdasinh(x#, y#, u#, v#)    x#, y#; dp      u#, v#; dp      complex
  230.  
  231.  
  232.  
  233.         Inverse Hyperbolic Tangent
  234.  
  235. Usage                           Inputs          Outputs         Notes
  236.  
  237. y = atanh(x)                    x, sp           y, sp           real
  238.  
  239. y# = datanh(x#)                 x#, dp          y#, dp          real
  240.  
  241. call catanh(x, y, u, v)         x, y; sp        u, v; sp        complex
  242.  
  243. call cdatanh(x#, y#, u#, v#)    x#, y#; dp      u#, v#; dp      complex
  244.  
  245.  
  246.  
  247.         Modulo
  248.  
  249. Usage                           Inputs          Outputs         Notes
  250.  
  251. y = x MOD k%                    x, sp; k% int   y, sp           uses integer
  252.  
  253.                                                                   base only
  254.  
  255. y = amod(x, k)                  x, k; sp        y, sp           uses any base
  256.  
  257. y# = x# MOD k%                  x, dp; k% int   y, dp           uses integer
  258.  
  259.                                                                   base only
  260.  
  261. y# = dmod(x#, k#)               x#, k#; dp      y#, dp          uses any base
  262.  
  263. call cmod(x, y, xk, yk, u, v)   x, y, xk,       u, v; sp        complex base
  264.  
  265.                                   yk; sp
  266.  
  267. call cdmod(x#, y#, xk#, yk#,    x#, y#, xk#,    u#, v#; dp      complex base
  268.  
  269.   u#, v#)                         yk#; dp
  270.  
  271. call nearint(x, y, u%, v%)      x, y; sp        u%, v%; int     nearest integer
  272.  
  273.                                                                   (u%, v%)
  274.  
  275. call dnearint(x#, y#, u&, v&)   x#, y#; dp      u&, v&; long    nearest integer
  276.  
  277.                                                                   (u&, v&)
  278.  
  279.  
  280.  
  281.         Exponentiation & Logarithms
  282.  
  283. Usage                           Inputs          Outputs         Notes
  284.  
  285. y = EXP(x)                      x, sp           y, sp           real
  286.  
  287. y# = EXP(x#)                    x#, dp          y#, dp          real
  288.  
  289. call cexp(x, y, u, v)           x, y; sp        u, v; sp        complex
  290.  
  291. call cdexp(x#, y#, u#, v#)      x#, y#; dp      u#, v#; dp      complex
  292.  
  293. y = LOG(x)                      x, sp           y, sp           real
  294.  
  295. y# = LOG(x#)                    x#, dp          y#, dp          real
  296.  
  297. call clog(x, y, u, v)           x, y; sp        u, v; sp        complex
  298.  
  299. call cdlog(x#, y#, u#, v#)      x#, y#; dp      u#, v#; dp      complex
  300.  
  301.  
  302.  
  303.         Multiply & Divide (complex only)
  304.  
  305. Usage                           Inputs          Outputs         Notes
  306.  
  307. call cmult(x1, y1, x2, y2,      x1, y1, x2,     u, v; dp        (x1, y1) *
  308.  
  309.   u, v)                           y2; sp                          (x2, y2)
  310.  
  311. call cdmult(x1#, y1#, x2#,      x1#, y1#, x2#,  u#, v#; dp      (x1#, y1#) *
  312.  
  313.   y2#, u#, v#)                    y2#; sp                         (x2#, y2#)
  314.  
  315. call cdiv(x1, y1, x2, y2,       x1, y1, x2,     u, v; dp        (x1, y1) /
  316.  
  317.   u, v)                           y2; sp                          (x2, y2)
  318.  
  319. call cddiv(x1#, y1#, x2#,       x1#, y1#, x2#,  u#, v#; dp      (x1#, y1#) /
  320.  
  321.   y2#, u#, v#)                    y2#; sp                         (x2#, y2#)
  322.  
  323.  
  324.  
  325.         Powers (complex only)
  326.  
  327. Usage                           Inputs          Outputs         Notes
  328.  
  329. call rpower(x, y, p, u, v)      x, y, p; sp     u, v; sp        (x, y) to real
  330.  
  331.                                                                   power p
  332.  
  333. call cpower(x, y, px, py,       x, y, px,       u, v; sp        complex power
  334.  
  335.  
  336.   u, v)                           py; sp                          (px, py)
  337.  
  338. call drpower(x#, y#, p#,        x#, y#, p#; dp  u#, v#; dp      real power p#
  339.  
  340.   u#, v#)
  341.  
  342. call cdpower(x#, y#, px#,       x#, y#, px#,    u#, v#; dp      complex power
  343.  
  344.   py#, u#, v#)                    py#; dp                         (px#, py#)
  345.  
  346.  
  347.  
  348.         Coordinate Conversion (complex only)
  349.  
  350. Usage                           Inputs          Outputs         Notes
  351.  
  352. cabs(x, y, r)                   x, y; sp        r; sp           magnitude
  353.  
  354. cdabs(x#, y#, r#)               x#, y#; dp      r#; dp          magnitude
  355.  
  356. cpolar(x, y, r, t)              x, y; sp        r, t; sp        rect to polar,
  357.  
  358.                                                                   t in radians
  359.  
  360. cpolard(x, y, r, t)             x, y; sp        r, t; sp        rect to polar,
  361.  
  362.                                                                   t in degrees
  363.  
  364. cdpolar(x#, y#, r#, t#)         x#, y#; dp      r#, t#; dp      rect to polar,
  365.  
  366.                                                                   t in radians
  367.  
  368. cdpolard(x#, y#, r#, t#)        x#, y#; dp      r#, t#; dp      rect to polar,
  369.  
  370.                                                                   t in degrees
  371.  
  372. ccart(r, t, x, y)               r, t; sp        x, y; sp        polar to rect,
  373.  
  374.                                                                   t in radians
  375.  
  376. ccartd(r, t, x, y)              r, t; sp        x, y; sp        polar to rect,
  377.  
  378.                                                                   t in degrees
  379.  
  380. cdcart(r#, t#,x#, y#)           r#, t#; dp      x#, y#; dp      polar to rect,
  381.  
  382.                                                                   t in radians
  383.  
  384. cdcartd(r#, t#, x#, y#)         r#, t#; dp      x#, y#; dp      polar to rect,
  385.  
  386.                                                                   t in degrees
  387.  
  388.  
  389.  
  390. Notes:
  391.  
  392. - Functions listed in UPPER CASE are intrinsic to Quick BASIC, and are 
  393.  
  394.         included here for completeness.
  395.  
  396. - The abbreviation sp means single-precision, dp means double-precision.
  397.  
  398. - Complex numbers are expressed as (x, y) in rectangular coordinates, where
  399.  
  400.         x = real part and y = imaginary part.  In polar form, r is the
  401.  
  402.         magnitude or radius, t = the angle (degrees or radians).
  403.  
  404.