pathrex-sys 0.1.0

Native FFI bindings for SuiteSparse:GraphBLAS and LAGraph used by the pathrex crate.
Documentation
//------------------------------------------------------------------------------
// LAGraph_Matrix_Print:  pretty-print a matrix
//------------------------------------------------------------------------------

// LAGraph, (c) 2019-2022 by The LAGraph Contributors, All Rights Reserved.
// SPDX-License-Identifier: BSD-2-Clause
//
// For additional details (including references to third party source code and
// other files) see the LICENSE file or contact permission@sei.cmu.edu. See
// Contributors.txt for a full list of contributors. Created, in part, with
// funding and support from the U.S. Government (see Acknowledgments.txt file).
// DM22-0790

// Contributed by Timothy A. Davis, Texas A&M University

//------------------------------------------------------------------------------

// LAGraph_Matrix_Print:  pretty-print a matrix.

#include "LG_internal.h"

#undef  LG_FREE_WORK
#define LG_FREE_WORK                    \
{                                       \
    LAGraph_Free ((void **) &I, NULL) ; \
    LAGraph_Free ((void **) &J, NULL) ; \
    LAGraph_Free ((void **) &X, NULL) ; \
}

#undef  LG_FREE_ALL
#define LG_FREE_ALL LG_FREE_WORK

//------------------------------------------------------------------------------
// LG_Matrix_Print_TYPE: print with the specified type
//------------------------------------------------------------------------------

#define LG_MATRIX_PRINT(suffix,ctype,gtype,fmt1,fmt2)                       \
int LG_Matrix_Print_ ## suffix                                              \
(                                                                           \
    GrB_Matrix A, LAGraph_PrintLevel pr, FILE *f, char *msg                 \
)                                                                           \
{                                                                           \
    LG_CLEAR_MSG ;                                                          \
    ctype *X = NULL ;                                                       \
    GrB_Index *I = NULL, *J = NULL ;                                        \
    LG_ASSERT (A != NULL && f != NULL, GrB_NULL_POINTER) ;                  \
    int prl = (int) pr ;                                                    \
    if (prl <= 0) return (GrB_SUCCESS) ;                                    \
    /* get basic properties */                                              \
    GrB_Index nrows, ncols, nvals ;                                         \
    GRB_TRY (GrB_Matrix_nrows (&nrows, A)) ;                                \
    GRB_TRY (GrB_Matrix_ncols (&ncols, A)) ;                                \
    GRB_TRY (GrB_Matrix_nvals (&nvals, A)) ;                                \
    /* print header line */                                                 \
    FPRINTF (f, "%s matrix: %" PRIu64 "-by-%" PRIu64 " entries: %" PRIu64   \
        "\n", LG_XSTR (gtype), nrows, ncols, nvals) ;                       \
    if (prl <= 1) return (GrB_SUCCESS) ;                                    \
    /* extract tuples */                                                    \
    LG_TRY (LAGraph_Malloc ((void **) &I, nvals, sizeof (GrB_Index), msg)) ;\
    LG_TRY (LAGraph_Malloc ((void **) &J, nvals, sizeof (GrB_Index), msg)) ;\
    LG_TRY (LAGraph_Malloc ((void **) &X, nvals, sizeof (ctype), msg)) ;    \
    GrB_Info info = GrB_Matrix_extractTuples (I, J, X, &nvals, A) ;         \
    LG_ASSERT_MSG (info != GrB_DOMAIN_MISMATCH,                             \
        GrB_NOT_IMPLEMENTED, "type not supported") ;                        \
    GRB_TRY (info) ;                                                        \
    /* determine the format */                                              \
    char *format = (prl <= 3) ? fmt1 : fmt2 ;                               \
    bool summary = (prl == 2 || prl == 4) && (nvals > LG_SHORT_LEN) ;       \
    for (int64_t k = 0 ; k < nvals ; k++)                                   \
    {                                                                       \
        /* print the kth tuple */                                           \
        GrB_Index i = I [k] ;                                               \
        GrB_Index j = J [k] ;                                               \
        ctype     x = X [k] ;                                               \
        FPRINTF (f, "    (%" PRIu64 ", %" PRIu64 ")   ", i, j) ;            \
        FPRINTF (f, format, x) ;                                            \
        FPRINTF (f, "\n") ;                                                 \
        if (summary && k > LG_SHORT_LEN)                                    \
        {                                                                   \
            /* quit early if a only a summary is requested */               \
            FPRINTF (f, "    ...\n") ;                                      \
            break ;                                                         \
        }                                                                   \
    }                                                                       \
    LG_FREE_WORK ;                                                          \
    return (GrB_SUCCESS) ;                                                  \
}

