1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
|
//------------------------------------------------------------------------------
// GxB_Matrix_eWiseUnion: matrix element-wise operations, set union
//------------------------------------------------------------------------------
// SuiteSparse:GraphBLAS, Timothy A. Davis, (c) 2017-2022, All Rights Reserved.
// SPDX-License-Identifier: Apache-2.0
//------------------------------------------------------------------------------
// C<M> = accum (C,A+B) and variations.
// if A(i,j) and B(i,j) both appear:
// C(i,j) = add (A(i,j), B(i,j))
// else if A(i,j) appears but B(i,j) does not:
// C(i,j) = add (A(i,j), beta)
// else if A(i,j) does not appear but B(i,j) does:
// C(i,j) = add (alpha, B(i,j))
// by contrast, GrB_eWiseAdd does the following:
// if A(i,j) and B(i,j) both appear:
// C(i,j) = add (A(i,j), B(i,j))
// else if A(i,j) appears but B(i,j) does not:
// C(i,j) = A(i,j)
// else if A(i,j) does not appear but B(i,j) does:
// C(i,j) = B(i,j)
#include "GB_ewise.h"
#include "GB_get_mask.h"
#define GB_EWISE(op) \
/* check inputs */ \
GB_RETURN_IF_NULL_OR_FAULTY (C) ; \
GB_RETURN_IF_NULL_OR_FAULTY (A) ; \
GB_RETURN_IF_NULL_OR_FAULTY (B) ; \
GB_RETURN_IF_FAULTY (M_in) ; \
/* get the descriptor */ \
GB_GET_DESCRIPTOR (info, desc, C_replace, Mask_comp, Mask_struct, \
A_tran, B_tran, xx, xx7) ; \
/* get the mask */ \
GrB_Matrix M = GB_get_mask (M_in, &Mask_comp, &Mask_struct) ; \
/* C<M> = accum (C,T) where T = A+B, A'+B, A+B', or A'+B' */ \
info = GB_ewise ( \
C, C_replace, /* C and its descriptor */ \
M, Mask_comp, Mask_struct, /* mask and its descriptor */ \
accum, /* accumulate operator */ \
op, /* operator that defines '+' */ \
A, A_tran, /* A matrix and its descriptor */ \
B, B_tran, /* B matrix and its descriptor */ \
true, /* eWiseAdd */ \
true, alpha, beta, /* eWiseUnion */ \
Context) ;
//------------------------------------------------------------------------------
// GxB_Matrix_eWiseUnion: matrix addition
//------------------------------------------------------------------------------
GrB_Info GxB_Matrix_eWiseUnion // C<M> = accum (C, A+B)
(
GrB_Matrix C, // input/output matrix for results
const GrB_Matrix M_in, // optional mask for C, unused if NULL
const GrB_BinaryOp accum, // optional accum for Z=accum(C,T)
const GrB_BinaryOp add, // defines '+' for T=A+B
const GrB_Matrix A, // first input: matrix A
const GrB_Scalar alpha,
const GrB_Matrix B, // second input: matrix B
const GrB_Scalar beta,
const GrB_Descriptor desc // descriptor for C, M, A, and B
)
{
//--------------------------------------------------------------------------
// check inputs
//--------------------------------------------------------------------------
GB_WHERE (C, "GxB_Matrix_eWiseUnion (C, M, accum, add, A, alpha,"
" B, beta, desc)") ;
GB_BURBLE_START ("GxB_eWiseUnion") ;
GB_RETURN_IF_NULL_OR_FAULTY (add) ;
//--------------------------------------------------------------------------
// apply the eWise kernel (using set union)
//--------------------------------------------------------------------------
GB_EWISE (add) ;
GB_BURBLE_END ;
return (info) ;
}
|
