alibCumSum
Returns the cumulative sum over one dimension of an array. The PV-WAVE API for this routine is the
CUMSUM Function.
Prototypes
void alibCumSumi( wvlong m, wvlong n, wvlong *d, int *p, int *q )
void alibCumSuml( wvlong m, wvlong n, wvlong *d, wvlong *p, wvlong *q )
void alibCumSumf( wvlong m, wvlong n, wvlong *d, float *p, float *q )
void alibCumSumd( wvlong m, wvlong n, wvlong *d, double *p, double *q )
Parameters
m — (Input) The dimension >=0 along which elements are cumulatively summed. In a vector or matrix for example, set m=0 to cumulatively sum over the vector or over each column of the matrix, or set m=1 to cumulatively sum over each row of the matrix.
n — (Input) The number of dimensions in the source array.
*d — (Input) The n-element array of dimensions for the source array.
*p — (Input) The n-dimensional source array of dimensions d.
*q — (Input/Output) The destination array. On output, array q contains the cumulative sum over each 'column' along dimension m, and so it has the same dimensions as array p. Computations are in the data-type of arrays p and q, so the integer types are subject to overflow without warning.
Example
#include <stdio.h>
#include <stdlib.h>
#include <math.h>
#include "alib.h"
void main() { /* arrays of dimensions to use for all the examples */
wvlong dm[3]={4,3,2}; /* source data for all the examples */
int i0[24];
/* output array to use for all the examples */
int i[24];
/* initialize the source data */
alibinit( NULL, NULL, NULL, NULL );
alibIndexi( 24, 0, 1, i0 );
printf( "\n\n show a 4-element vector" );
alibPrintArrayi( 1, 1, 1, 4, i0, NULL );
printf( "\n\n show the cumulative sum over the vector" );
alibCumSumi( 0, 1, dm, i0, i );
alibPrintArrayi( 1, 1, 1, 4, i, NULL );
printf( "\n\n show a (4,3) matrix" );
alibPrintArrayi( 1, 1, 4, 3, i0, NULL );
printf( "\n\n show cumulative sum over dim 0, i.e. over each column" );
alibCumSumi( 0, 2, dm, i0, i );
alibPrintArrayi( 1, 1, 4, 3, i, NULL );
printf( "\n\n show cumulative sum over dim 1, i.e. over each row" );
alibCumSumi( 1, 2, dm, i0, i );
alibPrintArrayi( 1, 1, 4, 3, i, NULL );
printf( "\n\n show a (4,3,2) array" );
alibPrintArrayi( 1, 4, 3, 2, i0, NULL );
printf( "\n\n show the cumulative sum over dimension 0" );
alibCumSumi( 0, 3, dm, i0, i );
alibPrintArrayi( 1, 4, 3, 2, i, NULL );
printf( "\n\n show the cumulative sum over dimension 1" );
alibCumSumi( 1, 3, dm, i0, i );
alibPrintArrayi( 1, 4, 3, 2, i, NULL );
printf( "\n\n show the cumulative sum over dimension 2" );
alibCumSumi( 2, 3, dm, i0, i );
alibPrintArrayi( 1, 4, 3, 2, i, NULL );
}
Output:
show a 4-element vector
0 1 2 3
show the cumulative sum over the vector
0 1 3 6
show a (4,3) matrix
0 1 2
3 4 5
6 7 8
9 10 11
show cumulative sum over dim 0, i.e. over each column
0 1 2
3 5 7
9 12 15
18 22 26
show cumulative sum over dim 1, i.e. over each row
0 1 3
3 7 12
6 13 21
9 19 30
show a (4,3,2) array
0 1
2 3
4 5
6 7
8 9
10 11
12 13
14 15
16 17
18 19
20 21
22 23
show the cumulative sum over dimension 0
0 1
2 3
4 5
6 8
10 12
14 16
18 21
24 27
30 33
36 40
44 48
52 56
show the cumulative sum over dimension 1
0 1
2 4
6 9
6 7
14 16
24 27
12 13
26 28
42 45
18 19
38 40
60 63
show the cumulative sum over dimension 2
0 1
2 5
4 9
6 13
8 17
10 21
12 25
14 29
16 33
18 37
20 41
22 45
Version 2017.0
Copyright © 2017, Rogue Wave Software, Inc. All Rights Reserved.