
      .----.        -.           -.      .  -.
     |       .---.   |  .---.     |     -.   |---.
     |       .---|   |  |         |      |   |   |
      '----' '---'-  '- '---'     '----' '-  '---'
             VERSION 0.9    - HPSolo '98 -

-[ INTRODUCTION ]-

        CALC LIB is a library I made to help those taking the first two
sequences in calculus.  Some of the topics covered in calculus are volume
by rotating an area bounded by two functions around an axis, finding
limits (numerical), areas, approximations such as Newton's method, the
midpoint rule, Simpson's method, and the trapezoidal rule.  So I decided
to write this program that provides a graphical interface for those who
like input forms, and have included commands to use for programming and
use with algebraics to do just the above.
        It's not complete yet, but I wanted to release this stable version
for testing and comments.  All the commands are safe to use, and I have
not gotten an error, yet.  If you do get errors, they will be from
USER-RPL command errors (some USER-RPL is used to do number crunching
due to the MANY different argument-type combinations).

-[ COMMANDS ]-

        Below is a list of commands within the library.  C denotes
a programmable command (i.e. can be used in a program), A means you
can use it in a function-like form (e.g. 'LIM(SIN(X)/X,0)').

        USE     NAME    QUICK DESCRIPTION
        ---     ------  --------------------------------------------------
         C      VOLUME  - GUI for finding volume using shell or disc method
         C      AREAS   - GUI for finding area between two curves
                          uses normal (by integration), simpson's rule,
                          trapezoidal rule, or midpoint rule
                          (users pick method)
         C      LIMITS  - GUI for finding limits (function in terms of 'X')
*        C      NEWTON  - GUI for finding roots with Newton's method
         C      VDISC   - volume by disc method
         C      VSHELL  - volume by shell method
        C,A     LIM     - finds limit of f(x) as x approaches a
        C,A     AREA    - finds area between two functions (from a to b)
*       C,A     NEWT    - finds root (up to 50 terms), given initial guess
*       C,A     SIMP    - area by Simpson's method
*       C,A     TRAPZ   - area by trapezoidal rule
*       C,A     MIDPT   - are by midpoint

Those marked by an asterisk are still being debugged and hence are not
included.  AREAS will only use the "Normal" method at the moment since
other methods require sub-routines from SIMP, TRAPZ, and MIDPT

-[ GRAPH OF TWO FUNCTIONS ]-

        I've drawn below the graph of two functions to use in examples.
Briefly, g(x) is the curve defined by the dotted points, while f(x) is
the curve defined by the "/" marks.  They intersect at a = -.82847 and
b = 4.8284 (approximately) and let y = c be the line y = -1 (i.e. c = -1)

                       y-axis
                          |
                          |  /  f(x) = 2x+4
     g(x) = (x-1)^2-1     |/.                           ----> m  
                  :      /  :                           
                  '.   /   .'                           
           ________'./    .'___________ x-axis          ----> z
                   / '...'|                             ----> n
                          |
                   - - - -|- - - - -
                                   y = c
                     |<-  ->|
                     a      b

-[ VOLUME ]-

        Hopefully, the GUI will explain everything you need to know about
the input parameters.  VAR is the variable of integration (it's the
variable you use in your functions EQ1 and EQ2).  AXIS is the numerical
value of the axis of rotation after you put it into X = c or Y = c form.
From the graph above, AXIS would have a value of -1.

I.  VOLUME BY DISC METHOD
    Suppose we wanted to use the above example and rotate the area
    bounded by f(x) and g(x) from a to b about the axis c, then we
    woule enter in the parameters as seen below.

             VOLUME BY ROTATION 
            EQ1: '(x-1)^2-1                             <-- highlighted
            EQ2: '2*x+4'
            MIN: -0.82847   MAX:  4.8284  METHOD
            VAR: x          AXIS: -1       Disc
            ENTER 1ST BOUND EQUATION
            [EDIT][    ][    ][    ][(AN(][ OK ]

    NOTE: since this is ASCII art, you won't see the exact things,
    but for the most part it's the same... just enter in things
    exactly as you see here.

    If you are only using one equation, then set EQ2: to zero.

II. VOLUME BY SHELL METHOD
    Now if we wanted to rotate that area around the axis x = -6, then we
    could use the shell method.  The disc method would work, but we'd
    have to use two separate areas since some parts of the area are bounded
    by just g(x) and the limits of integration (from n to some number
    between m and n -- z), while other parts are bounded by f(x) and g(x)
    (from z to m).  Moreover, you'd have to convert f(x) into F(y) and
    g(x) into G(y), making things more complicated.

    The diagram above of f(x) and g(x) shows that we should not use the
    shell method if we wanted to rotate the area around y = -1 since we
    would have to break it up into two areas as in the situation described
    above.

-[ AREAS ]-

        To find the area between say x = y^2+y and x = 2y, we'd enter in
the parameters we be as follows:

             AREAS BETWEEN TWO FUNCTIONS 
            EQ1: 'y^2+y'                                <-- highlighted
            EQ2: 2y
            MIN: 0          MAX: 1        METHOD
            VAR: y                     Normal
            ENTER 1ST BOUND EQUATION
            [EDIT][    ][    ][    ][(AN(][ OK ]

NOTE ABOUT VOLUMES AND AREAS:
There are cases when in order to find areas/volumes you must break up
the area into partial areas since certain areas are bounded by different
parts of a function(s).  Refer to your calculus book for more information
on these cases.  The same applies here when using the commands in this
library -- if you must separate certain parts, then use separate sessions
to find the necessary values for those parts, then add them up.

-[ LIMITS ]-

        For finding limits, we simply enter in a function in terms of 'X'
and input what value 'X' is to approach.

             FINDING LIMITS 
           
              LIM '(1-COS(X))/X'
               X-> 0                                    <-- highlighted
           
            ENTER TEST VALUE
            [EDIT][    ][    ][    ][(AN(][ OK ]

The result is 0, which is what you get by using L'Hopital's rule on
this indeterminate case.

-[ PARAMETES FOR VDISC, VSHELL, AREA, AND LIM ]-

VDISC and VSHELL have the following stack diagram:
        6: 'eq1' or real
        5: 'eq2' or real
        4: min          ----->          :VOL: volume
        3: max
        2: 'var'
        1: axis

AREA
        5: 'eq1' or real
        4: 'eq2' or real
        3: min          ----->          :AREA: area
        2: max
        1: 'var'

LIM
        2: 'eq' or real                 (must be in terms of X)
        1: xvalue       ----->          :LIM: limit or :LIM: Undefined

AREA and LIM can both be used in algebraics; VDISC and VSHELL cannot.

BUG REPORT - SUGGESTIONS

        If you happen to find any undocumented features (otherwise known
as bugs) please email me at: hduong@junix.ju.edu

                                                        - hpsolo -
