home *** CD-ROM | disk | FTP | other *** search
/ PDA Software Library / pdasoftwarelib.iso / PSION / UTILS / RPN3A / RPNCALC.TXT < prev   
Encoding:
Text File  |  1994-09-29  |  12.2 KB  |  315 lines
  1.  
  2.  
  3.  
  4.  
  5.                                                                         1
  6.  
  7.  
  8.                                   R P N     C a l c
  9.  
  10.                        RPN Calculator for the Psion Series 3a
  11.                                      Version 1.0
  12.  
  13.  
  14.  
  15.                     Original Program for the Series 3:
  16.                     Copyright (c) 1992 Jaime Pereira
  17.                     Email: jep@world.std.com
  18.                            Compuserve 70441,456
  19.                     Address: 312 Southwind Dr. #206
  20.                              North Palm Beach, FL 33408
  21.                              USA
  22.  
  23.                     Ported to the Series 3a by:
  24.                          Victor Alvarado
  25.                          vma@mvuts.att.com
  26.  
  27.  
  28.           =================================================================
  29.           This program is free software; you can redistribute it and/or
  30.           modify it under the terms of the GNU General Public License as
  31.           published by the Free Software Foundation; either version 1, or
  32.           (at your option) any later version.
  33.  
  34.           This program is distributed in the hope that it will be useful,
  35.           but WITHOUT ANY WARRANTY; without even the implied warranty of
  36.           MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  37.           General Public License for more details.
  38.  
  39.           You should have received a copy of the GNU General Public License
  40.           along with this program; if not, write to the Free Software
  41.           Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  42.  
  43.           =================================================================
  44.  
  45.  
  46.           INTRODUCTION
  47.           ------------
  48.  
  49.           RPN Calc is a Reverse Polish Notation calculator intended as an
  50.           alternative to the Psion Series 3a calculator application. It is
  51.           based on the HP-48 style interface.
  52.  
  53.           This initial release contains the following features:
  54.                
  55.                + RPN interface
  56.                + Basic stack manipulations (swap, rotate, clear stack)
  57.                + 20 element stack, of which the top 10 items are visible
  58.                + 10 memories
  59.                + Most math and trigonometry functions
  60.  
  61.  
  62.  
  63.                                                                         2
  64.  
  65.  
  66.           This document assumes that the reader is already familiar with
  67.           RPN.
  68.  
  69.           DISTRIBUTION
  70.           ------------
  71.  
  72.           The following files are in the RPN Calc distribution archive:
  73.  
  74.                RPNCALC.OPA    RPN Calc application program
  75.                RPNCALC.TXT    This document
  76.                RPNCALC.OPL    Source for RPN Calc
  77.                RPNCALC.PIC    RPN Calc icon
  78.                COPYING        GNU General Public License
  79.  
  80.           INSTALLATION INSTRUCTIONS
  81.           -------------------------
  82.  
  83.           Copy the file RPNCALC.OPA to the "\APP" directory. Install the
  84.           application in the system screen by pressing Psion-I. When the
  85.           "Install Application" dialog pops up, select the file RPNCALC.OPA
  86.           and press enter. RPN Calc will now be installed on your system
  87.           screen like your other applications.
  88.  
  89.           In addition, you can assign the "Calc" button to run RPN Calc
  90.           using the "Assign button" option of the Apps menu in the system
  91.           screen.
  92.  
  93.           UNINSTALLING RPN CALC
  94.           ---------------------
  95.  
  96.           Remove the RPN Calc application from the system screen by
  97.           pressing Psion-/. When the "Remove application?" dialog box
  98.           appears, press the 'Y' key. Lastly, delete the file called
  99.           RPNCALC.OPA in the "\APP" directory.
  100.  
  101.           If you reassigned the "Calc" button to run RPN Calc, you can
  102.           assign the "Calc" button back to the original Psion calculator
  103.           application using the "Assign button" option of the Apps menu in
  104.           the system screen.
  105.  
  106.           GETTING STARTED
  107.           ---------------
  108.  
  109.           After starting RPN Calc, you will see a window with two sections.
  110.           The bottom line of the screen with the flashing cursor is the
  111.           command line, where you enter the numbers. The area in the middle
  112.           of the screen is where the stack will be displayed.
  113.  
  114.           To place a number in the stack, type the number in the command
  115.           line and press Enter. If the command line is empty, the Enter key
  116.           will duplicate the value on top of the stack.
  117.  
  118.           While typing in a number, you can use the left and right arrow
  119.           keys and the delete key to edit the number before pressing Enter.
  120.  
  121.  
  122.  
  123.                                                                         3
  124.  
  125.  
  126.  
  127.           If, for example, you type the following (without spaces):
  128.                 1 0 2 8 <Enter> 5 0 +
  129.           The result, 1078, will be displayed in the top of the stack:
  130.                1:    1078
  131.  
  132.           As with all RPN calculators, results are calculated when you
  133.           enter one of the math operator keys
  134.                + - * /
  135.           or the keystroke for one of the math functions. The math and
  136.           trigonometric functions have the same keystrokes as in the Psion
  137.           calculator application. Press the Help key for a complete list of
  138.           the functions.
  139.  
  140.           If there is a number in the edit box, all operations consider it
  141.           the top of the stack. Otherwise, it is the number in the top
  142.           level of the stack, identified with a "1:".
  143.  
  144.           Notice that the top of the stack is displayed at the bottom of
  145.           the screen and the stack grows upward. This is similar to the
  146.           HP-48's display.
  147.  
  148.           To begin a new calculation, just start typing the new numbers.
  149.           Any old results are just pushed up the stack.
  150.  
  151.           The Delete key deletes the top item in the stack.
  152.  
  153.           Note: The diamond key, Control-Menu, and Psion-Z (zoom) keys are
  154.           not used in RPN Calc.
  155.  
  156.           THE STACK DISPLAY
  157.           -----------------
  158.  
  159.           Each number you enter, and the results of calculations, are
  160.           pushed up the stack. Up to 20 lines can be kept in the stack,
  161.           although the screen only displays the top items in the stack.
  162.  
  163.           If the command line is blank, you can scroll through the stack
  164.           using the up-arrow and down-arrow keys. The up and down arrow
  165.           keys also allow you to bring any of the values in the stack down
  166.           to the edit box to be reused in a new calculation.
  167.  
  168.           You can clear the stack with the 'New stack' option in the
  169.           'Special' menu.
  170.  
  171.           TRIGONOMETRIC FUNCTIONS
  172.           -----------------------
  173.  
  174.           The trigonometric functions can work either with degrees or
  175.           radians. Initially, they work with degrees. Use the 'Format'
  176.           option in the 'Options' menu to change to radians.
  177.  
  178.           For the value of the constant 'pi', just type the character 'P'.
  179.           For example:
  180.  
  181.  
  182.  
  183.                                                                         4
  184.  
  185.  
  186.                P 2 / Psion-S
  187.           gives 1 (when using radians).
  188.  
  189.           CALCULATOR MEMORIES
  190.           -------------------
  191.  
  192.           RPN Calc has 10 memories, identified by the numbers 1 to 10. They
  193.           are used in a similar way as the Sto and Rcl buttons on some HP
  194.           calculators. For example, to store the top of the stack in memory
  195.           4, press 4 followed by the 'I' key.
  196.  
  197.           Similarly to recall a value stored in a memory press the memory
  198.           number followed by the 'O' key. The number will appear in the top
  199.           of the stack.
  200.  
  201.           All memories have an initial value of 0.
  202.  
  203.           EXPONENTIAL NUMBER FORMAT
  204.           -------------------------
  205.  
  206.           To enter a very large or very small number, use the character 'e'
  207.           (upper or lower case) as the exponent in a number. For example:
  208.                3 . 1 4 1 5 9 e 3 <RETURN>
  209.           displays 3141.59 on the top of the stack.
  210.  
  211.           DECIMAL PLACES AND NUMBER FORMATS
  212.           ---------------------------------
  213.  
  214.           Calculations are accurate to at least 12 digits.
  215.  
  216.           Results are initially shown in 'General' format, showing as many
  217.           decimal places as necessary, up to the maximum of 15.
  218.  
  219.           For example,
  220.                1 <ENTER> 3 /
  221.           gives 1.333333333333333, while
  222.                1 <ENTER> 4 /
  223.           gives 0.25.
  224.  
  225.           Use the 'Format' option in the 'Options' menu to specify the way
  226.           you want the results of your calculations to be shown.
  227.  
  228.           The options in the Format dialog box are as follows:
  229.  
  230.           General - as many decimal places are displayed as were
  231.                     calculated. Large or small numbers are shown as
  232.                     exponential numbers, e.g. 1.1E+30.
  233.  
  234.           Fixed - results are shown to the number of decimal places you
  235.                     specify on the 'Decimal places' line. The accuracy is
  236.                     still 12 digits, and the results are rounded, if
  237.                     necessary, to ensure that there are the correct number
  238.                     of decimal places.
  239.  
  240.  
  241.  
  242.                                                                         5
  243.  
  244.  
  245.           Scientific - Results are always shown as exponential numbers to
  246.                     the number of significant digits - digits either side
  247.                     of the decimal point - you specify on the 'Decimal
  248.                     places' line. The result may be rounded to ensure that
  249.                     this happens. The minimum number of significant digits
  250.                     is 2.
  251.  
  252.  
  253.                                      APPENDICES
  254.  
  255.           TABLE OF BASIC OPERATIONS
  256.           -------------------------
  257.  
  258.           operation       key             before          after
  259.           ---------------------------------------------------------
  260.           dup             Enter           n               n  n
  261.           drop            Delete          n
  262.           swap            S               n1 n2           n2 n1
  263.           rot             R               n1 n2 n3        n2 n3 n1
  264.  
  265.           mem store       I               mem n
  266.           mem recall      O               mem             n
  267.  
  268.           addition        +               n1 n2           n2+n1
  269.           subtraction     -               n1 n2           n2-n1
  270.           multiplication  *               n1 n2           n2*n1
  271.           division        /               n1 n2           n2/n1
  272.           power           x               n1 n2           n2^n1
  273.  
  274.           Pi constant     P                               Pi
  275.           ---------------------------------------------------------
  276.  
  277.           CHANGE LOG
  278.           ----------
  279.           Version 1.0 - Initial release of series 3a version.
  280.  
  281.           IDEAS FOR FURTHER IMPROVEMENTS
  282.           ------------------------------
  283.           This is a wish-list of features that would be nice to have in
  284.           future versions of RPN Calc:
  285.  
  286.                + Implement more of the calculator application's features:
  287.                     + Access to OPL functions and your own OPL procedures
  288.                     + Zoom-in and Zoom-out with Psion-Z
  289.                     + Ability to invoke math functions from menus
  290.                + Implement some of these HP48-like features:
  291.                     + Hex and binary display modes
  292.                     + Engineering display format
  293.                     + Complex numbers
  294.                     + Interactive stack
  295.                     + Named variables
  296.                     + Graphing and plotting
  297.                     + Programming language (RPL, or even HP-41)
  298.  
  299.  
  300.  
  301.                                                                         6
  302.  
  303.  
  304.                + Other features:
  305.                     + Implementation of "Bring", in order to paste results
  306.                       into other applications.
  307.  
  308.           CONTRIBUTORS
  309.           ------------
  310.  
  311.           Jaime Pereira - Original version of this document, and the
  312.                     original RPN Calc for the Psion Series 3
  313.  
  314.           Victor Alvarado - Modifications for the 3a and additional changes
  315.                     to this document