home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 544a.lha / RPN_v1.0 / READ.ME.pp / READ.ME
Text File  |  1991-09-06  |  7KB  |  181 lines
  1.  
  2.  
  3.  
  4.      RPN V1.00 900131 - Release notes                             by MLO
  5.  
  6.      Excuse my bad english, folks ...
  7.  
  8.             RPN  is a computer program that simulates, on the AMIGA screen,
  9.      an Hewlett-Packard pocket computer. A first version of RPN was written
  10.      several years ago in FORTRAN  for an HP21MX mini computer,  then moved
  11.      to  a VAX; a BASIC  version for IBM PC's  was also written. Now RPN is
  12.      translated in C (the better  human creation after italian people)  for
  13.      Commodore  Amiga; the  compiler is  Lattice C  V5.04, and the original
  14.      environment an Amiga 500 with 2.5 MBytes of Fast Ram, but the  program
  15.      must  run on every configuration and  should (with minimal changes) be
  16.      compiled and linked using Manx's Aztec-C.
  17.             The source files, the objects, and the MAKEFILE used to compile
  18.      and link RPN are  included: you are welcome  to modify the source,  if
  19.      you  will find some error (although tested, this program could contain
  20.      errors - this  is human) or  if you do  not like the  aesthetics. But,
  21.      please,  send me your changes at the address that you will find at the
  22.      end of this Read.Me file.
  23.             The simulated  pocket computer  was originally  an HP-32,  then
  24.      some  features of  HP-11C were  also included;  I assume  that you are
  25.      familiar with these  pocket computer families,  or at least  with the 
  26.      Reverse  Polish Notation (RPN)  logic they use:  RPN was introduced by
  27.      Lukasiewicz in 1924, and is  based over the statement "every  function
  28.      must  be  introduced  immediately  after  the  variables  that are its
  29.      arguments". All  pocket computers  use this  logic for  functions of a
  30.      single  argument, e.g. the square root:  you type the number, then you
  31.      select the "square root" function.
  32.             RPN computers use  the same logic  for all functions,  the four
  33.      basic  arithmetic operations included;  in this way  you do not need a
  34.      key  to  start  the  computation  (the  "="  key),  you  do  not  need
  35.      parenthesis, and you can inspect, access and modify every intermediate
  36.      result.  RPN has a four registers stack, and sixteen memory registers:
  37.      six  of  them,  from  A  to  F,  are  used  for  temporary  storage in
  38.      statistical  computations; but you  can use all  of them to store your
  39.      temporary  results.  Stack  and  registers  are  always  visible  in a
  40.      dedicate window.
  41.             To start RPN simply type RPN from CLI; or double-click over the
  42.      RPN icon (beware: real men do not use icons). You should obtain a main
  43.      window  with key gadgets to be selected  using the mouse, and a string
  44.      gadget (the  Input Field  - IF);  and a  secondary window  showing the
  45.      values  stored in the stack and in  the sixteen registers. You can use
  46.      also pull-down menus to perform some operations.
  47.             To input  numerical values,  select the  IF gadget  - or type a
  48.      character  that is suitable  for numerical input,  both in fixed point
  49.      notation or in scientific notation, and the IF gadget will be selected
  50.      for you. You can  modify what you typed,  because the IF will  be read
  51.      only when you deselect this string gadget (hitting the RETURN key; the
  52.      value will be stored in the X register) or selecting a key gadget or a
  53.      menu  option (the numeric value  will be stored in  the X register and
  54.      then the function you required will be performed on it).
  55.             Every operation is tested against arithmetical errors, and  the
  56.      stack  or the registers will be modified only if no error is detected;
  57.      if  you  by  mistake  select  a  wrong,  but legal, operation, you can
  58.  
  59.  
  60.                                      - 1 -
  61.  
  62.  
  63.  
  64.      recover  the  stack  and  registers  status  selecting the Last X menu
  65.      option and then  the inverse of  the last function.You  can with RPN  
  66.      perform:
  67.  
  68.  
  69.           - The four basic arithmetic operations.
  70.           - Inverse, square root, square, powers, percentage.
  71.           - Exponential and logarithmic functions, both natural and
  72.             decimal.
  73.           - Trigonometric or hyperbolic sine, cosine and tangent and their
  74.             inverse functions.
  75.           - Convert angles to radians, sexagesimal and centesimal degrees;
  76.             convert numbers from decimal to sexagesimal system, or the
  77.             inverse; convert coordinates from rectangular to polar, or the
  78.             inverse.
  79.           - Statistical computations: mean, standard deviation, linear
  80.             correlation coefficient, linear regression, coordinates of
  81.             points on the linear regression line, errors on the ordinates
  82.             with the Fisher's formula.
  83.           - Direct arithmetic operations on memory registers.
  84.  
  85.  
  86.             For  trigonometric functions, you can select angle measurements
  87.      in  radians   or  degrees,   both  sexagesimal   or  centesimal;   all
  88.      computations  are performed in double precision (64 bits). The Inv key
  89.      must be followed by Sin/Cos/Tan and indicates their inverse  function;
  90.      Hyp  introduces the  hyperbolic functions,  and Inv  Hyp, or Hyp Inv, 
  91.      their inverse.Reminder:
  92.  
  93.  
  94.           - The % key computes in X the X percentage of Y.
  95.           - The sequences Recall "Operation" Register perform an Enter,
  96.             then show in X the result of X "Operation" Register.
  97.           - The sequences Store "Operation" Register store in Register the
  98.             result of Register "Operation" X.
  99.           - For the mean and the standard deviation: after hitting the Mean
  100.             key you will find the mean in X and the standard deviation in
  101.             Y.
  102.           - Hitting the L.R. key, the linear regression line A+Bx is
  103.             computed; you will find A in the X register, and B in Y. The
  104.             memory registers A..F contain:
  105.  
  106.                          A       Number of points
  107.                          B       Sum of x values
  108.                          C       Sum of the squares of the x's
  109.                          D       Sum of the y's
  110.                          E       Sum of the squares of the y's
  111.                          F       Sum of the products x times y
  112.  
  113.           - Polar coordinates: the radius is in X and the azimuth angle in
  114.             Y.
  115.  
  116.  
  117.  
  118.  
  119.  
  120.                                      - 2 -
  121.  
  122.  
  123.  
  124.      About the author: please notify all modifications to:
  125.  
  126.             Maurizio LORETI (or MLO, or I3NOO)
  127.                 Via G. Donizetti, 6
  128.           35010 CADONEGHE (PD)
  129.                 ITALY
  130.  
  131.      Also reachable with E-Mail at the address you will find in the
  132.      source headers.
  133.  
  134.            LORETI at IPDINFN      (BITNET)
  135.  
  136.  
  137.                                                             Have fun!
  138.  
  139.                                                                MLO
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.                                      - 3 -
  181.