home *** CD-ROM | disk | FTP | other *** search
/ Archive Magazine 1996 / ARCHIVE_96.iso / discs / mag_discs / volume_9 / issue_06 / pocketbook / calc3a / MANUAL.TXT < prev   
Text File  |  1995-12-17  |  38KB  |  1,319 lines
  1.                                            Calc3a│
  2.         Scientific Calculator for Psion Series 3a│
  3.                           (c) Alfa Computing 1995│
  4.                                   Richard Schmidt│
  5.                        Richard Sturenberghlaan 50│
  6.                                 2273 GX  VOORBURG│
  7.                             THE NETHERLANDS (EUR)│
  8.                   Email @ Compuserve : 100735,331│
  9.      Email @ Internet : 100735.331@compuserve.com│
  10.                                                  │
  11.                                      Version V1.5│
  12.                                          12/17/95│
  13.  
  14.  
  15. Index
  16. =====
  17. 1.     INTRODUCTION
  18. 2.     INSTALLING CALC3A
  19. 2.1    DISTRIBUTION
  20. 2.2    HOW TO INSTALL
  21. 2.3    REQUIREMENTS
  22. 2.4    UPDATING FROM VERSION V1.3
  23. 3.     GENERAL
  24. 3.1    CALCULATOR MAIN SCREEN
  25. 3.2    USING HELP
  26. 3.3    USING MENUS
  27. 3.4    PREFERENCES
  28. 4.     CALCULATIONS
  29. 4.1    GETTING STARTED
  30. 4.2    FUNCTIONS
  31. 4.2.1  Functions with two results
  32. 4.2.2  Functions with temporary results
  33. 4.2.3  Percentage calculations
  34. 4.3    CALCULATION EXAMPLES
  35. 4.4    MEMORIES
  36. 4.4.1  Statistics memories
  37. 4.4.2  Calculator memories
  38. 4.4.3  Recall buffer
  39. 4.4.4  Export of memories
  40. 5.     EQUATIONS
  41. 5.1    THE EQUATION DATABASE
  42. 5.2    INPUT OF EQUATIONS
  43. 5.3    DELETE EQUATIONS
  44. 5.4    EVALUATING EQUATIONS
  45. 6.     SOLVER
  46. 6.1    THE EQUATION DATABASE
  47. 6.2    SOLVING EQUATION
  48. 7.     XY PLOT
  49. 7.1    PLOT SETTINGS
  50. 7.2    EXECUTE XY PLOT
  51. 7.2.1  Trace mode
  52. 8.     CONSTANTS
  53. 9.     EXTERNAL MATH FUNCTIONS
  54. 10.    THE AUTHOR
  55. 10.1   HOW TO CONTACT THE AUTHOR
  56. 10.2   DISCLAIMER
  57. 10.3   HOW TO REGISTER
  58. 11.    APPENDICES
  59. 11.1   FUNCTION REFERENCE
  60. 11.2   KEYBOARD REFERENCE
  61. 11.3   LIST OF EXTERNAL FUNCTIONS
  62. 11.4   WITH SPECIAL THANKS TO ...
  63.  
  64. 1. Introduction
  65. ===============
  66. Welcome to Calc3a!
  67. Calc3a is a scientific calculator for the Psion 
  68. Series 3a. It operates similar to a CASIO(c) FX 
  69. or SHARP(c) style calculator and has 
  70. approximately 60 built-in math functions. Calc3a 
  71. has been set up to be just like a physical 
  72. calculator. It has an LCD display and tiny buttons 
  73. which can be accessed with single keystrokes.
  74.  
  75. Features of Calc3a:
  76. - basic, scientific, programmer and statistics 
  77.   calculations;
  78. - hexadecimal, binary and octal conversions/
  79.   calculations.
  80. - graphical XY plots;
  81. - equation database;
  82. - equation evaluator;
  83. - constants list;
  84. - 26 memories, statistics memory and 
  85.   recall buffer;
  86. - solver for single unknown variable in an 
  87.   equation;
  88. - support for external math functions in OPL.
  89.  
  90. Calc3a is only available in English for the Psion 
  91. Series 3a.
  92.  
  93. 2. Installing Calc3a
  94. ====================
  95. Before using the Calc3a application you should 
  96. install it from your PC to your Psion. 
  97.  
  98. 2.1 Distribution
  99. ================
  100. An unregistered copy of this application may be 
  101. distributed freely. The Calc3a application itself 
  102. consists of the following files:
  103.  
  104. CALC3A.OPA     Main application 
  105. CALC3A01.RSC   Help screens
  106. CALC3A02.RSC   Equation evaluator module
  107. CALC3A03.RSC   XY Plot module
  108. CALC3A04.RSC   Application resources
  109. ADDON.OPL      Example code for external math 
  110.                functions
  111. ADDON.OPO      Compiled version of ADDON.OPL
  112. CALC3A.EQN     Database with example equations
  113.                only for use with decimal 
  114.                separator set to period.
  115. COMMA.EQN      Database with example equations
  116.                only for use with decimal 
  117.                separator set to comma.
  118. MANUAL.TXT     This manual                            
  119. HISTORY.TXT    Changes since initial version
  120. EQNCONV.OPO    Utility to convert period based
  121.                equation database to a comma one
  122. EQNCONV.TXT    Documentation EQNCONV
  123.  
  124. 2.2 How to install
  125. ==================
  126. To install Calc3a:
  127.  
  128. - start RCOM or MCLINK;
  129. - connect and switch on Psion link in system 
  130.   screen with Psion-L; 
  131. - copy file CALC3A.OPA to an \APP directory on 
  132.   any disk
  133. - copy files CALC3A01.RSC, CALC3A02.RSC, 
  134.   CALC3A03.RSC and CALC3A04.RSC  to an 
  135.   \APP\CALC3A directory on any disk. 
  136. - optionally copy file ADDON.OPO to an \OPO 
  137.   directory and ADDON.OPL to an \OPL directory on 
  138.   any disk. This is only needed when you want to 
  139.   add you own math functions to the program. 
  140. - optionally copy file CALC3A.EQN to an \OPD 
  141.   directory on your default disk. This is only 
  142.   needed when you want to use/try the enclosed
  143.   example equations and has a period selected
  144.   as decimal separator (in the system screen).
  145.   When a comma is selected as a decimal 
  146.   separator, copy file COMMA.EQN to an \OPD 
  147.   directory on your default disk and RENAME it 
  148.   to CALC3A.EQN !
  149.   If you already added you own equations to the
  150.   database, use EQNCONV to convert it.
  151. - Install the Calc3a application in the system 
  152.   screen by pressing Psion-I.
  153.  
  154. Make sure you have an \OPD directory on your 
  155. default drive. Calc3a will save its 
  156. configuration to \OPD\CALC3A.INI. For easy use of 
  157. the program, assign the CALC button to the 
  158. program by pressing Psion-A. 
  159.  
  160. 2.3 Requirements 
  161. ================
  162. The application requires 90K RAM memory and 
  163. approximately 80K ram of disk space. If your 
  164. machine appears to be out of memory try to close 
  165. a few applications or erase files from internal 
  166. memory (after making a backup first!).
  167.  
  168. 2.4 Updating from version V1.3
  169. ==============================
  170. If you are updating from version V1.3 please 
  171. remove any existing \OPD\CALC3A.INI files.
  172.  
  173. 3. General
  174. ==========
  175.  
  176. 3.1  Calculator main screen
  177. ===========================
  178. After the application has been launched from the 
  179. system screen, the calculator main window 
  180. appears. The patterned grey bar on the top of the 
  181. screen contains two 'LCD displays'. 
  182.  
  183. The left LCD display shows us the calculator 
  184. modes and the contents of the active memory. The 
  185. modes can be changed by keyboard or from the 
  186. pull-down menus.
  187.  
  188. Mode                Description
  189. --------------------------------------------------
  190. Page         PAGE_A First page with 60 buttons
  191.              PAGE_B Second page with 60 buttons
  192.              PAGE_C Third page with 60 buttons
  193.                     (external functions) 
  194.  
  195. Calculation  COMP   Compute mode, scientific 
  196.                     calculations
  197. mode         SD     Statistics mode
  198.              LR     Linear regression mode
  199.  
  200. Trigonometr. DEG    Trigonometric. calculations 
  201.                     with degrees
  202. mode         RAD    Trigonometric. calculations 
  203.                     with radians
  204.  
  205. Format       GEN    General format base-10 numbers
  206.              SCI    Scientific format e.g.1.0E-12
  207.              FIX    Fixed format, fixed number of 
  208.                     decimals
  209.              HEX    Hexadecimal format base-16 
  210.                     numbers
  211.              BIN    Binary format base-2 numbers
  212.              OCT    Octal format base-8 numbers
  213.  
  214. Contents of active memory MA..MZ Memory 1 (A) up 
  215. to memory 26 (Z)
  216.  
  217. There are three keys available to switch these 
  218. modes:
  219. - Psion-C, to alter calculation mode;
  220. - Psion-T, to alter trigonometric mode;
  221. - Psion-F, to alter display format.
  222. Press these keys repeatedly to select the desired 
  223. mode.
  224.  
  225. To change directly to a base-n mode there are 
  226. four shortcut keys available:
  227. - Psion-D switch/convert to decimal (base-10)mode;
  228. - Psion-H switch/convert to hex (base-16) mode;
  229. - Psion-O switch/convert to octal (base-8) mode;
  230. - Psion-B switch/convert to binary (base-2) mode;
  231.  
  232. The last result or typed-in number on the LCD 
  233. screen will then automatically be converted to 
  234. the selected base-n equivalent. These four 
  235. shortcuts are also available in the menus. Press 
  236. the Menu key to display the top level menu.
  237.  
  238. The calculator has 26 memories to store numbers 
  239. and intermediate results. These memories are 
  240. called `MA' to `MZ'. The contents of the active 
  241. memory is always displayed on the left LCD. To 
  242. switch between these 26 memories press Control 
  243. and the memory identification character. e.g. 
  244. Control-C will select memory 3 (MC) and the 
  245. contents of this memory is displayed on the left 
  246. LCD. Please refer to chapter `Memories' to learn 
  247. more about these memories.
  248.  
  249. The right LCD display shows us calculation 
  250. results and numbers typed in by the user. If the 
  251. format is set to hexadecimal, binary or octal, 
  252. the displayed numbers are succeeded by a single 
  253. character where `b' stands for binary number, `o' 
  254. stands for octal number and `h' stands for 
  255. hexadecimal number. Negative numbers are preceded 
  256. by a negative (-) sign.
  257.  
  258. All buttons are displayed below the LCD 
  259. displays. Because of the large number of  buttons, 
  260. they are divided over two pages. To switch 
  261. between the two pages press PgUp and PgDn.
  262.  
  263. 3.2 Using help
  264. ==============
  265. Press the Help button to bring up the help 
  266. index. Select an item you want to know more about 
  267. and press Enter. Press Esc to leave help and to 
  268. return to the main screen.
  269.  
  270. 3.3 Using menus
  271. ===============
  272. Press the Menu key to display the top level menu. 
  273. The plot module, equation database manager and 
  274. the main calculator application all have 
  275. different menus.
  276.  
  277. 3.4 Preferences
  278. ===============
  279. The preferences can be changed by bringing up the 
  280. `Set preferences' menu.  This menu can be 
  281. accessed by pressing Psion-Q and has three items 
  282. `Keyboard', `Display' and `Modes'. After changing 
  283. the preferences they will be saved to disk.
  284.  
  285. Format
  286. Select between display formats. There are six 
  287. formats available. The formats can also be 
  288. selected by pressing Psion-F repeatedly. The 
  289. formats HEXadecimal, OCTal, BINary and GENeral 
  290. can also be selected by pressing the hot keys 
  291. (Psion-H, Psion-O, Psion-B and Psion-D) for these 
  292. formats.
  293.  
  294. Decimals
  295. Number of decimals to show for numbers on the 
  296. display. Press Tab repeatedly to select between 0 
  297. and 20 decimals. Numbers shown by the solver and 
  298. equation evaluator do also use this field to 
  299. determine the number of decimals.
  300.  
  301. Trigonometric calculations
  302. Select between trigonometric calculations with 
  303. degrees or radians. Math functions like SIN, TAN, 
  304. etc. require this mode to be set correctly.
  305.  
  306. Calculation mode
  307. Select between three different calculation modes:
  308. LR    Linear regression mode, requires single 
  309.       numbers as data;
  310. SD    Statistics mode, requires X,Y pairs of 
  311.       data;
  312. COMP  Compute mode, usage of all scientific 
  313.       functions.
  314.  
  315. Extra help mode
  316. To display a help line after each calculation is 
  317. executed set this field to `On'. Immediately 
  318. after you have pressed Enter or = or an unary 
  319. function a help line is displayed in the lower 
  320. right corner of the screen. When the `Extra help 
  321. mode' is set to on, all dialog boxes used for 
  322. entering equations will show the equation 
  323. constraints.
  324.  
  325. Decimal separator
  326. Select a comma or period as a decimal separator. 
  327. If the decimal separator has been altered, the 
  328. keyboard layout on the screen will be updated. 
  329. This setting must be equal to the one you set in 
  330. the system screen. So if you have chosen a 
  331. period as decimal separator in the system screen 
  332. (number format Shift-Psion-F) please select a 
  333. period in Calc3a application too!
  334.  
  335. ***********************************************
  336. To use the example equation database in 
  337. combination with the comma as separator, copy
  338. COMMA.EQN to \OPD\CALC3A.EQN. 
  339. ***********************************************
  340.  
  341. To separate X- and Y-data in LR memory use the 
  342. period in case you use the comma as decimal 
  343. separator. Use the comma to separate if you use 
  344. the period as decimal separator.
  345.  
  346. Alternative keyboard
  347. This option is only for users that have a Psion 
  348. with a German keyboard layout. This option swaps 
  349. some keys:
  350.  
  351. Function Non German German
  352. --------------------------
  353. PI       ~          z
  354. `"o      `          Q
  355. MIN      ^          M
  356.  
  357. Parenthesis
  358. Mode for closing parenthesis. Options are:
  359. - calculate on close;
  360. - wait for <Enter>.
  361.  
  362. 4. Calculations
  363. ===============
  364.  
  365. 4.1 Getting started
  366. ===================
  367. After the application has been launched from the 
  368. system screen, the calculator main window 
  369. appears. The patterned grey bar on the top of the 
  370. screen contains two 'LCD displays'. 
  371.  
  372. The left LCD display shows the trigonometric mode 
  373. (DEG or RAD), the calculation mode (SD, LR or 
  374. COMP), the format used to display numbers 
  375. (SCIentific, GENeral, FIXed, HEXadecimal, BINary 
  376. or OCTal) and the contents the active memory M. 
  377.  
  378. The right LCD display shows results of 
  379. calculations and numbers typed in by the user. 
  380. All calculator buttons can be 'pressed' with 
  381. single keystrokes. Each button is preceded by a 
  382. single upper or lowercase character. This 
  383. character can be used to activate a button and 
  384. thus a math function.
  385.  
  386. Calculations are performed just as you would with 
  387. a stand-alone calculator. Examples (<k> equals to 
  388. keystroke 'k')
  389.  
  390. Square root of 25    : 25<r>
  391. 10 to the power of 3 : 3<L>
  392. 2 to the power of 5  : 2<x>5<=>
  393. Mean of 4,8,9,3,2    : 4<@>8<@>9<@>3<@>2<@><\>
  394. 25 div 4             : 25<d>4<=>                          
  395. 150+17.5%            : 150<+>17.5<%>
  396. 10% of 1000          : 1000<*>10%
  397.  
  398. While typing in a number, press Delete to erase 
  399. the last digit typed . Esc clears all input. Press 
  400. the Help key in the Calc3a application to read 
  401. more about the usage of Calc3a.
  402.  
  403. 4.2  Functions
  404. ==============
  405. The calculator has approximately 60 built-in 
  406. functions. There are two types of functions:
  407.  
  408. 1.Unary
  409. Function applies to one number e.g. Square root of 
  410. x or Sine of x To perform an unary calculation, 
  411. first type in a number, than press a unary 
  412. function button. The result of this calculation 
  413. is shown at the right LCD display.
  414.  
  415. 2.Binary
  416. Function applies to two numbers e.g. 5+6 or x to 
  417. the power of y. To perform a binary calculation, 
  418. first type in the first number, than press a 
  419. binary function button (operator). Type in the 
  420. second number and press Enter. The result of this 
  421. calculation is shown at the right LCD display.
  422.  
  423. 4.2.1 Functions with two results
  424. ================================
  425. Some functions like POL() and REC() return two 
  426. results. After pressing the Enter key the result 
  427. of such a function will be shown at the lower 
  428. right corner of the screen for about two seconds. 
  429. The first result will also be shown at the 
  430. calculator LCD display. The second result is 
  431. stored in the recall buffer and can be accessed 
  432. by pressing the left-arrow key once.
  433.  
  434. 4.2.2 Functions with temporary results
  435. ======================================
  436. The function o`" (conversion degrees to 
  437. degrees-min-sec) returns a number in the form 
  438. of `degrees-minutes-seconds'. The result of 
  439. such a function will be displayed on the LCD 
  440. display until a key is pressed.
  441.  
  442. Please refer to appendix `functions' for more 
  443. about available math functions.
  444.  
  445. 4.2.3 Percentage calculations
  446. =============================
  447. Calc3a allows for simple percentage calculations:
  448. - add percentage;
  449. - subtract percentage;
  450. - calculate percentage.
  451.  
  452. A percentage calculation takes the following form:
  453. <Amount><Operator><Percentage><%>
  454.  
  455.  
  456. Operator/Description      Example
  457. --------------------------------------------------
  458. +  Add percentage   100+15% >> 100<+>15<%> 115
  459. -  Subtract perc.   50-17.5% >> 50<->17.5<%> 41.25
  460. *  Calculate perc.  10% of 1000 >>10<*>1000<%> 100
  461.  
  462. 4.3  Calculation examples
  463. =========================
  464. Below are some examples of several types of 
  465. calculations. Every example consists of three 
  466. parts:
  467. 1. Description of example
  468. 2. Math notation
  469. 3. keyboard strokes to perform calculations.
  470.    Do not type the '<' and '>' characters.
  471.  
  472. Square root of 100 
  473. SQR(100)
  474. 100<r>
  475.  
  476. Logarithm of 1000 
  477. LOG(1000)
  478. 1000<l>
  479.  
  480. Convert 10,50 polar to rectangular
  481. REC(10,50)
  482. 10<P>50<Enter>
  483.  
  484. 17.5% of 50
  485. 50*17.5%
  486. 50<*>17.5<%>
  487.  
  488. 100 plus 50%
  489. 100+50%
  490. 100<+>50<%>
  491.  
  492. 2 to the power of 8
  493. 2^8
  494. 2<x>8<Enter>
  495.  
  496. 2 to the power of 8
  497. 2^8
  498. 8<y>
  499.  
  500. -1.0*5
  501. NEG(5)
  502. 5<_>
  503.  
  504. Reciprocal value of sine of 50
  505. 1/SIN(50)
  506. 50<s><i>
  507.  
  508. Mean of 4.5, 6.7, 2.9 and 6.7
  509. MEAN(4.5, 6.7, 2.9, 6.7)
  510. Set calculator to SD mode 
  511. <Shift-Esc> (clear stat memory) 
  512. 4.5<@>6.7<@>2.9<@>6.7<@><\>
  513.  
  514. Correlation factor r of
  515. 10,12
  516. 11,15
  517. 12,18
  518. 14,16 
  519. r(data)
  520. Set calculator to LR mode 
  521. <Shift-Esc> (clear stat memory)
  522. 10<,>12<@>
  523. 11<,>15<@>
  524. 12<,>18<@>
  525. 14<,>16<@>
  526. <v>
  527.  
  528. Convert 50 decimal to binary
  529. BIN(50)
  530. <Psion-D>
  531. 50
  532. <Psion-B>
  533.  
  534. e (2.71....)
  535. EXP(1)
  536. 1<N>
  537.  
  538. 5-BASE log of  10
  539. 5LOG(10)
  540. 5<,>10<Diamond-key><g>
  541. Function gLOG(x) is an external function in 
  542. ADDON.OPO. External functions require the 
  543. operands to be separated with a comma (or point 
  544. for German users).
  545.  
  546. 4.4 Memories
  547. ============
  548.  
  549. 4.4.1 Statistics memories
  550. =========================
  551. The program allows for statistics calculations. A 
  552. maximum of 1000 numbers can be stored in this 
  553. statistics memory to be used for calculations in 
  554. SD mode. Also 1000 x,y numbers can be stored in 
  555. this memory when performing LR calculations. It 
  556. is possible to change numbers in the statistics 
  557. memory. Press Psion-Y to bring up the `Edit 
  558. statistics memory' dialog. Press the left-arrow 
  559. and right-arrow keys to scroll through all 
  560. numbers in statistics memory. A message will be 
  561. shown if the statistics memory does not contain 
  562. numbers.
  563.  
  564. After changing one or more numbers in statistics 
  565. memory all statistic functions will use these new 
  566. numbers.
  567.  
  568. 4.4.2 Calculator memories
  569. =========================
  570. Calc3a has 26 memories called MA..MZ. The M+ 
  571. (Psion-+) and M- (Psion--) buttons can be used to 
  572. store numbers into these memories. These memories 
  573. have an initial value of 0. The current value of 
  574. the active memory M is displayed on the top left 
  575. LCD display.
  576.  
  577. Press Psion-E to change the contents of one of 
  578. the memories. Use the left-arrow and right- arrow 
  579. key to select a memory to modify.
  580.  
  581. 4.4.3 Recall buffer
  582. ===================
  583. The application maintains a 'recall' buffer. Each 
  584. entered number and calculation result will be 
  585. stored to this recall buffer. Press Psion-S to 
  586. scroll through all previously entered numbers. To 
  587. recall a previously entered number or result 
  588. press the left arrow or right arrow key. The 
  589. numbers will appear on the calculator LCD. The 
  590. recall buffer has room for 50 numbers.
  591.  
  592. 4.4.4 Export of memories
  593. ========================
  594. The contents of the memories, statistics memory 
  595. and recall buffer can be exported to a plain text 
  596. file. Press Psion-G to bring up the `Export' 
  597. dialog. It possible to select the export of: - 
  598. memories A..Z and/or - statistics memory and/or - 
  599. recall buffer.
  600.  
  601. The contents of the different memories are 
  602. written to a single text file. These files can be 
  603. used to import into a spreadsheet. A typical export 
  604. to text file looks like:
  605.  
  606. Memories A-Z        
  607. 100.45
  608. 0
  609. .
  610. .
  611. 0
  612. 44.8
  613. 0
  614. Statistics memory
  615. 15,30
  616. 45,80
  617. 60,100
  618. Recall buffer
  619. 15
  620. 30
  621. 0
  622. .
  623. .
  624. 0
  625. 45
  626. 80
  627. 66
  628. 2.01515152
  629. 2.01515152
  630. 1.41956032
  631.  
  632. 5. Equations
  633. ============
  634. Calc3a allows for entering equations. These 
  635. equations are stored in a database called 
  636. \OPD\CALC3A.EQN. Equations in this database can 
  637. be evaluated or solved.
  638.  
  639. 5.1 The equation database
  640. =========================
  641. It is possible to set up a database with all your 
  642. frequently used equations and conversion 
  643. formulas. Each equation is stored with a 
  644. description (max 30 characters). The equation 
  645. database manager (EDM) shows up each time you 
  646. want to evaluate or solve an equation. 
  647.  
  648. The top frame of this dialog displays the number 
  649. of equations currently stored in the database and 
  650. the equation itself. This equation line is 
  651. updated each time you move the cursor over a new 
  652. equation.
  653.  
  654. The lower area of the dialog shows four buttons. 
  655. The `Evaluate' button is replaced by a `Solve' 
  656. button when solving equations. Keys available in 
  657. the EDM:
  658.  
  659. Up            Move cursor one row up
  660. Down          Move cursor one row down
  661. Pg-Up         Move cursor one page up
  662. Pg-Dn         Move cursor one page down
  663. Home          Move cursor to first equation
  664. End           Move cursor to last equation
  665. E or Psion-E  Enter equation/description 
  666.               selected with cursor
  667. D or Psion-D  Delete equation selected with cursor
  668. or Delete
  669. U or Psion-U  Enter new equation
  670. V or Psion-V  Evaluate equation
  671. or Enter
  672. S or Psion-S  Solve equation
  673. or Enter
  674. MENU          Bring up the equation database 
  675.               main menu
  676. X or Psion-X  Exit equation database and return to
  677. or Esc        main calculator
  678. F or Psion-F  Search for equation. Searches from 
  679.               current cursor position to end of 
  680.               database. Search is case sensitive.
  681. G or Psion-G  Find next occurrence  
  682.  
  683. 5.2 Input of equations
  684. ======================
  685. Press Psion-U from the main calculator screen to 
  686. bring up the equation database. Select an 
  687. equation with the selection bar (cursor) and 
  688. press U or Psion-U to modify an equation or E or 
  689. Psion-E to enter a new equation.
  690.  
  691. The `Equation evaluator' dialog has two fields. 
  692. One is for the short description (30 characters) 
  693. used as an identification for the equation. The 
  694. `Equation' field contains the equation itself. 
  695. This equation may be 255 characters long.
  696.  
  697. [Notice the constraints!]
  698.  
  699. In equations you can use:
  700. - Variables with names that only contain (a 
  701.   maximum of 12) alphabetical characters. The 
  702.   length of variable names is limited to 10 
  703.   characters and must be entered lowercase; 
  704. - All OPL math functions as mentioned in the 
  705.   Psion programming manual, function names must 
  706.   always be entered uppercase; Parenthesis; 
  707. - Trigonometric functions, radians/degrees 
  708.   depending on settings in system screen.
  709.  
  710. Available functions/constants for equations:
  711. ABS(x)    LN(x)     EXP(x)      +
  712. ACOS(x)   LOG(x)    SIN(x)      -
  713. ASIN(x)   MAX(a,b)  SQR(x)      *
  714. ATAN(x)   MEAN(a,b) STD(a,b)    /
  715. COS(x)    MIN(a,b)  TAN(x)      5E-5
  716. DEG(x)    RAD(x)    SUM(a,b)    x**y
  717. INTFx)    RND       VAR(x)
  718.  
  719. 5.3 Delete equations
  720. ====================
  721. Press Psion-U from the main calculator screen to 
  722. bring up the equation database. To delete an 
  723. equation just move the cursor over the equation 
  724. and press Delete, Psion-D or just D.
  725.  
  726. 5.4 Evaluating equations
  727. ========================
  728. Press Psion-U from the calculator main screen to 
  729. evaluate an existing equation. Select an equation 
  730. from the EDM and press V or Psion-V to execute 
  731. the evaluator. The Variables/result' dialog is 
  732. shown on screen. All the variables used in your 
  733. equation will be shown in this dialog. If you 
  734. used more than four variables in your equation 
  735. use the left-arrow and right-arrow key to 
  736. view/enter the other variables. 
  737.  
  738. Enter the contents of the variables and press 
  739. Enter. The result will be displayed in the same 
  740. dialog on the last line. To repeat an evaluation 
  741. just change a variable when desired and press 
  742. Enter.
  743.  
  744. If the equation was not entered correctly 
  745. (missing parenthesis, missing operators) a 
  746. message will be shown on screen and the result 
  747. will equal to 0.
  748.  
  749. 6. Solver
  750. =========
  751.  
  752. 6.1 The equation database
  753. =========================
  754. The solver uses an equation from the equation 
  755. database. Please refer to chapter 5.1 for more 
  756. information about the equation database manager. 
  757. The solver allows for solving a single unknown 
  758. variable in an equation. Therefor it uses method 
  759. `Secant' to find a single solution.
  760.  
  761. 6.2 Solving equation
  762. ====================
  763. Press Psion-L from the calculator main screen to 
  764. solve an existing equation. Pick an equation from 
  765. the EDM and press S or Psion-S to start the 
  766. solver.
  767.  
  768. The Variables/result' dialog is shown on screen. 
  769. Enter the values of the known variables. If you 
  770. used more than four variables in your equation 
  771. use the left-arrow and right-arrow key to 
  772. view/enter the other variables. The variable to 
  773. be solved can be set to zero.
  774.  
  775. Press Enter to bring up the solver settings 
  776. dialog.
  777.  
  778. Unknown variable to solve
  779. Press Tab on this field to view all variables 
  780. used in your equation. Select the variable to be 
  781. solved from the list.
  782.  
  783. Tolerance
  784. Tolerance in the result of the solving process. 
  785. The smaller the tolerance the more accurate 
  786. answers you get.
  787.  
  788. Maximum number of iterations
  789. Maximum number of iterations to find the result.
  790.  
  791. Initial guess1/guess2
  792. Two possible values for the unknown variable. 
  793. These two guesses form a X-range for the solver. 
  794. Please select an range as narrow as possible to 
  795. get accurate answers. The solver can be started  
  796. by pressing Enter. After a few seconds (depending 
  797. on the complexity of the equation) the result is 
  798. shown in the Variables/result dialog. If an error 
  799. occurs during the solve process  the result will 
  800. always equal 0. Possible errors are:
  801. <0  evaluation error (refer to Psion manual)
  802. 1   division by zero
  803. 2   curve has no slope
  804. 3   not enough iterations
  805. 4   solver interrupted
  806. 6   incorrect initial guesses
  807.  
  808. Note : Guess1<Guess2
  809.  
  810. 7. XY plot
  811. ==========
  812. Two functions can be plotted on the screen at a 
  813. time. After the functions have been plotted it is 
  814. possible to move a cursor around the screen to 
  815. determine points of intersection.
  816.  
  817. 7.1 Plot settings
  818. =================
  819. The plot settings must be set before making a 
  820. plot. Three dialogs will lead you through the 
  821. plot settings. All plot settings will be saved to 
  822. disk automatically. The first dialog is for 
  823. setting the axis options.
  824.  
  825. Scale
  826. It is possible to select a linear or logarithmic 
  827. scale for the X-axis and Y-axis. Only positive 
  828. logarithmic scales are allowed for.
  829.  
  830. X tick/Y tick
  831. A tick is a position marker on the axis. Tick can 
  832. be used for measuring and can only be used in 
  833. linear scaled plots. In logarithmic plots the 
  834. tick will be determined automatically.
  835.  
  836. Show labels in X-direction/
  837. Show labels in Y-direction
  838. Use this option to show values along the X- and 
  839. Y-axis. Labels can be plotted above or below the 
  840. X-axis and to the left or right of the Y-axis.
  841.  
  842. Show grid lines
  843. Grid lines are lines drawn on each tick on the 
  844. axis and can also be used for measuring.
  845.  
  846. Show intersection points
  847. Use this option to plot a point on all evaluated 
  848. X,Y position.
  849.  
  850. Plot line between intersection points
  851. Use this option to plot a line between the 
  852. evaluated X,Y points.
  853.  
  854. The second dialog is used to set the plot range
  855.  
  856. Xmin, Ymin, Xmax, Ymax
  857. Range for XY plot. These values are used for :
  858. - drawing the axis;
  859. - a range for x necessary to evaluate the 
  860.   function.
  861.  
  862. X step evaluator
  863. Step for x to evaluate the equations. So if the 
  864. range is set from -5 to 5 and step is set to 0.5 
  865. the equation will be (5--5)/0.5 = 20 times 
  866. evaluated. The following points will be 
  867. calculated : f(-5), f(-4.5), f(-4), f(-3.5), 
  868. f(-3), f(-2.5) .. f(5). The step value must be in 
  869. range 0.001-1000.
  870.  
  871. The third dialog queries two equations.
  872.  
  873. Function f(x)/g(x)=
  874. The equation for plotting. Two functions can be 
  875. plotted at a time using the same scale. The 
  876. equations may be 30 characters long. 
  877.  
  878. In equations you can use:
  879. - Only variable `x' (lowercase) can be used in 
  880.   equations;
  881. - All OPL math functions as mention in the Psion 
  882.   programming manual, function names must always 
  883.   be entered uppercase;
  884. - Parenthesis;
  885. - Trigonometric functions, radians/degrees 
  886.   depending on settings in system screen.
  887.  
  888. To plot only one function leave the other 
  889.   function field blank. If the equation was not 
  890. entered correctly (missing parenthesis, missing 
  891. operators) it will be drawn as f(x)=0. 
  892.  
  893. Plot
  894. This dialog also allows for selecting f(x) and/or 
  895. g(x) from the equation database. Use tab to 
  896. select between selecting only f(x) and/or g(x) or 
  897. plot functions as specified in the f(x) and g(x) 
  898. fields. The EDM dialog appears for selecting an 
  899. equation when you choose to select at least one 
  900. equation. Insure that the selected equation 
  901. contains only one variable named 'x' for correct 
  902. plotting.
  903.  
  904. See "equations" for available functions.
  905.  
  906. 7.2 Execute XY plot
  907. ===================
  908. Press Psion-K to plot the two functions according 
  909. to the plot settings. 
  910.  
  911. The cursor can be used to determine intersection 
  912. points or points on the graphs. To move this 
  913. cursor around:
  914. Left                 move cursor to left
  915. Right                move cursor to right
  916. Control-Left         move cursor to left in 
  917.                      big steps
  918. Control-Right        move cursor to right in 
  919.                      big steps
  920. Shift-Control-Left   move cursor to left in 
  921.                      huge steps
  922. Shift-Control-Right  move cursor to right in 
  923.                      huge steps
  924. Psion-+              Enlarge visor
  925. Psion--              Reduce visor
  926.  
  927. Press any key to interrupt plotting.
  928.  
  929. Press Menu to display the top level menu of the 
  930. plot module. Psion-J can be used to alter plot 
  931. settings. To redraw the plot with new settings 
  932. press Psion-K. To return to the calculator main 
  933. screen press Psion-X or Esc.
  934.  
  935. 7.2.1 Trace mode
  936. ================
  937. The cursor can be set to `Trace' function f(x)
  938. or function g(x). 
  939. Each time the cursor is moved in the X- 
  940. direction, the program recalculates F(x) and 
  941. positions the cursor on the calculated Y- 
  942. position on the curve. 
  943.  
  944. 8. Constants
  945. ============
  946. Calc3a allows for 10 numeric constants to be 
  947. defined. Press Psion-I to bring up the constants
  948. dialog. First select the constant (C0..C9) to 
  949. edit or paste. 
  950. Select paste to paste constant to calculator, use
  951. edit to modify selected constant.
  952.  
  953. 9. External math functions
  954. ==========================
  955. The Calc3a application allows for external math 
  956. functions to be accessed in a OPO file. Enclosed 
  957. with this package is an example OPL file that 
  958. illustrates the usage of external OPL functions. 
  959. In this file the procedure `Register()' must 
  960. always be available. This function is used by 
  961. Calc3a to determine what functions are available 
  962. in the external OPO file and what hotkey must be 
  963. used to access that particular function. There 
  964. are several procedures available for interfacing 
  965. with the Calc3a application. So, for each added 
  966. function you must add a RegFunc- entry to the 
  967. `Register()' procedure.
  968.  
  969. Example
  970.  
  971. PROC Register:
  972.         RegFunc:("v","VecLen")
  973. ENDP
  974.  
  975. PROC VecLen:
  976.         LOCAL x,y,length
  977.         
  978.         rem store operand 1 in x
  979.         x=GetOp1:
  980.         rem store operand 2 in y
  981.         y=GetOp2:
  982.         length=SQR(x**2+y**2)
  983.  
  984.         rem Send result to calculator
  985.         SetRes:(length)
  986. ENDP
  987.  
  988. Interfacing functions
  989.  
  990. PROC RegFunc:(key$,func$)
  991. Register your function to the Calc3a application. 
  992. key$  - single character hotkey (a..z, A..Z)
  993. func$ - function name to link to hotkey  
  994.         do not contain ":" in function  
  995.         name. The number of functions to 
  996.         register is limited to 52.
  997.  
  998. PROC GetStatX:(Elm%)
  999. Get X-element Elm% from statistics memory. 
  1000. Available in SD and LR mode
  1001.  
  1002. PROC SetStatX:(Elm%,Value)
  1003. Set X-element Elm% in statistics memory. 
  1004. Available in SD and LR mode
  1005.  
  1006. PROC GetStatY:(Elm%)
  1007. Get Y-element Elm% from statistics memory. Only 
  1008. available in LR mode
  1009.  
  1010. PROC SetStatY:(Elm%,Value)
  1011. Set Y-element Elm% in statistics memory. Only 
  1012. available in LR mode
  1013.  
  1014. PROC GetElm%:
  1015. Number of elements in statistics memory. 
  1016.  
  1017. PROC SetRes:(Result)
  1018. Send result to calculator
  1019.  
  1020. PROC GetRes:
  1021. Get last result from calculator
  1022.  
  1023. GetOp1:
  1024. Get operand 1
  1025.  
  1026. GetOp2:
  1027. Get operand 2
  1028.  
  1029. To access an external function from within the 
  1030. calculator:
  1031. - Press the diamond key;
  1032. - Press the hotkey.
  1033.  
  1034. External functions may contain all OPL commands 
  1035. including dialogs. Please refer to ADDON.OPL for 
  1036. more information. If this information is 
  1037. insufficient, contact the author for more 
  1038. information about using external functions.
  1039.  
  1040. Press Psion-Z or select PAGE_C to view all 
  1041. external functions.
  1042.  
  1043. 10. The author
  1044. ==============
  1045.  
  1046. 10.1 How to contact the author
  1047. ==============================
  1048. The author can be reached by mailing to:
  1049. Alfa Computing
  1050. Richard Schmidt
  1051. Richard Sturenberghlaan 50
  1052. 2273 GX  VOORBURG
  1053. THE NETHERLANDS (EUR)
  1054. Email @ Compuserve : 100735,331
  1055. Email @ Internet : 100735.331@compuserve.com
  1056.  
  1057. 10.2 Disclaimer
  1058. ===============
  1059. The author takes no responsibility for any lost 
  1060. data or hardware malfunctions of any kind due to 
  1061. the use of this software or any other software 
  1062. that ships with Calc3a.
  1063.  
  1064. 10.3 How To register
  1065. ====================
  1066. - send cash in envelope to my postal address or
  1067. - use SwReg on compuserve to register 
  1068.   SWReg id : 7171
  1069.   Product  : Calc3a or
  1070. - Only for Dutch users 
  1071.   Stort voor registratie Hfl 20,-- op 
  1072.   girorekening 6338889 tnv R.G.Schmidt
  1073.   te Voorburg o.v.v. uw adresgegevens.
  1074.  
  1075.  
  1076. 11. Appendices
  1077. ==============
  1078.  
  1079. 11.1 Function reference
  1080. =======================
  1081. +dB - add dB (decibel) - UC - B
  1082. 1/X - reciprocal of x - UC - i
  1083. 10^X - ten to the power of x - UCO - L
  1084. 2^X - two to the power of x - UC - y
  1085. A - constant term of regression a - KL - A
  1086. ABS - absolute of x - UCO - a
  1087. ACOS - inverse cosine of x - UCO - C
  1088. AND - logical AND - UC - G
  1089. ASIN - inverse sine of x - UCO - S
  1090. ATAN - inverse tangents of x - UCO - T
  1091. B - regression coefficient b - KL - W
  1092. COS - cosine of x - UCO - c
  1093. COSH - hyper cosine of x - UCO - h
  1094. COTG - cotangents of x - UC - g
  1095. dB - convert to decibel - UC - D
  1096. DEG - convert radians to degrees - UC - J
  1097. DIV - integer division - BC, - d
  1098. EXP - e to the power of x - UCO - N
  1099. Erg - convert to energetic - UC - E
  1100. EX - sum of x - KSO - u
  1101. Ex^2 - sum of square of x - KS - U
  1102. FRAC - fractal part of x - UC - f
  1103. INT - integer part of x - UCO - I
  1104. LN - natural logarithm of x - UCO - n
  1105. LOG - logarithm of x - UCO - l
  1106. MAX - lowest value of x - KSO - &
  1107. MEAN - mean of x - KSO - \
  1108. MIN - lowest value of x - KSO - ^ or M
  1109. MOD - modulo - BC - m
  1110. n - number of statistics data in memory - KS - ;
  1111. nCr - combinations - BC - o
  1112. nPr - permutations - BC - O
  1113. NEG - negative - UC - _
  1114. NOT - logical NOT - BC - F
  1115. `' '' - convert to degrees-min-sec - UC - ' or Q
  1116. OR - logical OR - UC - H
  1117. PI - pi 3.14... - KCO - ~ or z
  1118. Pol - convert to polar - BC - p
  1119. r - correlation of x,y - KL - v
  1120. RAD - convert degrees to radians - UC - K
  1121. Rec - convert to rectangular - BC - P
  1122. RND# - random number between 0 and 1 - KCO - #
  1123. SIN - sine of x - UCO - s
  1124. SINH - hyper sine of x - UC - j
  1125. SQR - square root of x - UCO - r
  1126. STD - standard deviation of x - KSO - [
  1127. SURF - calculate surface in LR memory - KL - Z
  1128. TAN - tangents of x - UCO - t
  1129. TANH - hyper tangents of x - UC - k
  1130. VAR - variation of x - KSO - V
  1131. X! - factorial of x - UC - !
  1132. X^ - estimate x - UL - X
  1133. X^Y - x to the power of y - BC - x
  1134. XSQR - x th root of y - BC - q
  1135. X^2 - square of x - UCO - R
  1136. Y^ - estimate y - UL - Y
  1137. XOR - logical XOR operation - UC - w
  1138. <- - convert degrees-min-sec to degrees - UC - b
  1139.  
  1140. Characteristics: 
  1141. U = unary function 
  1142. B = binary function 
  1143. C = available in COMPute mode
  1144. L = available in LR mode
  1145. S = available in SD mode
  1146. O = standard CALC/OPL function
  1147. K = constant (no argument)
  1148.  
  1149.  
  1150. 11.2  Keyboard reference
  1151. ========================
  1152.  
  1153. Menu
  1154. Display menu
  1155.  
  1156. Control-A .. Control-Z
  1157. Select active memory  M
  1158.  
  1159. Psion-Control-A .. Z
  1160. Store number to memory  M
  1161.  
  1162. Shift-Control-A .. Z
  1163. Load number from memory M
  1164.  
  1165. Help
  1166. Display help
  1167.  
  1168. Diamond
  1169. Execute external math function in ADDON.OPO
  1170.  
  1171. Left-arrow
  1172. Recall previously entered number or result in 
  1173. recall buffer
  1174.  
  1175. Right-arrow
  1176. Recall next entered number or result in recall 
  1177. buffer
  1178.  
  1179. Up-arrow
  1180. Store number to active memory
  1181.  
  1182. Dn-arrow or Psion-M
  1183. Load number from active memory
  1184.  
  1185. PgUp
  1186. Select previous page with 60 buttons
  1187.  
  1188. PgDn
  1189. Select next page with 60 buttons
  1190.  
  1191. Psion-Q
  1192. Set preferences
  1193.  
  1194. Psion-X
  1195. Terminate Calc3a application
  1196.  
  1197. Psion-*
  1198. Clear active memory
  1199.  
  1200. Psion-F
  1201. Alter display format (GEN/SCI/FIX/OCT/BIN/HEX)
  1202.  
  1203. Psion-T
  1204. Alter trigonometric mode (RAD/DEG)
  1205.  
  1206. Psion-C
  1207. Alter calculation mode (SD/LR/COMP)
  1208.  
  1209. Psion-R
  1210. Register your copy of Calc3a
  1211.  
  1212. Psion-E
  1213. Edit memory M
  1214.  
  1215. Psion-Y
  1216. Edit statistics memory
  1217.  
  1218. Psion-O
  1219. Octal mode
  1220.  
  1221. Psion-D
  1222. Decimal mode (GEN)
  1223.  
  1224. Psion-B
  1225. Binary mode
  1226.  
  1227. Psion-H
  1228. Hexadecimal mode
  1229.  
  1230. Psion-/
  1231. Bring
  1232.  
  1233. Psion-J
  1234. Plot settings
  1235.  
  1236. Psion-K
  1237. Execute XY plot
  1238.  
  1239. Psion-S
  1240. Show recall buffer
  1241.  
  1242. Psion-+
  1243. MAIN: Add number to active memory
  1244. PLOT: Enlarge visor
  1245.  
  1246. Psion--
  1247. MAIN: Subtract number from memory
  1248. PLOT: Enlarge visor
  1249.  
  1250. Psion-U
  1251. Edit equation
  1252.  
  1253. Psion-L
  1254. Evaluate equation
  1255.  
  1256. Psion-Z
  1257. List all registered external functions
  1258.  
  1259. Psion-G
  1260. Export memories
  1261.  
  1262. Psion-A
  1263. Display about screen
  1264.  
  1265. Psion-I
  1266. Constants list
  1267.  
  1268. Tab
  1269. Toggle decimal places 0..20
  1270.  
  1271. Delete
  1272. Delete entered digit
  1273.  
  1274. e
  1275. Exponential
  1276.  
  1277. Esc
  1278. Clear
  1279.  
  1280. Shift-Esc
  1281. Clear statistics memory
  1282.  
  1283. = or Enter
  1284. Execute binary calculation
  1285.  
  1286. %
  1287. Execute percentage calculations
  1288.  
  1289. 11.3 List of external functions
  1290. ===============================
  1291.  
  1292. Func.  Description                  Type Shortcut
  1293. --------------------------------------------------
  1294. gLOG   g-base logarithm of x          BC Diamond-g
  1295. VecL   length of vector 0,0 to x,y    BC Diamond-v
  1296. Poly   length of polyline             UR Diamond-p
  1297. KeyC   key and modifier code          K  Diamond-k
  1298. dBlist sum dB numbers in stat memory  UL Diamond-d
  1299.  
  1300. Characteristics:
  1301. U = unary function
  1302. B = binary function
  1303. C = available in COMPute mode
  1304. L = available in LR mode
  1305. S = available in SD mode
  1306. O = standard CALC/OPL function
  1307. K = constant (no argument)
  1308.  
  1309. 11.4 With special thanks to ...
  1310. ===============================
  1311. * Wolfgang Schirmer, for testing the software;
  1312. * Mark Paulhus, for checking the manual and 
  1313.   help texts;
  1314. * Tim Richardson and Daron Brewood, for 
  1315.   distributing Calc3a on internet and other
  1316.   highways;
  1317. * Angelique (my girlfriend) with her endless 
  1318.   patience.
  1319.