DADiSP Worksheet Functions > Function Categories > Series and Scalar Math > VSUMS

 

VSUMS

Purpose:

Returns the point by point sum of one or more input arguments.

Syntax:

VSUMS(val1, val2, ..., valN)

valN

-

One or more series or scalars.

Returns:

A series, the point by point sum of the input values.

Example:

vsums(10, 15, 20)

 

returns the single point series {45}.

Example:

W1: vavgs({1, 2, 3, 4, 5}, {1, 4, 2}, {1, 0, 3, 8})

 

W1 == {3, 6, 8, 12, 5}

Example:

W1: ravel(1..9, 3)

W2: ravel(11..26, 4)

W3: vsums(W1, W2)

 

W1 == {{1, 4, 7},

       {2, 5, 8},

       {3, 6, 9}}

 

W2 == {{11, 15, 19, 23},

       {12, 16, 20, 24},

       {13, 17, 21, 25},

       {14, 18, 22, 26}}

 

W3 == {{12, 19, 26, 23},

       {14, 21, 28, 24},

       {16, 23, 30, 25},

       {14, 18, 22, 26)}

Example:

W1: ravel(1..9, 3)

W2: {1}

W3: sums(W1, W2)

W4: vsums(W1, W2)

 

W1 == {{1, 4, 7},

       {2, 5, 8},

       {3, 6, 9}}

 

W2 == {1}

 

W3 == {{2, 5, 8},

       {2, 5, 8},

       {3, 6, 8}}

 

W4 == {{2, 4, 7},

       {2, 5, 8},

       {3, 6, 8}}

 

Unlike SUMS, VSUMS does not promote series with a single row.

Remarks:

VSUMS requires at least one input argument.

 

VSUMS always returns a series.

 

Non-numeric arguments are ignored.

 

Unlike SUMS, single row series are preserved, the single row value is not duplicated across each column.

 

See SUM or VSUM to compute the scalar sum of the input values.

 

See AVGS or VAVGS to compute the point by point mean of the input values.

See Also:

AVGS

MEAN

SUMS

VAVGS

VMAX

VMEAN

VMIN

VSUM