home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 118.lha / mathpaint.doc < prev    next >
Text File  |  1986-11-21  |  9KB  |  287 lines
  1.         MATHPAINT V1.0 Benoit Jobin april/88  (C)Copyright 1988
  2.  
  3. ****************************************************************************
  4.  
  5.     This program is not public domain. Permision is
  6. granted to freely distribute this program through the BBS systems. Charges
  7. for such distribution are NOT permitted.
  8.  
  9. ****************************************************************************
  10.  
  11.                  MathPaint 1.0
  12.             USER's DOCUMENTATION.
  13.             ---------------------
  14.  
  15.         Introduction:
  16.         -------------
  17.  
  18.         This program enables you to plot mathematical curves in
  19.         two dimensions. It can also evaluate equations and return
  20.         their numerical values. This software can be very useful
  21.         in an analysis of experimental datas and mathematical
  22.         modelisation of physical phenomenons. (Engineering !)
  23.  
  24.         We hope that you will copy and distribute this software to
  25.         as many people as you can. If you do, you must give both the
  26.         software MATHPAINT and the documentation.
  27.  
  28.         If you like this software please send your 10$ or more
  29.         contribution to B.J.Software Canada .I will wait for your
  30.         replies and if you do reply, I will keep working on more
  31.         powerfull versions and new projects ! (Sounds like a lot
  32.         of fun and work!)
  33.  
  34.         You will notice that i am not a writer, so forgive my
  35.         english. I tried my best.
  36.  
  37.         Features:
  38.         ---------
  39.  
  40.         -Plotting in eight colors of functions and/or datas.
  41.  
  42.         -You can overlay your graphics.
  43.  
  44.         -You can choose your eight colors from a palette
  45.          of 4096 AMIGA colors.
  46.  
  47.         -Axes and scaling can be plotted in X or Y or both directions.
  48.  
  49.         -GRID in both directions at will.
  50.  
  51.         -Different modes for plotting equations and datas.
  52.  
  53.         1-> normal plot y=f(x..).
  54.         2-> reversed plot x=f(y..).
  55.         3-> Parametric plot.
  56.             x= f(t..).
  57.             y= f(t..).
  58.              With 't' go from an initial value to a final value
  59.              by constant increments.
  60.  
  61.         -Choice of font style for the scaling.
  62.  
  63.         How to start:
  64.         ---------------
  65.  
  66.         MATHPAINT is a relatively straightforward program
  67.         and once you have plotted one or two graphs, you will
  68.         find how easy it is.
  69.         This program has been realised to start from the CLI but
  70.         you can attach an icon to MATHPAINT and use it from
  71.         WORKBENCH. But if you do work with an icone you won't be
  72.         able to choose a new font style and you CAN NOT use the
  73.         TOOL-TYPE option for the software.
  74.  
  75.         Startup for the CLI.
  76.  
  77.         MATHPAINT [fontname.font fontsize]
  78.  
  79.         ex: MATHPAINT
  80.         or
  81.         ex: MATHPAINT topaz.font 11
  82.  
  83.         --------------------------------------------
  84.  
  85.  
  86.         Selections in the MENU:
  87.         -----------------------
  88.  
  89.         "Plot Graph":     Plot the graphic to the screen.
  90.         ------------------------------------------------------------
  91.  
  92.         "Edit Graph":   A requester will appear to let you change
  93.             all the options and equations.
  94.  
  95.             ALL GADGETS 3D, AUTOZ, ZLOG, AXEZ, GRIDZ
  96.             WILL NOT BE WORKING IN THIS VERSION.
  97.  
  98.             - Tree long string-gadgets let you write your
  99.               mathematical equations.
  100.  
  101.             - The initialisation gadget enables you to write
  102.               an equation, it will be evaluated, and the computer
  103.               will return the result on the same line.
  104.  
  105.             ex: x=sin(12.3)
  106.             wille give
  107.             x=-0.263232
  108.             this value of 'x' is memorized and can be used in
  109.             the futur.
  110.             ex:        i = 12
  111.             give       i=12.000
  112.             if we write    i = i+1
  113.             it returns       i=13.000
  114.             It is possible to write more complex functions like:
  115.                    i = sin(i)+i^2
  116.             it returns       i=169.420
  117.  
  118.             note: At the beginning all the variables are equal to ZERO.
  119.               You can check each variable by writing var=var.
  120.               ex:           i=i
  121.               will return  i=0.0000  (at the beginning)
  122.  
  123.         AUTOY - auto scaling in Y.(vertical)
  124.         AUTOX - auto scaling in X (horizontal)
  125.  
  126.             note: We generaly use AUTOX and AUTOY for parametric
  127.              equations to let the computer find the right
  128.              scale in both directions.
  129.  
  130.              When we use AUTOX alone it is possible to plot
  131.              reversed equations of the form.
  132.              x=f(y). for y goes from MINIMUM to MAXIMUM.
  133.              THIS GRAPHIC WILL SHOW VERTICALLY
  134.  
  135.         AXEX et AXEY - You can select which axis you want to plot.
  136.  
  137.             You then will be required to give the position of
  138.             the axis and the steps in the scale.
  139.  
  140.             Position: For the X axis the position is the
  141.              intersection with the Y axis. For the Y axis
  142.              it is the intersection with the X axis.
  143.  
  144.             ex: if the X axis position is  = 0
  145.                 and the Y axis position is = 0.
  146.                 then the axis will be centered at x=0,y=0.
  147.                 (the ORIGIN)
  148.  
  149.             ex: if the X axis position is = 10
  150.                 and the Y axis position is = 0.
  151.                 then the intersection between them
  152.                 will be at x=0,y=10.
  153.  
  154.             "Step Size": Distance between the steps in the scale.
  155.  
  156.             SPECIAL CASE FOR "Step Size".
  157.             WHEN THE AXIS IS LOGARITHMIC:(XLOG or YLOG or both)
  158.             "Step Size" will then mean the number of divisions by
  159.             power of ten.
  160.             Generally 10 divisions by power of ten is a good
  161.             choice and a standard one.
  162.  
  163.             But the computer can let you have ten divisions
  164.             over a power of 100 or 1000 or 10000 if you write
  165.             a fractionnary value.
  166.  
  167.             Knowing that 100 is 10^2 then 1/2 => 0.5 will give
  168.             the Log scale with ten divisions at powers of 10^2.
  169.  
  170.             these are examples for the LOGARITHMIC SCALES:
  171.  
  172.             ex: 20    -> 20 divisions by power of ten.
  173.             ex: 10    -> 10 divisions by power of ten.
  174.             ex: 1  -> 1 division at each power of ten.
  175.             ex: 0.5  -> 10 divisions by power of hundred.(1/2)10^2
  176.             ex: 0.3333 -> 10 divisions par power of 1000.(1/3) 10^3.
  177.  
  178.         GRIDX and GRIDY put a grid in overlay.
  179.  
  180.         XLOG and YLOG let you choose the kind of scaling style
  181.             you want. (Engineers need it).
  182.  
  183.            Note. LOGARITHMIC graphics do not allow for
  184.              0 or negative values.
  185.  
  186.         CHOICE of colors. It is possible to choose from the tree
  187.             gadgets the color of the pen (crayon), paper (papier)
  188.             and axis (echelle).
  189.  
  190.         "Return to Menu" Lets you return to the MENU.
  191.  
  192.         ------------------------------------------------------------
  193.  
  194.         "Color Palette":   A requester will appear to lets you change
  195.             any of the eight colors.
  196.  
  197.             It is possible to change the preferences, save
  198.             your favorite colors, and load them again.
  199.         ------------------------------------------------------------
  200.  
  201.         "Load Matrix":
  202.  
  203.             You can do graphics with numerical values in the
  204.             form of matrix.
  205.  
  206.             These matrix must be in an ascii file like the one
  207.             done by your favorite TEXT EDITOR.
  208.  
  209.             You declare matrix like this:
  210.  
  211.             hello = [ 1.23; 33.41; 5.21;
  212.             3.12; 5.2; 0; 4.0e-2; ];
  213.  
  214.             This Matrix has 7 values that you will be able to obtain
  215.             with MATHPAINT the same way as with a sin() or cos() or
  216.             any other function of this kind.
  217.  
  218.             ex:        x=hello(0)
  219.             ex: give   x=1.23
  220.  
  221.             When the loading is successfull you will see in the
  222.             Edit Graph requester in the initialisation gadget all the
  223.             names of the matrix followed by the number of elements.
  224.  
  225.             Up to 10 matrix can be used at the same time with more
  226.             than 1000 elements in each of them.
  227.             (FOR THIS VERSION OF MATHPAINT)
  228.         ------------------------------------------------------------
  229.         "LOAD FORMULAS!: this option permits you to save your work.
  230.         ------------------------------------------------------------
  231.         "SAVE FORMULAS!: this option permits you to load your work.
  232.         ------------------------------------------------------------
  233.  
  234.         "Overplot". All future attempts to  Plot will overlay
  235.             to the visible drawing. (you can make a real mess here!)
  236.         ------------------------------------------------------------
  237.         QUIT-BYE.  To end the execution of the program.
  238.         ------------------------------------------------------------
  239.  
  240.     Supplementary informations    :
  241.     -----------------------------
  242.  
  243.     The order of evaluation of the equations is conform
  244.     to the precedence of operators.
  245.  
  246.     ex: 2+3*4       give 14 and not 20...
  247.     ex: sin(x)^2*3     is the same as  3*(sin(x)^2)
  248.  
  249.  
  250.     All divisions by ZERO will return ±9.0 * 10^18
  251.     that is almost the biggest value the fast floating point
  252.     can handle. (the INFINITY)
  253.  
  254.     1/0 => 9.0e18
  255.     -1/0 => -9.0e18
  256.  
  257.     Legal names for variables are small letters from
  258.     'a' to 'z'.
  259.  
  260.     this program won't show the AXIS when
  261.     Step Size or POSITION  values are too big or too small.
  262.  
  263.  
  264.     The most important thing with this program is to PRINT
  265.     the results. I suggest you get a "FRAME-GRABBER" program.
  266.     These programs let you GRAB a screen to PRINT or SAVE it.
  267.     GRABBIT by Discovery software is a good suggestion.
  268.  
  269.     I would like to thanks Keith Young and Charlie Heath for
  270.     writing great examples of file requester and palette requester.
  271.  
  272.     Work well and have fun!
  273.  
  274.     But don't forget to send your 10$ or more contribution
  275.     to alllow me to continue inproving this software and develop
  276.     new projects for you !
  277.  
  278.     MATHPAINT
  279.     B.J.Software (Shareware)
  280.  
  281.     2660 Chatham ave.
  282.     Longueuil  Quebec
  283.     Canada        J4L-2E6
  284.     ----------------------------
  285.  
  286.  
  287.