LG_MATRIX_PRINT (BOOL  , bool    , GrB_BOOL  , "%d"  , "%d"    ) ;
LG_MATRIX_PRINT (INT8  , int8_t  , GrB_INT8  , "%d"  , "%d"    ) ;
LG_MATRIX_PRINT (INT16 , int16_t , GrB_INT16 , "%d"  , "%d"    ) ;
LG_MATRIX_PRINT (INT32 , int32_t , GrB_INT32 , "%" PRId32, "%" PRId32  ) ;
LG_MATRIX_PRINT (INT64 , int64_t , GrB_INT64 , "%" PRId64, "%" PRId64  ) ;
LG_MATRIX_PRINT (UINT8 , uint8_t , GrB_UINT8 , "%d"  , "%d"    ) ;
LG_MATRIX_PRINT (UINT16, uint16_t, GrB_UINT16, "%d"  , "%d"    ) ;
LG_MATRIX_PRINT (UINT32, uint32_t, GrB_UINT32, "%" PRIu32, "%" PRIu32  ) ;
LG_MATRIX_PRINT (UINT64, uint64_t, GrB_UINT64, "%" PRIu64, "%" PRIu64  ) ;
LG_MATRIX_PRINT (FP32  , float   , GrB_FP32  , "%g"  , "%0.7g" ) ;
LG_MATRIX_PRINT (FP64  , double  , GrB_FP64  , "%g"  , "%0.15g") ;
// LG_MATRIX_PRINT (FC32  , GxB_FC32_t, GxB_FC32, ...) ;
// LG_MATRIX_PRINT (FC64  , GxB_FC64_t, GxB_FC64, ...) ;

#undef  LG_FREE_WORK
#define LG_FREE_WORK ;
#undef  LG_FREE_ALL
#define LG_FREE_ALL ;

//------------------------------------------------------------------------------
// LAGraph_Matrix_Print: automatically determine the type
//------------------------------------------------------------------------------

int LAGraph_Matrix_Print
(
    // input:
    const GrB_Matrix A,     // matrix to pretty-print to the file
    LAGraph_PrintLevel pr,  // print level (0 to 5)
    FILE *f,            // file to write it to, must be already open; use
                        // stdout or stderr to print to those locations.
    char *msg
)
{

    //--------------------------------------------------------------------------
    // check inputs
    //--------------------------------------------------------------------------

    LG_CLEAR_MSG ;
    LG_ASSERT (A != NULL && f != NULL, GrB_NULL_POINTER) ;

    //--------------------------------------------------------------------------
    // determine the type
    //--------------------------------------------------------------------------

    int32_t typecode ;
    GRB_TRY (GrB_get (A, &typecode, GrB_EL_TYPE_CODE)) ;

    //--------------------------------------------------------------------------
    // print the matrix
    //--------------------------------------------------------------------------

    switch (typecode)
    {
        case GrB_BOOL_CODE   : return (LG_Matrix_Print_BOOL (A, pr, f, msg)) ;
        case GrB_INT8_CODE   : return (LG_Matrix_Print_INT8 (A, pr, f, msg)) ;
        case GrB_INT16_CODE  : return (LG_Matrix_Print_INT16 (A, pr, f, msg)) ;
        case GrB_INT32_CODE  : return (LG_Matrix_Print_INT32 (A, pr, f, msg)) ;
        case GrB_INT64_CODE  : return (LG_Matrix_Print_INT64 (A, pr, f, msg)) ;
        case GrB_UINT8_CODE  : return (LG_Matrix_Print_UINT8 (A, pr, f, msg)) ;
        case GrB_UINT16_CODE : return (LG_Matrix_Print_UINT16 (A, pr, f, msg)) ;
        case GrB_UINT32_CODE : return (LG_Matrix_Print_UINT32 (A, pr, f, msg)) ;
        case GrB_UINT64_CODE : return (LG_Matrix_Print_UINT64 (A, pr, f, msg)) ;
        case GrB_FP32_CODE   : return (LG_Matrix_Print_FP32 (A, pr, f, msg)) ;
        case GrB_FP64_CODE   : return (LG_Matrix_Print_FP64 (A, pr, f, msg)) ;
//      case GxB_FC32_CODE   : return (LG_Matrix_Print_FC32 (A, pr, f, msg)) ;
//      case GxB_FC64_CODE   : return (LG_Matrix_Print_FC64 (A, pr, f, msg)) ;
        default              :
            LG_ASSERT_MSG (false,
                GrB_NOT_IMPLEMENTED, "user-defined types not supported") ;
            return (GrB_NOT_IMPLEMENTED) ;
    }
}