Calc3a Scientific Calculator for Psion Series 3a [$10 shareware]
Version V1.5.7 [04/12/96]
Index
=====
1. CONTACT INFORMATION
2. OVERVIEW OF PROGRAM
3. HOW TO REGISTER
4. INSTALLING CALC3A
4.1 DISTRIBUTION
4.2 HOW TO INSTALL
4.3 REQUIREMENTS
5. GENERAL
5.1 CALCULATOR MAIN SCREEN
5.2 USING HELP
5.3 USING MENUS
5.4 PREFERENCES
6. CALCULATIONS
6.1 GETTING STARTED
6.2 FUNCTIONS
6.2.1 Functions with two results
6.2.2 Functions with temporary results
6.2.3 Percentage calculations
6.3 CALCULATION EXAMPLES
6.4 MEMORIES
6.4.1 Statistics memories
6.4.2 Calculator memories
6.4.3 Recall buffer
6.4.4 Export of memories
7. EQUATIONS
7.1 THE EQUATION DATABASE
7.2 INPUT OF EQUATIONS
7.3 DELETE EQUATIONS
7.4 EVALUATING EQUATIONS
8. SOLVER
8.1 THE EQUATION DATABASE
8.2 SOLVING EQUATION
9. XY PLOT
9.1 PLOT SETTINGS
9.2 EXECUTE XY PLOT
9.2.1 Trace mode
10. CONSTANTS
11. INTEGRATE
12. EXTERNAL MATH FUNCTIONS
13. DISCLAIMER
14. APPENDICES
14.1 FUNCTION REFERENCE
14.2 KEYBOARD REFERENCE
14.3 FUNCTIONS IN ADDON
14.4 EQUATION CONVERTER
1 CONTACT INFORMATION
=====================
The author can be reached by mailing to:
Alfa Computing
Richard Schmidt
Richard Sturenberghlaan 50
2273 GX VOORBURG
THE NETHERLANDS (EUROPE)
Email @ Compuserve : 100735,331
Email @ Internet : rschmidt@worldonline.nl
Home page : http://www.worldonline.nl/~rschmidt/
2. OVERVIEW OF PROGRAM
======================
Welcome to Calc3a!
Calc3a is a scientific calculator for the Psion
Series 3a. It operates similar to a CASIO(c) FX
or SHARP(c) style calculator and has
approximately 60 built-in math functions. Calc3a
has been set up to be just like a physical
calculator. It has an LCD display and tiny buttons
which can be accessed with single keystrokes.
Calc3a is only available in English for the Psion
Series 3a.
3 HOW TO REGISTER
=================
Possible ways to register:
- use SwReg on compuserve to register online
SWReg id : 7171
Product : Calc3a
Online registration is $10
- send $10 cash in envelope to my postal address
(ALL CURRENCY ALLOWED !)
4. INSTALLING Calc3a
====================
Before using the Calc3a application you should
install it from your PC to your Psion.
4.1 Distribution
================
An unregistered copy of this application may be
distributed freely. The Calc3a application itself
consists of the following files:
CALC3A.OPA Main application
CALC3A01.RSC Help screens
CALC3A02.RSC Equation evaluator module
CALC3A03.RSC XY Plot module
CALC3A04.RSC Application resources
ADDON.OPL Example code for external math
functions
ADDON.OPO Compiled version of ADDON.OPL
CALC3A.EQN Database with example equations
only for use with decimal
separator set to period.
MANUAL.TXT This manual
EQNCONV.OPO Utility to convert period based
4.2 How to install
==================
To install Calc3a:
- start RCOM or MCLINK;
- connect and switch on Psion link in system
screen with Psion-L;
- copy file CALC3A.OPA to an \APP directory on
any disk
- copy files CALC3A01.RSC, CALC3A02.RSC,
CALC3A03.RSC and CALC3A04.RSC to an
\APP\CALC3A directory on any disk.
- optionally copy file ADDON.OPO to an \OPO
directory and ADDON.OPL to an \OPL directory on
any disk. This is only needed when you want to
add you own math functions to the program.
- optionally copy file CALC3A.EQN to an \OPD
directory on your default disk. This is only
needed when you want to use/try the enclosed
example equations and has a period selected
as decimal separator (in the system screen).
- Install the Calc3a application in the system
screen by pressing Psion-I.
Make sure you have an \OPD directory on your
default drive. Calc3a will save its
configuration to \OPD\CALC3A.INI. For easy use of
the program, assign the CALC button to the
program by pressing Psion-A.
4.3 Requirements
================
The application requires 90K RAM memory and
approximately 80K ram of disk space. If your
machine appears to be out of memory try to close
a few applications or erase files from internal
memory (after making a backup first!).
5. GENERAL
==========
5.1 Calculator main screen
===========================
After the application has been launched from the
system screen, the calculator main window
appears. The patterned grey bar on the top of the
screen contains two 'LCD displays'.
The left LCD display shows us the calculator
modes and the contents of the active memory. The
modes can be changed by keyboard or from the
pull-down menus.
Mode Description
--------------------------------------------------
Page PAGE_A First page with 60 buttons
PAGE_B Second page with 60 buttons
PAGE_C Third page with 60 buttons
(external functions)
Calculation COMP Compute mode, scientific
calculations
mode SD Statistics mode
LR Linear regression mode
Trigonometr. DEG Trigonometric. calculations
with degrees
mode RAD Trigonometric. calculations
with radians
Format GEN General format base-10 numbers
SCI Scientific format e.g.1.0E-12
FIX Fixed format, fixed number of
decimals
HEX Hexadecimal format base-16
numbers
BIN Binary format base-2 numbers
OCT Octal format base-8 numbers
ENG Engineering mode E-12 .. E12
(temporary mode)
Contents of active memory MA..MZ Memory 1 (A) up
to memory 26 (Z)
There are three keys available to switch these
modes:
- Psion-C, to alter calculation mode;
- Psion-T, to alter trigonometric mode;
- Psion-F, to alter display format;
- Shift-Psion-F, to alter display format in
reverse order.
Press these keys repeatedly to select the desired
mode.
To change directly to a base-n mode there are
four shortcut keys available:
- Psion-D switch/convert to decimal (base-10)mode;
- Psion-H switch/convert to hex (base-16) mode;
- Psion-O switch/convert to octal (base-8) mode;
- Psion-B switch/convert to binary (base-2) mode;
The last result or typed-in number on the LCD
screen will then automatically be converted to
the selected base-n equivalent. These four
shortcuts are also available in the menus. Press
the Menu key to display the top level menu.
The calculator has 26 memories to store numbers
and intermediate results. These memories are
called `MA' to `MZ'. The contents of the active
memory is always displayed on the left LCD. To
switch between these 26 memories press Control
and the memory identification character. e.g.
Control-C will select memory 3 (MC) and the
contents of this memory is displayed on the left
LCD. Please refer to chapter `Memories' to learn
more about these memories.
The right LCD display shows us calculation
results and numbers typed in by the user. If the
format is set to hexadecimal, binary or octal,
the displayed numbers are succeeded by a single
character where `b' stands for binary number, `o'
stands for octal number and `h' stands for
hexadecimal number. Negative numbers are preceded
by a negative (-) sign.
All buttons are displayed below the LCD
displays. Because of the large number of buttons,
they are divided over two pages. To switch
between the two pages press PgUp and PgDn.
5.2 Using help
==============
Press the Help button to bring up the help
index. Select an item you want to know more about
and press Enter. Press Esc to leave help and to
return to the main screen.
5.3 Using menus
===============
Press the Menu key to display the top level menu.
The plot module, equation database manager and
the main calculator application all have
different menus.
5.4 Preferences
===============
The preferences can be changed by bringing up the
`Set preferences' menu. This menu can be
accessed by pressing Psion-Q and has three items
`Keyboard', `Display' and `Modes'. After changing
the preferences they will be saved to disk.
Format
Select between display formats. There are six
formats available. The formats can also be
selected by pressing Psion-F or Shift-Psion-F
repeatedly. The formats HEXadecimal, OCTal,
BINary and GENeral can also be selected by
pressing the hot keys (Psion-H, Psion-O, Psion-B
and Psion-D) for these formats.
Decimals
Number of decimals to show for numbers on the
display. Press Tab repeatedly to select between 0
and 20 decimals.
Be aware that the number of decimals applies to
- representation of numbers on calculator display;
- representation of numbers in solver dialog;
- representation of numbers in evaluator dialog;
- representation of numbers in integrator dialog.
Trigonometric calculations
Select between trigonometric calculations with
degrees or radians. Math functions like SIN, TAN,
etc. require this mode to be set correctly.
Calculation mode
Select between three different calculation modes:
LR Linear regression mode, requires single
numbers as data;
SD Statistics mode, requires X,Y pairs of
data;
COMP Compute mode, usage of all scientific
functions.
Extra help mode
To display a help line after each calculation is
executed set this field to `On'. Immediately
after you have pressed Enter or = or an unary
function a help line is displayed in the lower
right corner of the screen. When the `Extra help
mode' is set to on, all dialog boxes used for
entering equations will show the equation
constraints.
Decimal separator
Select a comma or period as a decimal separator.
If the decimal separator has been altered, the
keyboard layout on the screen will be updated.
This setting must be equal to the one you set in
the system screen. So if you have chosen a
period as decimal separator in the system screen
(number format Shift-Psion-F) please select a
period in Calc3a application too!
To separate X- and Y-data in LR memory use the
period in case you use the comma as decimal
separator. Use the comma to separate if you use
the period as decimal separator.
Alternative keyboard
This option is only for users that have a Psion
with a German keyboard layout. This option swaps
some keys:
Function Non German German
--------------------------
PI ~ z
`"o ` Q
MIN ^ M
Parenthesis
Mode for closing parenthesis. Options are:
- calculate on close;
- wait for <Enter>.
6. CALCULATIONS
===============
6.1 Getting started
===================
After the application has been launched from the
system screen, the calculator main window
appears. The patterned grey bar on the top of the
screen contains two 'LCD displays'.
The left LCD display shows the trigonometric mode
(DEG or RAD), the calculation mode (SD, LR or
COMP), the format used to display numbers
(SCIentific, GENeral, FIXed, ENGineering,
HEXadecimal, BINary or OCTal) and the contents
the active memory M.
The right LCD display shows results of
calculations and numbers typed in by the user.
All calculator buttons can be 'pressed' with
single keystrokes. Each button is preceded by a
single upper or lowercase character. This
character can be used to activate a button and
thus a math function.
Calculations are performed just as you would with
a stand-alone calculator. Examples (<k> equals to
keystroke 'k')
Square root of 25 : 25<r>
10 to the power of 3 : 3<L>
2 to the power of 5 : 2<x>5<=>
Mean of 4,8,9,3,2 : 4<@>8<@>9<@>3<@>2<@><\>
25 div 4 : 25<d>4<=>
150+17.5% : 150<+>17.5<%>
10% of 1000 : 1000<*>10%
While typing in a number, press Delete to erase
the last digit typed . Esc clears all input. Press
the Help key in the Calc3a application to read
more about the usage of Calc3a.
6.2 Functions
==============
The calculator has approximately 60 built-in
functions. There are two types of functions:
1.Unary
Function applies to one number e.g. Square root of
x or Sine of x To perform an unary calculation,
first type in a number, than press a unary
function button. The result of this calculation
is shown at the right LCD display.
2.Binary
Function applies to two numbers e.g. 5+6 or x to
the power of y. To perform a binary calculation,
first type in the first number, than press a
binary function button (operator). Type in the
second number and press Enter. The result of this
calculation is shown at the right LCD display.
6.2.1 Functions with two results
================================
Some functions like POL() and REC() return two
results. After pressing the Enter key the result
of such a function will be shown at the lower
right corner of the screen for about two seconds.
The first result will also be shown at the
calculator LCD display. The second result is
stored in the recall buffer and can be accessed
by pressing the left-arrow key once.
6.2.2 Functions with temporary results
======================================
The function o`" (conversion degrees to
degrees-min-sec) returns a number in the form
of `degrees-minutes-seconds'. The result of
such a function will be displayed on the LCD
display until a key is pressed.
Please refer to appendix `functions' for more
about available math functions.
6.2.3 Percentage calculations
=============================
Calc3a allows for simple percentage calculations:
- add percentage;
- subtract percentage;
- calculate percentage.
A percentage calculation takes the following form:
<Amount><Operator><Percentage><%>
Operator/Description Example
--------------------------------------------------
+ Add percentage 100+15% >> 100<+>15<%> 115
- Subtract perc. 50-17.5% >> 50<->17.5<%> 41.25
* Calculate perc. 10% of 1000 >>10<*>1000<%> 100
6.3 Calculation examples
=========================
Below are some examples of several types of
calculations. Every example consists of three
parts:
1. Description of example
2. Math notation
3. keyboard strokes to perform calculations.
Do not type the '<' and '>' characters.
Square root of 100
SQR(100)
100<r>
Logarithm of 1000
LOG(1000)
1000<l>
Convert 10,50 polar to rectangular
REC(10,50)
10<P>50<Enter>
17.5% of 50
50*17.5%
50<*>17.5<%>
100 plus 50%
100+50%
100<+>50<%>
2 to the power of 8
2^8
2<x>8<Enter>
2 to the power of 8
2^8
8<y>
-1.0*5
NEG(5)
5<_>
Reciprocal value of sine of 50
1/SIN(50)
50<s><i>
Mean of 4.5, 6.7, 2.9 and 6.7
MEAN(4.5, 6.7, 2.9, 6.7)
Set calculator to SD mode
<Shift-Esc> (clear stat memory)
4.5<@>6.7<@>2.9<@>6.7<@><\>
Correlation factor r of
10,12
11,15
12,18
14,16
r(data)
Set calculator to LR mode
<Shift-Esc> (clear stat memory)
10<,>12<@>
11<,>15<@>
12<,>18<@>
14<,>16<@>
<v>
Convert 50 decimal to binary
BIN(50)
<Psion-D>
50
<Psion-B>
e (2.71....)
EXP(1)
1<N>
5-BASE log of 10
5LOG(10)
5<,>10<Diamond-key><g>
Function gLOG(x) is an external function in
ADDON.OPO. External functions require the
operands to be separated with a comma (or point
for German users).
6.4 Memories
============
6.4.1 Statistics memories
=========================
The program allows for statistics calculations. A
maximum of 1000 numbers can be stored in this
statistics memory to be used for calculations in
SD mode. Also 1000 x,y numbers can be stored in
this memory when performing LR calculations. It
is possible to change numbers in the statistics
memory. Press Psion-Y to bring up the `Edit
statistics memory' dialog. Press the left-arrow
and right-arrow keys to scroll through all
numbers in statistics memory. A message will be
shown if the statistics memory does not contain
numbers.
After changing one or more numbers in statistics
memory all statistic functions will use these new
numbers.
6.4.2 Calculator memories
=========================
Calc3a has 26 memories called MA..MZ. The M+
(Psion-+) and M- (Psion--) buttons can be used to
store numbers into these memories. These memories
have an initial value of 0. The current value of
the active memory M is displayed on the top left
LCD display.
Press Psion-E to change the contents of one of
the memories. Use the left-arrow and right- arrow
key to select a memory to modify.
6.4.3 Recall buffer
===================
The application maintains a 'recall' buffer. Each
entered number and calculation result will be
stored to this recall buffer. Press Psion-S to
scroll through all previously entered numbers. To
recall a previously entered number or result
press the left arrow or right arrow key. The
numbers will appear on the calculator LCD. The
recall buffer has room for 50 numbers.
6.4.4 Export of memories
========================
The contents of the memories, statistics memory
and recall buffer can be exported to a plain text
file. Press Psion-G to bring up the `Export'
dialog. It possible to select the export of: -
memories A..Z and/or - statistics memory and/or -
recall buffer.
The contents of the different memories are
written to a single text file. These files can be
used to import into a spreadsheet.
7. EQUATIONS
============
Calc3a allows for entering equations. These
equations are stored in a database called
\OPD\CALC3A.EQN. Equations in this database can
be evaluated or solved.
7.1 The equation database
=========================
It is possible to set up a database with all your
frequently used equations and conversion
formulas. Each equation is stored with a
description (max 30 characters). The equation
database manager (EDM) shows up each time you
want to evaluate or solve an equation.
The top frame of this dialog displays the number
of equations currently stored in the database and
the equation itself. This equation line is
updated each time you move the cursor over a new
equation.
The lower area of the dialog shows four buttons.
The `Evaluate' button is replaced by a `Solve'
button when solving equations. Keys available in
the EDM:
Up Move cursor one row up
Down Move cursor one row down
Pg-Up Move cursor one page up
Pg-Dn Move cursor one page down
Home Move cursor to first equation
End Move cursor to last equation
E or Psion-E Enter equation/description
selected with cursor
D or Psion-D Delete equation selected with cursor
or Delete
U or Psion-U Enter new equation
V or Psion-V Evaluate equation
or Enter
S or Psion-S Solve equation
or Enter
MENU Bring up the equation database
main menu
X or Psion-X Exit equation database and return to
or Esc main calculator
F or Psion-F Search for equation. Searches from
current cursor position to end of
database. Search is case sensitive.
G or Psion-G Find next occurrence
7.2 Input of equations
======================
Press Psion-U from the main calculator screen to
bring up the equation database. Select an
equation with the selection bar (cursor) and
press U or Psion-U to modify an equation or E or
Psion-E to enter a new equation.
The `Equation evaluator' dialog has two fields.
One is for the short description (30 characters)
used as an identification for the equation. The
`Equation' field contains the equation itself.
This equation may be 255 characters long.
[Notice the constraints!]
In equations you can use:
- Variables with names that only contain (a
maximum of 12) alphabetical characters. The
length of variable names is limited to 10
characters and must be entered lowercase;
- All OPL math functions as mentioned in the
Psion programming manual, function names must
always be entered uppercase; Parenthesis;
- Trigonometric functions, radians/degrees
depending on settings in system screen.
Available functions/constants for equations:
ABS(x) LN(x) EXP(x) +
ACOS(x) LOG(x) SIN(x) -
ASIN(x) MAX(a,b) SQR(x) *
ATAN(x) MEAN(a,b) STD(a,b) /
COS(x) MIN(a,b) TAN(x) 5E-5
DEG(x) RAD(x) SUM(a,b) x**y
INTFx) RND VAR(x)
7.3 Delete equations
====================
Press Psion-U from the main calculator screen to
bring up the equation database. To delete an
equation just move the cursor over the equation
and press Delete, Psion-D or just D.
7.4 Evaluating equations
========================
Press Psion-U from the calculator main screen to
evaluate an existing equation. Select an equation
from the EDM and press V or Psion-V to execute
the evaluator. The Variables/result' dialog is
shown on screen. All the variables used in your
equation will be shown in this dialog. If you
used more than four variables in your equation
use the left-arrow and right-arrow key to
view/enter the other variables.
Enter the contents of the variables and press
Enter. The result will be displayed in the same
dialog on the last line. To repeat an evaluation
just change a variable when desired and press
Enter.
If the equation was not entered correctly
(missing parenthesis, missing operators) a
message will be shown on screen and the result
will equal to 0.
8. SOLVER
=========
8.1 The equation database
=========================
The solver uses an equation from the equation
database. Please refer to chapter 5.1 for more
information about the equation database manager.
The solver allows for solving a single unknown
variable in an equation. Therefor it uses method
`Secant' to find a single solution.
8.2 Solving equation
====================
Press Psion-L from the calculator main screen to
solve an existing equation. Pick an equation from
the EDM and press S or Psion-S to start the
solver.
The Variables/result' dialog is shown on screen.
Enter the values of the known variables. If you
used more than four variables in your equation
use the left-arrow and right-arrow key to
view/enter the other variables. The variable to
be solved can be set to zero.
Press Enter to bring up the solver settings
dialog.
Unknown variable to solve
Press Tab on this field to view all variables
used in your equation. Select the variable to be
solved from the list.
Tolerance
Tolerance in the result of the solving process.
The smaller the tolerance the more accurate
answers you get.
Maximum number of iterations
Maximum number of iterations to find the result.
Initial guess1/guess2
Two possible values for the unknown variable.
These two guesses form a X-range for the solver.
Please select an range as narrow as possible to
get accurate answers. The solver can be started
by pressing Enter. After a few seconds (depending
on the complexity of the equation) the result is
shown in the Variables/result dialog. If an error
occurs during the solve process the result will
always equal 0.
Note : Guess1<Guess2
9. XY plot
==========
Two functions can be plotted on the screen at a
time. After the functions have been plotted it is
possible to move a cursor around the screen to
determine points of intersection.
9.1 Plot settings
=================
The plot settings must be set before making a
plot. Three dialogs will lead you through the
plot settings. All plot settings will be saved to
disk automatically. The first dialog is for
setting the axis options.
Scale
It is possible to select a linear or logarithmic
scale for the X-axis and Y-axis. Only positive
logarithmic scales are allowed for.
X tick/Y tick
A tick is a position marker on the axis. Tick can
be used for measuring and can only be used in
linear scaled plots. In logarithmic plots the
tick will be determined automatically.
Show labels in X-direction/
Show labels in Y-direction
Use this option to show values along the X- and
Y-axis. Labels can be plotted above or below the
X-axis and to the left or right of the Y-axis.
Show grid lines
Grid lines are lines drawn on each tick on the
axis and can also be used for measuring.
Show intersection points
Use this option to plot a point on all evaluated
X,Y position.
Plot line between intersection points
Use this option to plot a line between the
evaluated X,Y points.
The second dialog is used to set the plot range
Xmin, Ymin, Xmax, Ymax
Range for XY plot. These values are used for :
- drawing the axis;
- a range for x necessary to evaluate the
function.
X step evaluator
Step for x to evaluate the equations. So if the
range is set from -5 to 5 and step is set to 0.5
the equation will be (5--5)/0.5 = 20 times
evaluated. The following points will be
calculated : f(-5), f(-4.5), f(-4), f(-3.5),
f(-3), f(-2.5) .. f(5). The step value must be in
range 0.001-1000.
The third dialog queries two equations.
Function f(x)/g(x)=
The equation for plotting. Two functions can be
plotted at a time using the same scale. The
equations may be 30 characters long.
In equations you can use:
- Only variable `x' (lowercase) can be used in
equations;
- All OPL math functions as mention in the Psion
programming manual, function names must always
be entered uppercase;
- Parenthesis;
- Trigonometric functions, radians/degrees
depending on settings in system screen.
To plot only one function leave the other
function field blank. If the equation was not
entered correctly (missing parenthesis, missing
operators) it will be drawn as f(x)=0.
Plot
This dialog also allows for selecting f(x) and/or
g(x) from the equation database. Use tab to
select between selecting only f(x) and/or g(x) or
plot functions as specified in the f(x) and g(x)
fields. The EDM dialog appears for selecting an
equation when you choose to select at least one
equation. Insure that the selected equation
contains only one variable named 'x' for correct
plotting.
See "equations" for available functions.
9.2 Execute XY plot
===================
Press Psion-K to plot the two functions according
to the plot settings.
The cursor can be used to determine intersection
points or points on the graphs. To move this
cursor around:
Left move cursor to left
Right move cursor to right
Control-Left move cursor to left in
big steps
Control-Right move cursor to right in
big steps
Shift-Control-Left move cursor to left in
huge steps
Shift-Control-Right move cursor to right in
huge steps
Psion-+ Enlarge visor
Psion-- Reduce visor
Press any key to interrupt plotting.
Press Menu to display the top level menu of the
plot module. Psion-J can be used to alter plot
settings. To redraw the plot with new settings
press Psion-K. To return to the calculator main
screen press Psion-X or Esc.
9.2.1 Trace mode
================
The cursor can be set to `Trace' function f(x)
or function g(x).
Each time the cursor is moved in the X-
direction, the program recalculates F(x) and
positions the cursor on the calculated Y-
position on the curve.
10. CONSTANTS
=============
Calc3a allows for 10 numeric constants to be
defined. Press Psion-I to bring up the constants
dialog. First select the constant (C0..C9) to
edit or paste.
Select paste to paste constant to calculator, use
edit to modify selected constant.
11. INTEGRATE
=============
This function can be used to integrate functions
according to simpsons rule.
After pressing Psion-N two dialogs are presented.
The first dialog allows for entering f(x)dx.
It is also possible to select an equation from
the equation database. Use tab on the second field
to select between f(x)dx as specified in the
f(x)dx field or selecting an equation from
database.
In case of selecting from database the EDM dialog
appears. Insure that selected equation contains
only one variable named 'x' for correct
integrating.
Secondly the 'integrate - result' dialog is shown
on screen.
Number of samples
Number of samples to be used for calculating
X min/X max
Range for integrating f(Xmin) .. f(Xmax)
The integrator can be started by pressing Enter.
After a few seconds (depending on the complexity
of the equation) the result is shown in the
'Integrate - result' dialog.
Note : X max>X min
12. EXTERNAL MATH FUNCTIONS
==========================
The Calc3a application allows for external math
functions to be accessed in a OPO file. Enclosed
with this package is an example OPL file that
illustrates the usage of external OPL functions.
In this file the procedure `Register()' must
always be available. This function is used by
Calc3a to determine what functions are available
in the external OPO file and what hotkey must be
used to access that particular function. There
are several procedures available for interfacing
with the Calc3a application. So, for each added
function you must add a RegFunc- entry to the
`Register()' procedure. Please refere to ADDON.OPL
for more information.
External functions may contain all OPL commands
including dialogs. Please refer to ADDON.OPL for
more information. If this information is
insufficient, contact the author for more
information about using external functions.
Press Psion-Z or select PAGE_C to view all
external functions.
13 DISCLAIMER
=============
The author takes no responsibility for any lost
data or hardware malfunctions of any kind due to
the use of this software or any other software
that ships with Calc3a.
14. APPENDICES
==============
14.1 Function reference
=======================
+dB - add dB (decibel) - UC - B
1/X - reciprocal of x - UC - i
10^X - ten to the power of x - UCO - L
2^X - two to the power of x - UC - y
A - constant term of regression a - KL - A
ABS - absolute of x - UCO - a
ACOS - inverse cosine of x - UCO - C
AND - logical AND - UC - G
ASIN - inverse sine of x - UCO - S
ATAN - inverse tangents of x - UCO - T
B - regression coefficient b - KL - W
COS - cosine of x - UCO - c
COSH - hyper cosine of x - UCO - h
COTG - cotangents of x - UC - g
dB - convert to decibel - UC - D
DEG - convert radians to degrees - UC - J
DIV - integer division - BC, - d
EXP - e to the power of x - UCO - N
Erg - convert to energetic - UC - E
EX - sum of x - KSO - u
Ex^2 - sum of square of x - KS - U
FRAC - fractal part of x - UC - f
INT - integer part of x - UCO - I
LN - natural logarithm of x - UCO - n
LOG - logarithm of x - UCO - l
MAX - lowest value of x - KSO - &
MEAN - mean of x - KSO - \
MIN - lowest value of x - KSO - ^ or M
MOD - modulo - BC - m
n - number of statistics data in memory - KS - ;
nCr - combinations - BC - o
nPr - permutations - BC - O
NEG - negative - UC - _
NOT - logical NOT - BC - F
`' '' - convert to degrees-min-sec - UC - ' or Q
OR - logical OR - UC - H
PI - pi 3.14... - KCO - ~ or z
Pol - convert to polar - BC - p
r - correlation of x,y - KL - v
RAD - convert degrees to radians - UC - K
Rec - convert to rectangular - BC - P
RND# - random number between 0 and 1 - KCO - #
SIN - sine of x - UCO - s
SINH - hyper sine of x - UC - j
SQR - square root of x - UCO - r
STD - standard deviation of x - KSO - [
SURF - calculate surface in LR memory - KL - Z
TAN - tangents of x - UCO - t
TANH - hyper tangents of x - UC - k
VAR - variation of x - KSO - V
X! - factorial of x - UC - !
X^ - estimate x - UL - X
X^Y - x to the power of y - BC - x
XSQR - x th root of y - BC - q
X^2 - square of x - UCO - R
Y^ - estimate y - UL - Y
XOR - logical XOR operation - UC - w
<- - convert degrees-min-sec to degrees - UC - b
Characteristics:
U = unary function
B = binary function
C = available in COMPute mode
L = available in LR mode
S = available in SD mode
O = standard CALC/OPL function
K = constant (no argument)
14.2 Keyboard reference
========================
Menu
Display menu
Control-A .. Control-Z
Select active memory M
Psion-Control-A .. Z
Store number to memory M
Shift-Control-A .. Z
Load number from memory M
Help
Display help
Diamond
Execute external math function in ADDON.OPO
Left-arrow
Recall previously entered number or result in
recall buffer
Right-arrow
Recall next entered number or result in recall
buffer
Up-arrow
Store number to active memory
Dn-arrow or Psion-M
Load number from active memory
PgUp
Select previous page with 60 buttons
PgDn
Select next page with 60 buttons
Psion-Q
Set preferences
Psion-X
Terminate Calc3a application
Psion-*
Clear active memory
Psion-F
Alter display format (GEN/SCI/FIX/ENG/OCT/BIN/HEX)
Shift-Psion-F
Alter display format reverse order
Psion-T
Alter trigonometric mode (RAD/DEG)
Psion-C
Alter calculation mode (SD/LR/COMP)
Psion-R
Register your copy of Calc3a
Psion-E
Edit memory M
Psion-Y
Edit statistics memory
Psion-O
Octal mode
Psion-D
Decimal mode (GEN)
Psion-B
Binary mode
Psion-H
Hexadecimal mode
Psion-/
Bring
Psion-J
Plot settings
Psion-K
Execute XY plot
Psion-S
Show recall buffer
Psion-+
MAIN: Add number to active memory
PLOT: Enlarge visor
Psion--
MAIN: Subtract number from memory
PLOT: Enlarge visor
Psion-U
Edit equation
Psion-L
Evaluate equation
Psion-Z
List all registered external functions
Psion-G
Export memories
Psion-A
Display about screen
Psion-I
Constants list
Psion-N
Integrate
Tab
Toggle decimal places 0..20
Delete
Delete entered digit
e
Exponential
Esc
Clear
Shift-Esc
Clear statistics memory
= or Enter
Execute binary calculation
%
Execute percentage calculations
14.3 FUNCTIONS IN ADDON
=======================
gLOG
g-base logarithm of x
Hotkey: Diamond-g
VecL
length of vector 0,0 to x,y
Hotkey: Diamond-v
Poly
length of polyline, all x,y pairs must be
available in LR memory
Hotkey: Diamond-p
KeyC
key and modifier code
Hotkey: Diamond-k
dBlist
sum dB numbers in stat memory, dB values
must be available in SD memory
Hotkey: Diamond-d
Interst
Interest rate calculation, after the calculation
all amounts and corresponding year numbers are in
LR memory
Hotkey: Diamond-i
14.4 EQUATION CONVERTER
=======================
The supplied equation database CALC3A.EQN is
based on a period as decimal separator. If
you use a comma als decimal separator, the
evaluation of equations in the database
will not work.
EQNCONV can be used to convert a period based
equation database to a comma based one.
copy EQNCONV.OPO to your \OPO\ directory, start
eqnconv and follow the instructions.