Skip to content

SuiteSparse v5.6.0
Compare
Choose a tag to compare
@DrTimothyAldenDavis DrTimothyAldenDavis released this 21 Oct 03:56
v5.6.0
21ffbac

SuiteSparse v5.6.0, Oct 21, 2019, with GraphBLAS v3.1.1.

Release notes for GraphBLAS, since v2.3.5 in SuiteSparse v5.5.0:

GraphBLAS Version 3.1.1, Oct 21, 2019

* minor edits: user guide and comments in code

GraphBLAS Version 3.1.0, Oct 2, 2019

* added MATLAB interface: GraphBLAS/GraphBLAS is new.  In Source/, added
    global pointer to printf for MATLAB mexPrintf, pointer to
    mexMakeMemoryPersistent for Sauna workspace.  Changed how GraphBLAS
    objects are printed with GxB_print.  Changed how duplicate indices are
    handled in assign and extract, to match the MATLAB stadard.  Added
    helper functions for MATLAB (GB_matlab_helper.[ch]).
    Code size: @GrB is 9.7KLOC, test/ is 4.5KLOC).
* bug counter added to this ChangeLog: to count # of bugs that appeared
    in formal releases that affect production code.  The count excludes
    bug fixes for test code, bugs in the demo codes, bugs introduced
    in beta versions that were fixed before any formal release, and
    bugs prior to version 1.0.  Code size of Source/, Include/ excluding
    Source/Generated, and Config/*.m4, is 42,659 lines (not including the
    new MATLAB interface).  13 bugs / 42K lines is a bug rate of 0.3 bugs
    per KLOC, much lower than most commercial software, but higher than
    UMFPACK, CHOLMOD, etc (with about 0.1 bug per KLOC).  GraphBLAS is a
    much more complex library, from the external view, than solving Ax=b.
    If UMFPACK has a bug, then Ax-b is typically large; there is no
    'residual' to check for GraphBLAS.  Also, in GraphBLAS, the test suite
    has about the same size as the main library (32K lines in Test/ and
    Tcov/).  For UMFPACK, etc, the test suite is always about 1/3 the size
    of the library itself.
* 'make dox': for doxygen removed (not really that useful)
* (13) bug fix to GB_reduce_to_vector: to avoid integer divide-by-zero for
    a matrix with n=0 columns.
* (12) bug fix to GB_accum_mask: when C+=T if C has no entries except
    pending tuples
* (11) bug fix to GB_resize: when pending tuples exist and vdim is growing
    from vdim <= 1 to vdim > 1, GB_WAIT(A) is required first.
* (10) bug fix to GB_subref_phase1: "int nI" parameter should be int64_t.

GraphBLAS Version 3.0.1, July 26, 2019

* version number: Three changes to the user-visible API are not
    backward-compatible with V2.x: the added parameters to GxB_init and
    GxB_SelectOp_new, and the change in the type of the Thunk argument for
    GxB_select.  Thus, the SO version of SuiteSparse:GraphBLAS is now 3, no
    longer 2.  This change only affects SuiteSparse:GraphBLAS GxB_*
    extenstions, not any GrB_* functions or definitions.
* added GxB_Scalar: acts like a GrB_Vector of length 1.
* OpenMP parallelism: added nthreads and chunk parameters to GxB_set/get.
* added parameter to GxB_init: bool user_malloc_is_thread_safe,
    for the MATLAB mexFunction interface, or any other malloc library that
    might not be thread-safe.  mxMalloc is not thread-safe.
    This change is not backward compatible with Version 2.x.
* changed thunk parameter of GxB_select:  was (void *), now GxB_Scalar.
    This change is not backward compatible with Version 2.x.
* added parameter to GxB_SelectOp_new: to specify the type of the Thunk.
    This change is not backward compatible with Version 2.x.
* added options to GxB_get: determine if a matrix is hypersparse or not,
    global library, API information, nthreads, and chunk.
* added options to GxB_set: nthreads, and chunk.
* new operators and semirings: RDIV (f(x,y)=y/x) and RMINUS (y-x)
    binary operators.
Assets 2
Loading