Preview Version of Multi-Dimensional Speakeasy Now Available

Read on to see how easy it is to use.

The Syntax of Speakeasy V Alpha

Vocabulary

Preview

Syntax

Speakeasy operations will continue to function as they have in the past with no change in syntax.

The syntax for defining a multi-dimensional object in Speakeasy V Alpha is simply an extension of the syntax of previous Speakeasy releases. For example, a 4-dimensional array may be defined by the statement:

:_a4dim = array( 2,4,6,8 : integers(1,384) )

The binary arithmetic of Speakeasy has been expanded to perform the appropriate operation on multi-dimensional objects.

A multi-dimensional object is printed by planes. For example, a 3-dimensional array is defined and printed as shown below.

:_a3dim = array(2,3,4 : integers(1,24) ) :_print a3dim
A3DIM (A 2 by 3 by 4 Array)
Plane 1 :
1	2	3	4
5	6	7	8
9	10	11	12
Plane 2:
13	14	15	16
17	18	19	20
21	22	23	24

To use an operation with a multi-dimensional object, new syntax has been implemented. For example:

:_ x = array( 2,3,4 : integers(1,24) )
:_sum(x)
SUM(X) = 300

If summing over a specific dimension, or dimensions, is desired, then the following syntax should be used:

sum( x : dim1, dim2, ...)

or,

sum( x : OVER dim1, dim2, ...)

Continuing the above example,

:_whatis x
X is a 2 by 3 by 4 REAL ARRAY.
:_sum( x : over 1 )
SUM( X : OVER 1 ) (a 3 by 4 Array)
14	15	18	20
22	24	26	28
30	32	35	36

demonstrates that summing a 2 by 3 by 4 array over the first dimension results in a 3 by 4 array.

Another example can show the correspondence between the new syntax and the old.

:_x = array( 2,3 : integers(1,6) )
:_print x
X (A 2 by 3 Array)
1	2	3
4	5	6
:_sum( x : over 1 )
SUM( X : OVER 1 ) (A 3 Component Array)
5	7	9
:_sumcols( x )
SUMCOLS( X ) (A 3 Component Array)
5	7	9

As can be seen from the above example, summing over the first dimension is equivalent to summing the columns.

The multi-dimensional syntax for any given operation, can be found in the Help document for that specific operation.

Top

Vocabulary

The following is a list of Speakeasy's vocabulary which has been upgraded for multi-dimensional support.

AVERAGE	CUMSUMCO	MAXOFCOL	NEUMANN	STANDDEV	THREEJ
BESSEL	CUMSUMRO	MAXOFROW	PROD	STANDERR	TSLOCMAX
BESSELN	KURTOSIS	MEAN	PRODCOLS	SUM	TSLOCMIN
CLEBSCH	LOCMAX	MEANABSD	PRODROWS	SUMCOLS	VARIANCE
CUMPROD	LOCMIN	MIN	RMS	SUMROWS
CUMPRODC	MAD	MINIMUM	SKEWNESS	SUMSQ
CUMPRODR	MAXIMUM	MINOFCOL	SPHBES	SUMSQCOL
CUMSUM	MAX	MINOFROW	SPHBESN	SUMSQROW

More Speakeasy operations will come in future upgrades.

If you find that Speakeasy operations not on the above list would be of benefit to you, please contact us and let us know. It is through user feedback that we will determine priorities for upgrading the Speakeasy operations.

Top