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
|
SuiteSparse:GraphBLAS, Timothy A. Davis, (c) 2017-2020, All Rights Reserved.
http://suitesparse.com See GraphBLAS/Doc/License.txt for license.
GraphBLAS/Test:
This folder includes a MATLAB interface that tests each GraphBLAS function. It
is meant for testing and development only, not for general usage. The
functions are efficient and robust. They are not well-suited for general use
because the interface is not designed to be simple, clean, elegant, and
well-documented. Such an interface would interfere with the purpose of these
functions, which is to compute a result in GraphBLAS (via a GB_mex_*
mexFunction) and then to compare its results with the GB_spec_*.m MATLAB mimic
function. None of the GB_mex_*.c mexFunctions have corresponding GB_mex_*.m
files to provide 'help GB_mex...' documentation.
Requirements: the mex command must use a C compiler supporting ANSI C11.
Microft Visual Studio does not support ANSI C11 so this test is not available
on Windows unless you use another compiler.
To run the tests, use the following command in this directory, in MATLAB:
make ; testall
If you get a linking problem on linux, add this directory to your
LD_LIBRARY_PATH, so that the libgraphblas.so can be found by the mexFunctions.
Longer tests can be done as well (this can take a whole day):
testall (1)
To run with malloc debugging (this will be slower):
debug_on
make ; testall
To turn off malloc debugging:
debug_off
Malloc debugging is very extensive. When enabled, the GraphBLAS wrapper
functions for malloc/calloc/realloc/free, which are mxMalloc/etc in this MATLAB
interface, decrement a counter when they are been successful. When this
reaches zero, they pretend to fail, and thus allow the out-of-memory error
handling in GraphBLAS to be tested. If the function fails, the counter is
reset, and the test is done again. The initial state of this counter is
increased until the function succeeds. During this entire process, a count is
kept of malloc'd blocks, and an error is reported if a leak is found.
GraphBLAS will be very slow with malloc debugging enabled. It is only done
through the MATLAB interface and has no effect when GraphBLAS is used through a
C program (as in the Demo/ programs).
To enable further debugging tests, see the comments in Source/GB.h.
--------------------------------------------------------------------------------
Files and folders in GraphBLAS/Test:
--------------------------------------------------------------------------------
GB_spec_*.m 'spec' scripts. These are very concise scripts, yet they
perfectly match the GraphBLAS spec. They are very slow since
they rely on MATLAB dense matrices, since MATLAB only supports
sparse logical, double, and double complex matrices.
GB_mex_*.c mexFunction interfaces to GraphBLAS functions. Some of these
are interfaces to internal functions in SuiteSparse:GraphBLAS
that are not in the GraphBLAS spec. All of the functions rely
on the specific details of the SuiteSparse:GraphBLAS
implementation of the GraphBLAS specification, and thus they
are not suitable as general interfaces to any GraphBLAS
implementation.
GB_mx_*.c helper functions for the mexFunctions
GB_mex.h include file for the mexFunctions
Template/*.c a template file for building two mexFunctions:
GB_mex_Matrix_build and GB_mex_Vector_build.
make.m compiles the MATLAB interface to GraphBLAS (links with
dynamic -lgraphblas)
debug_off.m turns off malloc debugging
debug_on.m turns on malloc debugging; the interface will be *very* slow,
since the problem is solved many times, with slowing increasing
allotment of malloc's, until it succeeds.
stat.m report on whether malloc debugging is enabled, and the current
test coverage (see ../Tcov).
testall.m a complete set of tests for GraphBLAS
testperf.m performance tests for GraphBLAS
testperf_diary.txt diary of testperf.m on a MacBookPro, 2.8 GHz Intel Core
i7, 16 GB Ram, OSX 10.11.6, clang 8.0.0, MATLAB R2017A.
spok an acronym for "sparse OK"; checks if a MATLAB sparse matrix
is valid
README.txt this file
Contents.m list of m-files in this folder
GB_define.m create #defines for GraphBLAS.h
GB_user_*.m test user-defined complex type and operators
Makefile only 'make clean' and 'make distclean'
For all other *.m files, see Contents.m for a description.
|
