DADiSP Online Help

Click here to see this page in full context

VSUMS

Purpose:

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

Syntax:

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

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