home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-3.iso / Tools / calculators / SciCalc.README < prev   
Encoding:
Text File  |  1991-08-12  |  9.6 KB  |  205 lines
  1. ===============================================================================
  2. This is the binary only distribution of the SciCalc application.  SciCalc is
  3. a more richly featured version of the basic Calculator example program from
  4. which it was spawned from.  SciCalc is FreeWare and should be treated as such.
  5. SciCalc requires NextStep 2.0 or greater to run.  This distribution is binary
  6. only not out of rudeness, but in an effort to reduce the distribution size.
  7. Hey, my Internet connection is only 2400 baud.  If anyone cares or complains
  8. I will distribute the source at a later time.  What follows is the extracted
  9. text from the online help panel:
  10. ===============================================================================
  11.  
  12.                 SciCalc - Help
  13.  
  14. SciCalc is a push button calculator that supports many of the features found
  15. on your average buck  $2.98 scientific pocket calculator.  
  16.  
  17. EXPRESSION SYNTAX:
  18.    SciCalc processes mathematical expressions in a normal left to right order
  19. while taking into account operator precedence.  For example SciCalc evaluates
  20. "1 + 2 * 3" to be equal to 7.  Each expression is displayed just as it is 
  21. entered in the upper LCD window.  When the Equals [=] button is pressed the
  22. entered expression is evaluated and the display is replaced by the result.
  23. If an invalid expression is formed SciCalc will display the "<Syntax Error>"
  24. string which prohibits further operation until the All Clear [AC] button is
  25. pressed. 
  26.  
  27. OPERATORS AND FUNCTIONS:
  28.   SciCalcs expressions are formed as a sequence of values separated by
  29. operators and values preceeded by functions.  Operators include the basic Plus
  30. [+], Minus [-], Multiply [x], and Divide [/].  All operators must be preceeded
  31. by and followed by either an explicit value or a function request.  Other
  32. operators include the [X^Y] and [X Root of Y] buttons.  Function requests are
  33. made by pressing the desired function key followed by a value or an expression
  34. in parenthesis.  Examples of Function keys include the [sin], [10^x], and [X!]
  35. buttons.  As an example the key sequence for entering the following expression
  36. would be:
  37.  
  38.     sin (23 - 5^(3.1*2.5)) / (11-5*4) 
  39.  
  40.     Press [sin] then [(] then [2] then [3] then [-] then [5] then [X^Y] then
  41.     [(] then [3] then [.] then [1] then [*] then [2] then [.] then [5] then
  42.     [)] then [)] then [/] then  [(] then [1] then [1] then [-] then [5] then
  43.     [*] then [4] then [)] and finally [=].
  44.  
  45.  
  46. MODIFIED FUNCTIONS:
  47.    Not all available functions have a unique button.  Most function buttons
  48. can be altered via the modifer toggle buttons [Hyperbolic] and [Inverse].
  49. The following table lists each button that has a modified function.  The H's
  50. and I's in the modifier column indicates that the Hyperbolic and Inverse 
  51. toggle buttons must be set to access the function.
  52.  
  53.         Button      Modifer     Function
  54.         ======        =======     ======== 
  55.         [sin]        H            sinh
  56.                            I    asin
  57.                     H      I    asinh
  58.         [cos]       H            cosh
  59.                            I       acos
  60.                     H      I        acosh                     
  61.         [tan]        H            tanh
  62.                         I       atan
  63.                     H      I        atanh
  64.         [e^x]              I        ln (natural log)
  65.         [10^x]      I       log (log base 10)
  66.         [X^y]              I        Xth root of Y
  67.         [X^2]              I        Square Root
  68.  
  69.  
  70. METRICS FOR TRIGNOMETRIC FUNCTIONS:
  71.     The Metric radio box determines how to interpret the input value for the
  72. SIN, COS, and TAN functions, and what value to return for the ASIN, ACOS, and
  73. ATAN functions.   The choices stand for Degrees, Radians, and Gradians.  The
  74. current metric may be changed at anytime, and may be changed in the middle of
  75. partially entered expression.  The current metric will determine the result of
  76. any of the previously mentioned functions as soon as the functions argument
  77. value is determined.
  78.  
  79.  
  80. CHANGING THE NUMERIC BASE
  81.     The Base radio box can be used to change the operating numeric base 
  82. between Decimal, Hexidecimal, Octal, and Binary.  When in decimal mode all
  83. values are expressed in 8 byte (Quadword) units.  Hex, Octal, and Binary
  84. values can only be expressed in 4 byte (Longword) units, 2 byte (Word) units,
  85. or single byte units.  When in Hex, Octal, or Binary base the binary operators
  86. And, Or, Not, Xor, Lsh, and Rsh are enabled.  When the base is changed any
  87. currently entered value is replaced by its equivalent value in the new base if
  88. possible.  The value in the currently selected memory cell is also reformatted
  89. in the newly selected base.  Each numeric base will only permit the appopriate
  90. set of number keys for the selected base.  It is possible to change the 
  91. numeric base in the middle of an expression.  For example to add 20 Hex to 20
  92. Octal perform the following.  First select Hex base and enter 20.  Then press
  93. the [+] button and follow that by selecting Oct base.  Enter 20 and press the
  94. [=] button.  The result is expressed in Octal will be 60.  By selecting
  95. Decimal base result will show 48, which should make sense since 20 (hex) = 32
  96. and 20 (oct) = 16, and 32+16=48.
  97.  
  98.  
  99. CHANGING THE UNIT SIZE
  100.     The Unit size is only important when in Hexidecimal, Octal, or Binary base
  101. mode.  When in Decimal mode all values are expressed in 8 byte Quadwords.
  102. When in Hexidecimal, Octal or Binary mode the Unit size may be set to either 4
  103. byte Longwords, 2 byte Words, or a single byte.  The selected Unit size will
  104. determine the value range of the expression result.  And will determine how a
  105. value will be interpreted when changing the Base between Hex/Oct/Bin and Dec
  106. mode.  For example if the value FF is entered while Base=Hex and Unit=Byte,
  107. and the base is changed to decimal the value displayed will be -1.  If the
  108. Unit size were set to Word the displayed value would be 255.
  109.  
  110.  
  111. CHANGING FUNCTION MODE
  112.     SciCalc provides two ways to use the function keys.  The function mode is
  113. toggled between Evaluate and Operate modes from the application menu item
  114. Function submenu, or more simply by the Command-f keystroke.  The default
  115. method is to evaluate functions as part of the entered expression.  The 
  116. alternate method is to use the function buttons in an a operator mode.  In
  117. Operate mode the selected function takes the currently entered value as its
  118. argument, and then replaces the value with the result of the function. 
  119.  
  120.  
  121. MEMORY FUNCTIONS:
  122.     SciCalc provides 26 temporary memory storage cells labeled A through Z.
  123. The currently selected memory cell is indicated by the label well between the
  124. up and down arrows and the memory cell LCD window.   Different memory cells
  125. can be selected via the up and down arrow buttons next to the memory LCD.
  126. The up arrow moves up the alphabet towards A, and the down arrow moves torward
  127. Z.  The [MS] and [MR] buttons are used to store and recall the current value
  128. to and from the currently selected memory cell.  The [MC] button will clear
  129. the value in the currenlty selected memory cell.
  130.  
  131.  
  132. BITWISE FUNCTIONS:
  133.     The bitwise functions are used to manipulate binary data, and hence are
  134. only available when the selected Base is set to either Hexidecimal, Octal, or
  135. Binary.  The [And], [Or], and [Xor] buttons are binary operators that perform
  136. bitwise And, Or, and Exclusive Or operations on the supplied operands.  The
  137. [Not], [Lsh], and [Rsh] buttons are actually functions that perform the
  138. bitwise Not, the arithmetic left shift, and arithemtic right shift operations
  139. respectively.
  140.  
  141.  
  142. OUTPUT PRECISON:
  143.     The output of an expressions result may be modified by the precison slider.
  144. When SciCalc is in Base Decimal the precision setting determines how many
  145. digits to print to the right of the decimal point.   If the current precision
  146. setting is less than the number of digits in the decimal portion of the result
  147. the value will be displayed in exponential notation.  When SciCalc is in Base
  148. Hex, Octal, or Binary mode the precision setting determines the minimum number
  149. of digits to print in the result.
  150.  
  151.  
  152. KEYBOARD SHORTCUTS
  153.     SciCalc provides various keyboard alternatives to clicking on many of the
  154. buttons.  First and foremost are the numeric buttons [0]-[9], [A]-[F], and
  155. [.].  Each of these buttons may be entered by typing the corresponding key on
  156. the main keyboard or the numeric keypad.  The basic arithmetic operators plus,
  157. minus, times, divide can be entered by typing "+", "-", "*", and "/"
  158. respectively.  The [=] equals button may entered by typing "=", or by pressing
  159. the Return or Enter key.   Typing "(" or ")" are alternatives to clicking the
  160. parenthesis buttons.  Typing "~" is equivalent to pressing the [+-] button.
  161. The following table lists all the available keyboard shortcuts that you will
  162. find impossible to remember:
  163.  
  164.     Keystroke                Function
  165.     ----------------        ------------------------
  166.     ESC                        All Clear
  167.     Delete                  Clear Entry
  168.     Ctrl-C                  COS
  169.     Ctrl-S                  SIN
  170.     Ctrl-T                  TAN
  171.     Shift-Ctrl-C            COSH
  172.     Shift-Ctrl-S            SINH
  173.     Shift-Ctrl-T            TANH
  174.     Alt-C                   ACOSH
  175.     Alt-S                   ASINH
  176.     Alt-T                   ATANH
  177.     Shift-Alt-C                ACOSH
  178.     Shift-Alt-S                ASINH
  179.     Shift-Alt-T                ATANH
  180.     "P" or "p"                Enter Pi
  181.     "["                        Memory Store
  182.     "]"                        Memory Recall
  183.     "\"                        Memory Clear
  184.     Ctrl-E                  e^x
  185.     Alt-E                   ln
  186.     Ctrl-F                  X!
  187.     Ctrl-L                  10^x
  188.     Alt-L                   LOG
  189.     Ctrl-R                  1/X
  190.     Ctrl-X                  X^2
  191.     Alt-X                   Square Root
  192.     Ctrl-Y                  X^Y
  193.     Alt-Y                   X root Y
  194.  
  195.  
  196. LEGAL STUFF:
  197.     SciCalc is free software and may be freely distributed with the single
  198. restriction that modified versions of this software may only be redistributed
  199. by the original author.  Please send bug reports and any comments to the
  200. following email address:
  201.  
  202.             mdm@wdl1.wdl.loral.com
  203.  
  204.  
  205.