home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 131.lha / FORMULA!.doc < prev    next >
Text File  |  1986-11-21  |  8KB  |  200 lines
  1.     
  2.                        HERMES' FORMULA!  (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 complements my CALCULA program and can be of
  13. considerable value to various professionals who use mathematical functions
  14. in their work.
  15.      It is a 3-dimensional function grapher.
  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 or you will get a GURU!
  20.  
  21.      To use it from the CLI: Press "RUN FORMULA!".
  22.      To use it from the WORKBENCH: CLICK its ICON.
  23.      To EXIT, choose "QUIT" from the MENU, or click into the EXIT gadget.
  24.  
  25.      Formula! will actually graph 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 Formula!, do the following:
  29.  
  30.      (1)  Insert the function to be graphed in the FUNCTION gadget. 
  31.      
  32.      (2)  Insert the values (if needed) for the six parameters in their
  33.           respective gadgets.  The front panel always appears with the
  34.           default values for the parameters.
  35.  
  36.      (3)  Click the GRAPH gadget.
  37.  
  38.      The function will be scaled first, and then it will be graphed on its
  39. own screen in the colors chosen by the user (COLOR gadget).
  40.  
  41.  
  42.      FUNCTION AND PARAMETER GADGETS INFORMATION
  43.      ==========================================
  44.  
  45.      (I)    Use only parentheses. No brackets are allowed.
  46.  
  47.      (II)   The function must be at most 100 characters long.
  48.  
  49.      (III)  This version does not support scientific notation.  Also, all
  50.             trigonometris functions are evaluated at angles expressed in
  51.             radians.  Use the rad function to convert degrees to radians.
  52.             This means degrees with decimals like: rad(87.6).
  53.  
  54.      (IV)   Avoid the use of numbers with more than 13 digits before
  55.             the decimal point and/or 9 digits after the decimal point.
  56.  
  57.      (V)    Exponential expressions grow or decay very fast.  The largest
  58.             power I have allowed for e is 32. (exp(32.)).
  59.  
  60.      (VI)   Check the available functions, operators, and constants by
  61.             choosing FUNCTIONS from the menu.  Make sure that you are
  62.             using the right notation for your functions.
  63.  
  64.      (VII)  To CLEAR ONE of the string gadgets, click into it and press
  65.             RIGHT-AMIGA-X.  
  66.  
  67.      (VIII) You may use spaces between any expressions.  No problem.
  68.  
  69.      (IX)   Lower or upper case letters are allowed anywhere in the  
  70.             function gadget. The program turns them all into upper case.
  71.  
  72.      (X)    For the sake of speed I have omitted error messages for a whole
  73.             lot of nonsensical things that can happen.  
  74.             Make sure your input makes sense mathematically.
  75.  
  76.      (XI)   The program will prohibit the generation of numbers that are 
  77.             prone to carry prohibitive sizes of error.
  78.  
  79.      (XII)  CTRL-N gets you to the Workbench and CTRL-M gets you back to
  80.             FORMULA!.  If you are planning to work on the Workbench while
  81.             FORMULA! is running, make sure to run it with "RUN FORMULA!"
  82.             and not just "FORMULA!".
  83.  
  84.      (XIII) The built in parameters pi, tpi and pit denote the numbers
  85.             PI, 2*PI and PI/2, respectively.
  86.  
  87.      (XIV)  The function "as" (asin) has values in the interval [-pit,pit];
  88.             The function "ac" (acos) has values in the interval [0,pi];
  89.             The function "atan" has values in the interval [-pit,pit];
  90.             The domain of "as" and "ac" is the interval [-1,1];
  91.  
  92.      (XV)   When you raise a function to a power, make sure you enclose
  93.             the function in parentheses.  For example, you should use
  94.             (exp(1.89))**2 instead of exp(1.89)**2.  The same remark applies
  95.             to other similar situations.
  96.  
  97.      (XVI)  The AZIMUTH lies always between 0 and 90 degrees while the
  98.             COLATITUDE ranges always between 0 and 180 degrees.
  99.             I will allow bigger AZIMUTH ranges in future versions.
  100.  
  101.      (XVII) DO NOT USE pi, tpi, pit in ANY GADGETS OTHER THAN THE FUNCTION
  102.             gadget.
  103.  
  104.     (XVIII) The RESET gadget on the front panel will bring back the default
  105.             values of the parameters, if needed.
  106.  
  107.  
  108.      GRAPH SCREEN AND PALETTE INFORMATION
  109.      ====================================
  110.  
  111.      (1)    Pressing "P" or "p" after the function is graphed, you get a nice
  112.             palette on the screen.  It will allow you to change the two
  113.             surface colors and the two grid colors very easily.
  114.             You can SAVE the picture with GRABBiT.
  115.  
  116.      (2)    The palette will exit if you click into its EXIT gadget.
  117.  
  118.      (3)    The screen with the graph will go into the background if you
  119.             press the TAB key or the RETURN key.  Natually, you can do
  120.             that after the palette is out.
  121.  
  122.      (4)    You can bring the graph screen back if you click into the VIEW
  123.             gadget on the main panel.
  124.  
  125.      (5)    When you bring the screen back via the VIEW panel, you must
  126.             click into it to activate it!  Otherwise it will NOT LISTEN
  127.             TO KEYBOARD COMMANDS LIKE "P", "p", TAB, RETURN.
  128.  
  129.      (6)    THE VIEW gadget will show you the screen with the graph,
  130.             provided there is a graph to show.
  131.  
  132.      (7)    The COLOR gadget could be used to modify the color of the current
  133.             or the next function.  If you want to modify the color
  134.             of the function already graphed, just flash it with the
  135.             VIEW gadget and then press "p" or "P" to get the palette on
  136.             it.  You can achieve the same result by (1) clicking COLOR on
  137.             the front panel, (2) modifying the palette, (3) getting the graph
  138.             screen back and (4) throwing the palette on it.
  139.             The next graph screen will automatically assume the current
  140.             palette collors.
  141.  
  142.      (8)    Again, you can SAVE the screen with GRABBiT.  I do not think
  143.             that CLIPiT will work here.
  144.  
  145.      HERE ARE SOME INTERESTING FUNCTIONS TO TRY (Default gadget values
  146.      ere used unless otherwise specified):
  147.  
  148.      (a)    sin(x**2 + y) - x + y;
  149.  
  150.      (b)    3*cos(x**2-y**2);
  151.  
  152.      (c)    3.45*sin(x-y**2), X-MINIMUM = -20;
  153.  
  154.      (d)    3.45*cos(2 - (x**2 + y**2)), X-MINIMUM = -5, Y-MINIMUM = - 5;
  155.  
  156.      (e)    3*cos(x**2) - ln(abs(x + y));
  157.  
  158.      (f)    sin((x - y)*(3*x - 2*y)*(.5*x - y)), AZIMUTH = 0, COLATITUDE = 34;
  159.  
  160.  
  161.                              ***  <<<-->>>  ***
  162.  
  163.  
  164.      This is a SHAREWARE copyrighted program.  If you find it useful, 
  165. please send $15.00 to:
  166.                
  167.                 A. G. Kartsatos   (= HERMES = SOULI)
  168.                 8524 Caladesi Island Drive
  169.                 Tampa, FL 33637
  170.                 (Telephone: 813-988-2146)
  171.  
  172.      With this contribution you will receive more programs written by the
  173. author.
  174.      FOR SUPPORT, call HERMES BBS in Tampa, FL.  A bulletin board with 1400
  175. files online and a healthy message base.  The board is private, but you
  176. can leave a message to the SYSOP concerning the HERMES programs and/or you
  177. can download ALL HERMES PROGRAMS without registering.
  178.  
  179.                 HERMES BBS Telephone: 813-985-7624.
  180.  
  181.      Other programs by the author:
  182.  
  183.      PALETTA.ARC    (Color Mixing, Modifying IFF's, Random Colors)
  184.      DUHERM26.ARC   (Great Directory Utility.  Macros, Parameters, etc)
  185.      CALCULA.ARC    (An Expression Parser And A Function Evaluator.  Unique!)
  186.      SIMPLICA.ARC   (The Simplex Method Of Linear Programming)
  187.      ROST.ARC       (Reports On Storage And Tasks.  Useful!)
  188.      LISTA.ARC      (Very Useful Directory Lister.  Version 1.1 Soon!)
  189.      SCRIPTA.ARC    (Online!-PCP Script Maker.  Easy script files!)
  190.  
  191.      Feel free to distribute this program, with the doc intact, to any
  192. bulletin boards and other non-profit establishments in the US and abroad.
  193.      These include PLink, Compuserve, GEnie, Delphi, etc.
  194.      The inclusion of this program, or any part of it, in any form in a 
  195. commercial package, or its use for commercial purposes, requires the 
  196. written permission of the author.
  197.      
  198.      Later...
  199.                   @@-->>> HERMES
  200.