home *** CD-ROM | disk | FTP | other *** search
/ Amiga Elysian Archive / AmigaElysianArchive.iso / bus_pers / calcula.arc / CALCULA.doc < prev    next >
Text File  |  1988-12-13  |  8KB  |  198 lines
  1.     
  2.                     HERMES' CALCULA   (Version 1.0)
  3.  
  4.                   Copyright (c) 1988 A. G. Kartsatos 
  5.  
  6.            (CIS = 76617,121, GEnie = XTH58515, PLink = HERMES)
  7.  
  8.  
  9.                      ***  Shareware Program  ***
  10.  
  11.  
  12.      Here is a program that can be quite valuable to a lot of people who
  13. have to use mathematical functions in their work.  Students, scientists
  14. and engineers will find it particularly helpful.
  15.      It is what we call an "Expression Parser".
  16.   
  17.      ATTENTION:  The "TOPAZ 11" font should be in your current "fonts" 
  18. directory. If it is not there, you will get the program running with funny
  19. fonts!
  20.  
  21.      To use it from the CLI: Press "RUN CALCULA".
  22.      To use it from the Workbench: Click its icon.
  23.      To exit, choose "QUIT" from the menu.
  24.  
  25.      Calcula actually evaluates any valid expression involving the
  26. 17 supported algebraic and trigonometric functions, 3 constants involving
  27. PI and 5 algebraic operations.  
  28.      In order to use Calcula, do the following:
  29.  
  30.      (1)  Insert the function to be evaluated in the "FUNCTION" gadget. 
  31.      
  32.      (2)  Insert the values (if needed) for any of the variables X, Y, Z in 
  33.           their respective gadgets.
  34.  
  35.      (3)  Click the "EVALUATE" gadget.
  36.  
  37.      The value of the function is given in the "RESULT" gadget.
  38.  
  39.      REMEMBER:
  40.  
  41.      (I)    Use only parentheses. No brackets are allowed.
  42.  
  43.      (II)   The function must be at most 100 characters long.
  44.  
  45.      (III)  This version does not support scientific notation.  Also, all
  46.             trigonometris functions are evaluated on angles expressed in
  47.             radians.  Use the rad function to convert degrees to radians.
  48.             This means degrees with decimals like: rad(87.6).
  49.  
  50.      (IV)   Avoid the use of numbers with more than 13 digits before
  51.             the decimal point and/or 9 digits after the decimal point.
  52.  
  53.      (V)    Exponential expressions grow or decay very fast.  The largest
  54.             power I have allowed for e is 32. (exp(32.)).
  55.  
  56.      (VI)   Check the available functions, operators, and constants by
  57.             choosing "FUNCTIONS" from the menu.  Make sure that you are
  58.             using the right notation for your functions.
  59.  
  60.      (VII)  To "CLEAR" ONE of the string gadgets, click into it and press
  61.             RIGHT-AMIGA-X.  Press "CLEAR ALL" to clear ALL the string
  62.             gadgets.
  63.  
  64.      (VIII) You may use spaces between any expressions.  No problem.
  65.  
  66.      (IX)   Lower or upper case letters are allowed anywhere.  The program
  67.             turns them all into upper case.
  68.  
  69.      (X)    For the sake of speed I have omitted error messages for a whole
  70.             lot of nonsensical things that can happen.  For example, if
  71.             you insert HERMES in the X-gadget, the program will read it
  72.             as 0.000000.  Make sure your input makes sense mathematically.
  73.  
  74.      (XI)   The result is always given with 6 decimal places.  The program
  75.             will prohibit the generation of numbers that are too large to
  76.             print and/or prone to carry prohibitive sizes of error.
  77.  
  78.      (XII)  CTRL-N gets you to the Workbench and CTRL-M gets you back to
  79.             CALCULA.  If you are planning to work on the Workbench while
  80.             CALCULA is running, make sure to run it with "RUN CALCULA"
  81.             and not just "CALCULA".
  82.  
  83.      (XIII) The built in parameters pi, tpi and pit denote the numbers
  84.             PI, 2*PI and PI/2, respectively.
  85.  
  86.      (XIV)  The function "as" (asin) has values in the interval [-pit,pit];
  87.             The function "ac" (acos) has values in the interval [0,pi];
  88.             The function "atan" has values in the interval [-pit,pit];
  89.             The domain of "as" and "ac" is the interval [-1,1];
  90.  
  91.      (XV)   When you raise a function to a power, make sure you enclose
  92.             the function in parentheses.  For example, you should use
  93.             (exp(1.89))**2 instead of exp(1.89)**2.  The same remark applies
  94.             to other similar situations.
  95.  
  96.      HERE IS AN EXAMPLE:
  97.  
  98.      FUNCTION: sin(x**2.-6.78*y)+cos(pi-atan(4.56))+abs(ln(1.23+exp(.2*z)))
  99.  
  100.                 X                  Y                Z  
  101.             
  102.               .023               -3.45            22.957
  103.     
  104.  
  105.                        RESULT: 3.404071 
  106.  
  107.      ANOTHER EXAMPLE:
  108.  
  109.      FUNCTION: ac(cos(ln(exp(tan(atan(log(10**(sq(1.23**2)))))))))
  110.  
  111.                        RESULT: 1.23
  112.  
  113.      THIRD EXAMPLE:
  114.  
  115.      FUNCTION: x**2 + y**2 + sin(ac(1.23)) + tan(9.04)
  116.  
  117.                 X                  Y                Z
  118.  
  119.                 3.              -2.008
  120.  
  121.      Error!  Domain Problem With The Acos Function
  122.  
  123.      (The argument of the acos function should be between -1 and 1).
  124.  
  125.      FOURTH EXAMPLE:
  126.  
  127.      FUNCTION: as(log(1.45+x**y)) - ln(sin(x+z))
  128.  
  129.                 X                  Y                Z
  130.  
  131.                -.56                2              3.876
  132.  
  133.      Error!  Domain Problem With The Ln Function
  134.     
  135.      (The function sin(x+z) passes a negative value to the argument of ln).
  136.  
  137.                              ***  <<<-->>>  ***
  138.  
  139.      This is a SHAREWARE copyrighted program.  If you find it useful, 
  140. please send $15.00 to the address at the end.
  141.      With this contribution you will receive more programs written by the
  142. author.
  143.      NOTE:  The author will configure your copy of CALCULA so that it can
  144. compute any particular function that you would like by building it in.
  145.  
  146.      Feel free to distribute this program, with the doc intact, to any
  147. bulletin boards and other non-profit establishments in the US and abroad.
  148.      These include PLink, Compuserve, GEnie, Delphi, etc.
  149.      The inclusion of this program, or any part of it, in any form in a 
  150. commercial package, or its use for commercial purposes, requires the 
  151. written permission of the author.
  152.      
  153.      Other Programs By HERMES:
  154.  
  155.      PALETTA.ARC    (Color Mixing, Modifying IFF's, Random Colors)
  156.      SIMPLIC1.ARC   (The Simplex Method Of Linear Programming.  This Is The
  157.                      Demo Version Of The Commercial Product SIMPLICA.  The
  158.                      Complete Program Handles Simplexes Of Up To 30 Un-
  159.                      knowns And Up To 30 Constraints.  It Will Also Load
  160.                      And Save Simplexes.  The Best Simplex Program For
  161.                      Your Amiga)
  162.      ROST.ARC       (Reports On Storage And Tasks On Their Windows. Useful!)
  163.      LISTA11.ARC    (Very Useful Directory Lister.  Alpha, Bytes, Patterns,
  164.                      CLI, Refresh.  Opens Its Own Window)
  165.      SCRIPTA.ARC    (Online!-PCP Script Maker.  Easy Online! Script Files!)
  166.      FORMULA!.ARC   (FORMIDABLE 3D-Grapher In C. It graphs z = f(x,y).  
  167.                      Choice Of Colors.  17 Functions Supported.  An Artist's
  168.                      Tool)
  169.      FINANCA.ARC    (Mortgage, Compound Interest And Annuity In Color!)
  170.      CONTOURA.ARC   (SPECTACULAR Contour Grapher.  Definitely An Artist's
  171.                      Tool.  CENTER, ZOOM IN, ZOOM OUT, FLOWING PALETTE,
  172.                     SCALING.  An Important Artist's Tool!)
  173.      ARCHA11.ARC    (ARC-PAK-ZOO Utility.  It Also Has Another 12 Utility
  174.                     Gadgets And 7 Drive Gadgets.  Only 29K, It Can Be Used
  175.                     As An Efficient Directory Utility)
  176.      DUHERM27.ARC   (Beautiful Directory Utility.  A Multitude Of Functions.
  177.                     72 Gadgets Out Of Which 48 Are User-configurable! 
  178.                     One Of The Major Powerful DirUtils For The Amiga)
  179.      VIEWOVER.ARC   (This Is The Program View (V. 1.8) With Overscan 
  180.                     Capability By HERMES.  Very Small (About 6K) And Very
  181.                     Convenient)
  182.      HERMIT.ARC     (This Program Allows You To Save/Cycle Your Front Screen.
  183.                     It resides In The Background And "Listens" To Your Key-
  184.                     board For HOT KEYS.  Nice And Only About 15K Long)
  185.      ICONLAB2.ARC   (The Definitive Work On Icons For The Amiga Computer.
  186.                     It Supports: CUT ICONS, ICON->BRUSH, BRUSH->ICON, 
  187.                     CUT->BRUSHES, 8-COLOR ICONS, SPLIT ICONS, JOIN ICONS,
  188.                     MODIFYING OF ICON DATA, etc.  This Is The Commercial
  189.                     Demo Of The Commercial Program ICONLAB Available From
  190.                     HERMES)
  191.  
  192.  
  193.      FOR SUPPORT, call HERMES BBS in Tampa, FL, USA.  It is a  
  194. private bulletin board with 1600 files online and a healthy message base.
  195.  
  196.      HERMES BBS Telephone No.: 813-985-7624  (2400, PC Pursuitable).
  197.  
  198.