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
|
//------------------------------------------------------------------------------
// GxB_Vector_eWiseUnion: vector element-wise operations, set union
//------------------------------------------------------------------------------
// SuiteSparse:GraphBLAS, Timothy A. Davis, (c) 2017-2025, All Rights Reserved.
// SPDX-License-Identifier: Apache-2.0
//------------------------------------------------------------------------------
// w<M> = accum (w,u+v)
// if u(i) and v(i) both appear:
// C(i,j) = add (u(i), v(i))
// else if u(i) appears but v(i) does not:
// C(i,j) = add (u(i), beta)
// else if u(i) does not appear but v(i) does:
// C(i,j) = add (alpha, v(i))
#include "ewise/GB_ewise.h"
#include "mask/GB_get_mask.h"
//------------------------------------------------------------------------------
// GxB_Vector_eWiseUnion: vector addition
//------------------------------------------------------------------------------
GrB_Info GxB_Vector_eWiseUnion // w<M> = accum (w, u+v)
(
GrB_Vector w, // input/output vector for results
const GrB_Vector M_in, // optional mask for w, unused if NULL
const GrB_BinaryOp accum, // optional accum for z=accum(w,t)
const GrB_BinaryOp op, // defines '+' for t=u+v
const GrB_Vector u, // first input: vector u
const GrB_Scalar alpha,
const GrB_Vector v, // second input: vector v
const GrB_Scalar beta,
const GrB_Descriptor desc // descriptor for w and M
)
{
//--------------------------------------------------------------------------
// check inputs
//--------------------------------------------------------------------------
GB_RETURN_IF_NULL (w) ;
GB_RETURN_IF_NULL (u) ;
GB_RETURN_IF_NULL (v) ;
GB_RETURN_IF_NULL (alpha) ;
GB_RETURN_IF_NULL (beta) ;
GB_RETURN_IF_NULL_OR_FAULTY (op) ;
GB_RETURN_IF_OUTPUT_IS_READONLY (w) ;
GB_WHERE6 (w, M_in, u, alpha, v, beta,
"GxB_Vector_eWiseUnion (w, M, accum, op, u, alpha, v, beta, desc)") ;
GB_BURBLE_START ("GxB_eWiseUnion") ;
ASSERT (GB_VECTOR_OK (w)) ;
ASSERT (GB_VECTOR_OK (u)) ;
ASSERT (GB_VECTOR_OK (v)) ;
ASSERT (M_in == NULL || GB_VECTOR_OK (M_in)) ;
// get the descriptor
GB_GET_DESCRIPTOR (info, desc, C_replace, Mask_comp, Mask_struct,
xx1, xx2, xx3, xx7) ;
// get the mask
GrB_Matrix M = GB_get_mask ((GrB_Matrix) M_in, &Mask_comp, &Mask_struct) ;
//--------------------------------------------------------------------------
// apply the eWise kernel (using set union)
//--------------------------------------------------------------------------
// w<M> = accum (w,t) where t = u+v, u'+v, u+v', or u'+v'
info = GB_ewise (
(GrB_Matrix) w, C_replace, // w and its descriptor
M, Mask_comp, Mask_struct, // mask and its descriptor
accum, // accumulate operator
op, // operator that defines '+'
(GrB_Matrix) u, false, // u, never transposed
(GrB_Matrix) v, false, // v, never transposed
true, // eWiseAdd
true, alpha, beta, // eWiseUnion
Werk) ;
GB_BURBLE_END ;
return (info) ;
}
|
