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
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
|
//------------------------------------------------------------------------------
// GB_Descriptor_check: check and print a Descriptor
//------------------------------------------------------------------------------
// SuiteSparse:GraphBLAS, Timothy A. Davis, (c) 2017-2025, All Rights Reserved.
// SPDX-License-Identifier: Apache-2.0
//------------------------------------------------------------------------------
#include "GB.h"
#include "get_set/GB_get_set.h"
//------------------------------------------------------------------------------
// GB_dc: check a single descriptor field
//------------------------------------------------------------------------------
static GrB_Info GB_dc
(
int kind, // 0, 1, or 2
const char *field,
const int v,
const int nondefault, // for kind == 0
int pr, // print level
FILE *f
)
{
bool ok = true ;
GrB_Info info = GrB_SUCCESS ;
GBPR0 (" d.%s = ", field) ;
switch ((int) v)
{
case GxB_DEFAULT : GBPR0 ("default ") ; break ;
case GrB_COMP : GBPR0 ("complement") ; break ;
case GrB_STRUCTURE : GBPR0 ("structure ") ; break ;
case GrB_COMP+GrB_STRUCTURE : GBPR0 ("structural complement") ; break ;
case GrB_TRAN : GBPR0 ("transpose ") ; break ;
case GrB_REPLACE : GBPR0 ("replace ") ; break ;
case GxB_AxB_SAXPY : GBPR0 ("saxpy ") ; break ;
case GxB_AxB_GUSTAVSON : GBPR0 ("Gustavson ") ; break ;
case GxB_AxB_HASH : GBPR0 ("hash ") ; break ;
case GxB_AxB_DOT : GBPR0 ("dot ") ; break ;
default : GBPR0 ("unknown ") ;
info = GrB_INVALID_OBJECT ;
ok = false ;
break ;
}
if (ok)
{
if (kind == 0)
{
// most descriptor fields can be set to the default,
// or just one non-default value
if (! (v == GxB_DEFAULT || v == nondefault))
{
ok = false ;
}
}
else if (kind == 1)
{
// mask: can only be one of 4 different values
if (! (v == GxB_DEFAULT || v == GrB_COMP || v == GrB_STRUCTURE ||
v == (GrB_COMP + GrB_STRUCTURE)))
{
ok = false ;
}
}
else // kind == 2
{
// GxB_AxB_METHOD:
if (! (v == GxB_DEFAULT || v == GxB_AxB_GUSTAVSON
|| v == GxB_AxB_DOT || v == GxB_AxB_HASH || v == GxB_AxB_SAXPY))
{
ok = false ;
}
}
}
if (!ok)
{
GBPR0 (" (invalid value for this field)") ;
info = GrB_INVALID_OBJECT ;
}
GBPR0 ("\n") ;
return (info) ;
}
//------------------------------------------------------------------------------
// GB_Descriptor_check
//------------------------------------------------------------------------------
GrB_Info GB_Descriptor_check // check a GraphBLAS descriptor
(
const GrB_Descriptor D, // GraphBLAS descriptor to print and check
const char *name, // name of the descriptor, optional
int pr, // print level
FILE *f // file for output
)
{
//--------------------------------------------------------------------------
// check inputs
//--------------------------------------------------------------------------
GBPR0 ("\n GraphBLAS Descriptor: %s ", ((name != NULL) ? name : "")) ;
if (D == NULL)
{
GBPR0 ("NULL\n") ;
return (GrB_NULL_POINTER) ;
}
//--------------------------------------------------------------------------
// check object
//--------------------------------------------------------------------------
GB_CHECK_MAGIC (D) ;
GBPR0 ("\n") ;
// name given by GrB_set, or 'GrB_*' name for built-in operators
const char *given_name = GB_desc_name_get (D) ;
if (given_name != NULL)
{
GBPR0 (" Descriptor given name: [%s]\n", given_name) ;
}
GrB_Info info [5] ;
info [0] = GB_dc (0, "out ", D->out, GrB_REPLACE, pr, f) ;
info [1] = GB_dc (1, "mask ", D->mask, GxB_DEFAULT, pr, f) ;
info [2] = GB_dc (0, "in0 ", D->in0, GrB_TRAN, pr, f) ;
info [3] = GB_dc (0, "in1 ", D->in1, GrB_TRAN, pr, f) ;
info [4] = GB_dc (2, "axb ", D->axb, GxB_DEFAULT, pr, f) ;
for (int i = 0 ; i < 5 ; i++)
{
if (info [i] != GrB_SUCCESS)
{
GBPR0 (" Descriptor field set to an invalid value\n") ;
return (GrB_INVALID_OBJECT) ;
}
}
if (D->do_sort)
{
GBPR0 (" d.sort = true\n") ;
}
if (D->import != GxB_DEFAULT)
{
GBPR0 (" d.import = secure\n") ;
}
if (D->compression != GxB_DEFAULT)
{
GBPR0 (" d.compression = %d\n", D->compression) ;
}
return (GrB_SUCCESS) ;
}
|
