


     [1mRPN V1.00 900131 - Release notes[0m                             by MLO

     [3mExcuse my bad english, folks ...

            RPN  [0mis a computer program that simulates, on the AMIGA screen,
     an Hewlett-Packard pocket computer. A first version of [3mRPN [0mwas written
     several years ago in FORTRAN  for an HP21MX mini computer,  then moved
     to  a VAX; a BASIC  version for IBM PC's  was also written. Now [3mRPN [0mis
     translated in C (the better  human creation after italian people)  for
     Commodore  Amiga; the  compiler is  Lattice C  V5.04, and the original
     environment an Amiga 500 with 2.5 MBytes of Fast Ram, but the  program
     must  run on every configuration and  should (with minimal changes) be
     compiled and linked using Manx's Aztec-C.
            The source files, the objects, and the [3mMAKEFILE [0mused to compile
     and link [3mRPN [0mare  included: you are welcome  to modify the source,  if
     you  will find some error (although tested, this program could contain
     errors - this  is human) or  if you do  not like the  aesthetics. But,
     please,  send me your changes at the address that you will find at the
     end of this [3mRead.Me [0mfile.
            The simulated  pocket computer  was originally  an HP-32,  then
     some  features of  HP-11C were  also included;  I assume  that you are
     familiar with these  pocket computer families,  or at least  with the [3m
     Reverse  Polish Notation (RPN)  [0mlogic they use:  [3mRPN [0mwas introduced by
     Lukasiewicz in 1924, and is  based over the statement [3m"every  function
     must  be  introduced  immediately  after  the  variables  that are its
     arguments". [0mAll  pocket computers  use this  logic for  functions of a
     single  argument, e.g. the square root:  you type the number, then you
     select the "square root" function.[3m
            RPN [0mcomputers use  the same logic  for [1mall [0mfunctions,  the four
     basic  arithmetic operations included;  in this way  you do not need a
     key  to  start  the  computation  (the  "="  key),  you  do  not  need
     parenthesis, and you can inspect, access and modify every intermediate
     result.  [3mRPN [0mhas a four registers stack, and sixteen memory registers:
     six  of  them,  from  [3mA  [0mto  [3mF,  [0mare  used  for  temporary  storage in
     statistical  computations; but you  can use all  of them to store your
     temporary  results.  Stack  and  registers  are  always  visible  in a
     dedicate window.
            To start [3mRPN [0msimply type [3mRPN [0mfrom CLI; or double-click over the
     [3mRPN [0micon (beware: real men do not use icons). You should obtain a main
     window  with key gadgets to be selected  using the mouse, and a string
     gadget (the  [3mInput Field  - IF[0m);  and a  secondary window  showing the
     values  stored in the stack and in  the sixteen registers. You can use
     also pull-down menus to perform some operations.
            To input  numerical values,  select the  [3mIF [0mgadget  - or type a
     character  that is suitable  for numerical input,  both in fixed point
     notation or in scientific notation, and the [3mIF [0mgadget will be selected
     for you. You can  modify what you typed,  because the [3mIF [0mwill  be read
     only when you deselect this string gadget (hitting the RETURN key; the
     value will be stored in the[3m X [0mregister) or selecting a key gadget or a
     menu  option (the numeric value  will be stored in  the [3mX [0mregister and
     then the function you required will be performed on it).
            [1mEvery [0moperation is tested against arithmetical errors, and  the
     stack  or the registers will be modified [1monly [0mif no error is detected;
     if  you  by  mistake  select  a  wrong,  but legal, operation, you can


                                     - 1 -



     recover  the  stack  and  registers  status  selecting the [3mLast X [0mmenu
     option and then  the inverse of  the last function.You  can with [3mRPN  [0m
     perform:


          - The four basic arithmetic operations.
          - Inverse, square root, square, powers, percentage.
          - Exponential and logarithmic functions, both natural and
            decimal.
          - Trigonometric or hyperbolic sine, cosine and tangent and their
            inverse functions.
          - Convert angles to radians, sexagesimal and centesimal degrees;
            convert numbers from decimal to sexagesimal system, or the
            inverse; convert coordinates from rectangular to polar, or the
            inverse.
          - Statistical computations: mean, standard deviation, linear
            correlation coefficient, linear regression, coordinates of
            points on the linear regression line, errors on the ordinates
            with the Fisher's formula.
          - Direct arithmetic operations on memory registers.


            For  trigonometric functions, you can select angle measurements
     in  radians   or  degrees,   both  sexagesimal   or  centesimal;   all
     computations  are performed in double precision (64 bits). The [3mInv [0mkey
     [1mmust [0mbe followed by [3mSin/Cos/Tan [0mand indicates their inverse  function;
     [3mHyp  [0mintroduces the  hyperbolic functions,  and[3m Inv  Hyp, [0mor [3mHyp Inv, [0m
     their inverse.Reminder:


          - The % key computes in [3mX [0mthe [3mX [0mpercentage of [3mY.[0m
          - The sequences [3mRecall "Operation" Register [0mperform an [3mEnter,
            [0mthen show in [3mX [0mthe result of [3mX "Operation" Register.[0m
          - The sequences [3mStore "Operation" Register [0mstore in [3mRegister [0mthe
            result of [3mRegister "Operation" X.[0m
          - For the mean and the standard deviation: after hitting the [3mMean
          [0m  key you will find the mean in [3mX [0mand the standard deviation in
            [3mY.[0m
          - Hitting the [3mL.R. [0mkey, the linear regression line [3mA+Bx [0mis
            computed; you will find [3mA [0min the [3mX [0mregister, and [3mB [0min [3mY.[0m The
            memory registers [3mA..F [0mcontain:

                         [3mA       [0mNumber of points
                         [3mB [0m      Sum of x values
                         [3mC [0m      Sum of the squares of the x's
                         [3mD [0m      Sum of the y's
                         [3mE [0m      Sum of the squares of the y's
                         [3mF [0m      Sum of the products x times y

          - Polar coordinates: the radius is in [3mX [0mand the azimuth angle in
           [3m Y[0m.





                                     - 2 -



     About the author: please notify all modifications to:

            Maurizio LORETI (or MLO, or I3NOO)
                Via G. Donizetti, 6
          35010 CADONEGHE (PD)
                ITALY

     Also reachable with E-Mail at the address you will find in the
     source headers.

           LORETI at IPDINFN      (BITNET)


                                                            Have fun!

                                                               MLO








































                                     - 3 -
