Merge pull request #1002 from DrTimothyAldenDavis/dev2

SuiteSparse 7.12.0

Author: DrTimothyAldenDavis

.github/workflows/macos.yaml

@@ -52,6 +52,7 @@ jobs:
         run: |
           brew update
           brew install --overwrite python@3.10 python@3.11 python@3.12
+          brew uninstall cmake
           brew reinstall gcc
           brew install autoconf automake ccache cmake gmp lapack libomp mpfr openblas
           HOMEBREW_PREFIX=$(brew --prefix)

ChangeLog

@@ -1,3 +1,35 @@
+Nov 1, 2025: version 7.12.0
+
+    * UMFPACK 6.3.7: workaround for an Intel icx 2025.2 compiler bug
+    * LAGraph 1.2.1: bug fix for experimental maxflow method
+    * ParU 1.1.0: performance improvements, minor revisions for benchmarking
+    * GraphBLAS 10.2.0: printing user-defined types, GrB_assign performance
+    * SPQR 4.3.6: better handling of complex types for BLAS/LAPACK
+    * SuiteSparse_config 7.12.0: better handling of complex types for
+        BLAS/LAPACK
+    * Mongoose 3.3.6: minor change to build system
+    * Package versions in this release: (* denotes a new version)
+        SuiteSparse_config 7.12.0   *
+        AMD 3.3.4
+        BTF 2.3.3
+        CAMD 3.3.5
+        CCOLAMD 3.3.5
+        CHOLMOD 5.3.4
+        COLAMD 3.3.5
+        CSparse 4.3.2
+        CXSparse 4.4.2
+        Example 1.8.10              *
+        GraphBLAS 10.2.0            *
+        KLU 2.3.6
+        LDL 3.3.3
+        LAGraph 1.2.1               *
+        SuiteSparse_Mongoose 3.3.6  *
+        ParU 1.1.0                  *
+        RBio 4.3.5
+        SPEX 3.2.4
+        SPQR 4.3.6                  *
+        UMFPACK 6.3.7               *
+
 July 25, 2025: version 7.11.0
 
     * LAGraph v1.2: many new experimental algorithms, LAGraph_Random in src/

Example/CMakeLists.txt

@@ -53,10 +53,10 @@ message ( STATUS "MY prefix path:    ${CMAKE_PREFIX_PATH}" )
 #-------------------------------------------------------------------------------
 
 # cmake inserts the date and version number into Include/my.h:
-set ( MY_DATE "July 25, 2025" )
+set ( MY_DATE "Nov 1, 2025" )
 set ( MY_VERSION_MAJOR 1 )
 set ( MY_VERSION_MINOR 8 )
-set ( MY_VERSION_PATCH 9 )
+set ( MY_VERSION_PATCH 10 )
 
 message ( STATUS "Building MY library version: v"
     ${MY_VERSION_MAJOR}.
@@ -88,25 +88,25 @@ project ( my
 #-------------------------------------------------------------------------------
 
 # look for all SuiteSparse packages:
-find_package ( SuiteSparse_config 7.11.0 REQUIRED )
+find_package ( SuiteSparse_config 7.12.0 REQUIRED )
 find_package ( AMD 3.3.4 REQUIRED )
 find_package ( BTF 2.3.3 REQUIRED )
 find_package ( CAMD 3.3.5 REQUIRED )
 find_package ( CCOLAMD 3.3.5 REQUIRED )
 find_package ( CHOLMOD 5.3.4 REQUIRED )
 find_package ( COLAMD 3.3.5 REQUIRED )
 find_package ( CXSparse 4.4.2 REQUIRED )
-find_package ( GraphBLAS 10.1.1 )
+find_package ( GraphBLAS 10.2.0 )
 find_package ( KLU 2.3.6 REQUIRED )
 find_package ( KLU_CHOLMOD 2.3.6 REQUIRED )
+find_package ( LAGraph 1.2.1 )
 find_package ( LDL 3.3.3 REQUIRED )
-find_package ( LAGraph 1.2.0 )
-find_package ( SuiteSparse_Mongoose 3.3.5 REQUIRED )
-find_package ( ParU 1.0.1 REQUIRED )
+find_package ( ParU 1.1.0 REQUIRED )
 find_package ( RBio 4.3.5 REQUIRED )
 find_package ( SPEX 3.2.4 REQUIRED )    # requires GMP and MPFR
-find_package ( SPQR 4.3.5 REQUIRED )
-find_package ( UMFPACK 6.3.6 REQUIRED )
+find_package ( SPQR 4.3.6 REQUIRED )
+find_package ( SuiteSparse_Mongoose 3.3.6 REQUIRED )
+find_package ( UMFPACK 6.3.7 REQUIRED )
 
 #-------------------------------------------------------------------------------
 # configure files

Example/Include/my.h

@@ -11,10 +11,10 @@
 // file, since it is constructed from Config/my.h.in by cmake.
 
 // version and date for example user library
-#define MY_DATE "July 25, 2025"
+#define MY_DATE "Nov 1, 2025"
 #define MY_MAJOR_VERSION 1
 #define MY_MINOR_VERSION 8
-#define MY_PATCH_VERSION 9
+#define MY_PATCH_VERSION 10
 
 #ifdef __cplusplus
 extern "C" {

Example/Include/my_internal.h

@@ -14,97 +14,97 @@
 
 // SuiteSparse include files for C/C++:
 #include "SuiteSparse_config.h"
-#if !defined (SUITESPARSE__VERSION) || SUITESPARSE__VERSION < SUITESPARSE__VERCODE(7,10,4)
-#error "This library requires SuiteSparse_config 7.10.4 or later"
+#if !defined (SUITESPARSE__VERSION) || SUITESPARSE__VERSION < SUITESPARSE__VERCODE(7,12,0)
+#error "This library requires SuiteSparse_config 7.12.0 or later"
 #endif
 
 #include "amd.h"
-#if !defined (AMD__VERSION) || AMD__VERSION < SUITESPARSE__VERCODE(3,3,3)
-#error "This library requires AMD 3.3.3 or later"
+#if !defined (AMD__VERSION) || AMD__VERSION < SUITESPARSE__VERCODE(3,3,4)
+#error "This library requires AMD 3.3.4 or later"
 #endif
 
 #include "btf.h"
-#if !defined (BTF__VERSION) || BTF__VERSION < SUITESPARSE__VERCODE(2,3,2)
-#error "This library requires BTF 2.3.2 or later"
+#if !defined (BTF__VERSION) || BTF__VERSION < SUITESPARSE__VERCODE(2,3,3)
+#error "This library requires BTF 2.3.3 or later"
 #endif
 
 #include "camd.h"
-#if !defined (CAMD__VERSION) || CAMD__VERSION < SUITESPARSE__VERCODE(3,3,4)
-#error "This library requires CAMD 3.3.4 or later"
+#if !defined (CAMD__VERSION) || CAMD__VERSION < SUITESPARSE__VERCODE(3,3,5)
+#error "This library requires CAMD 3.3.5 or later"
 #endif
 
 #include "ccolamd.h"
-#if !defined (CCOLAMD__VERSION) || CCOLAMD__VERSION < SUITESPARSE__VERCODE(3,3,4)
-#error "This library requires CCOLAMD 3.3.4 or later"
+#if !defined (CCOLAMD__VERSION) || CCOLAMD__VERSION < SUITESPARSE__VERCODE(3,3,5)
+#error "This library requires CCOLAMD 3.3.5 or later"
 #endif
 
 #include "cholmod.h"
-#if !defined (CHOLMOD__VERSION) || CHOLMOD__VERSION < SUITESPARSE__VERCODE(5,3,3)
-#error "This library requires CHOLMOD 5.3.3 or later"
+#if !defined (CHOLMOD__VERSION) || CHOLMOD__VERSION < SUITESPARSE__VERCODE(5,3,4)
+#error "This library requires CHOLMOD 5.3.4 or later"
 #endif
 
 #include "colamd.h"
-#if !defined (COLAMD__VERSION) || COLAMD__VERSION < SUITESPARSE__VERCODE(3,3,4)
-#error "This library requires COLAMD 3.3.4 or later"
+#if !defined (COLAMD__VERSION) || COLAMD__VERSION < SUITESPARSE__VERCODE(3,3,5)
+#error "This library requires COLAMD 3.3.5 or later"
 #endif
 
 #include "cs.h"
-#if !defined (CXSPARSE__VERSION) || CXSPARSE__VERSION < SUITESPARSE__VERCODE(4,4,1)
-#error "This library requires CXSparse 4.4.1 or later"
+#if !defined (CXSPARSE__VERSION) || CXSPARSE__VERSION < SUITESPARSE__VERCODE(4,4,2)
+#error "This library requires CXSparse 4.4.2 or later"
 #endif
 
 #if ! defined (NO_GRAPHBLAS)
     #include "GraphBLAS.h"
     #if !defined ( GxB_SUITESPARSE_GRAPHBLAS ) || \
-        GxB_IMPLEMENTATION < GxB_VERSION (10,1,1)
-    #error "This library requires SuiteSparse:GraphBLAS 10.1.1 or later"
+        GxB_IMPLEMENTATION < GxB_VERSION (10,2,0)
+    #error "This library requires SuiteSparse:GraphBLAS 10.2.0 or later"
     #endif
 #endif
 
 #if ! defined (NO_LAGRAPH)
     #include "LAGraph.h"
-    #if SUITESPARSE__VERCODE(LAGRAPH_VERSION_MAJOR,LAGRAPH_VERSION_MINOR,LAGRAPH_VERSION_UPDATE) < SUITESPARSE__VERCODE(1,2,0)
-    #error "This library requires LAGraph 1.2.0 or later"
+    #if SUITESPARSE__VERCODE(LAGRAPH_VERSION_MAJOR,LAGRAPH_VERSION_MINOR,LAGRAPH_VERSION_UPDATE) < SUITESPARSE__VERCODE(1,2,1)
+    #error "This library requires LAGraph 1.2.1 or later"
     #endif
 #endif
 
 #include "klu.h"
-#if !defined (KLU__VERSION) || KLU__VERSION < SUITESPARSE__VERCODE(2,3,5)
-#error "This library requires KLU 2.3.5 or later"
+#if !defined (KLU__VERSION) || KLU__VERSION < SUITESPARSE__VERCODE(2,3,6)
+#error "This library requires KLU 2.3.6 or later"
 #endif
 
 #include "ldl.h"
-#if !defined (LDL__VERSION) || LDL__VERSION < SUITESPARSE__VERCODE(3,3,2)
-#error "This library requires LDL 3.3.2 or later"
+#if !defined (LDL__VERSION) || LDL__VERSION < SUITESPARSE__VERCODE(3,3,3)
+#error "This library requires LDL 3.3.3 or later"
 #endif
 
 #include "RBio.h"
-#if !defined (RBIO__VERSION) || RBIO__VERSION < SUITESPARSE__VERCODE(4,3,4)
-#error "This library requires RBio 4.3.4 or later"
+#if !defined (RBIO__VERSION) || RBIO__VERSION < SUITESPARSE__VERCODE(4,3,5)
+#error "This library requires RBio 4.3.5 or later"
 #endif
 
 #include "SPEX.h"
-#if !defined (SPEX__VERSION) || SPEX__VERSION < SUITESPARSE__VERCODE(3,2,3)
-#error "This library requires SPEX 3.2.3 or later"
+#if !defined (SPEX__VERSION) || SPEX__VERSION < SUITESPARSE__VERCODE(3,2,4)
+#error "This library requires SPEX 3.2.4 or later"
 #endif
 
 #include "SuiteSparseQR_C.h"
-#if !defined (SPQR__VERSION) || SPQR__VERSION < SUITESPARSE__VERCODE(4,3,4)
-#error "This library requires SPQR 4.3.4 or later"
+#if !defined (SPQR__VERSION) || SPQR__VERSION < SUITESPARSE__VERCODE(4,3,6)
+#error "This library requires SPQR 4.3.6 or later"
 #endif
 
 #include "umfpack.h"
-#if !defined (UMFPACK__VERSION) || UMFPACK__VERSION < SUITESPARSE__VERCODE(6,3,5)
-#error "This library requires UMFPACK 6.3.5 or later"
+#if !defined (UMFPACK__VERSION) || UMFPACK__VERSION < SUITESPARSE__VERCODE(6,3,7)
+#error "This library requires UMFPACK 6.3.7 or later"
 #endif
 
 // SuiteSparse include files for C++:
 #ifdef __cplusplus
     #include "SuiteSparseQR.hpp"
 
     #include "Mongoose.hpp"
-    #if !defined (Mongoose__VERSION) || Mongoose__VERSION < SUITESPARSE__VERCODE(3,3,4)
-    #error "This library requires Mongoose 3.3.4 or later"
+    #if !defined (Mongoose__VERSION) || Mongoose__VERSION < SUITESPARSE__VERCODE(3,3,6)
+    #error "This library requires Mongoose 3.3.6 or later"
     #endif
 
 #endif

Example/Makefile

@@ -43,6 +43,7 @@ all: library
 
 demos: library
 	( cd build && ./my_demo )
+	( cd build && ./my_cxx_demo )
 
 # just compile after running cmake; do not run cmake again
 remake:

Example/Makefile.am

@@ -1,5 +1,5 @@
 #-------------------------------------------------------------------------------
-# SuiteSparse/Example/Makefile
+# SuiteSparse/Example/Makefile.am
 #-------------------------------------------------------------------------------
 
 # Example: Copyright (c) 2023, Timothy A. Davis, All Rights Reserved.

GraphBLAS/CUDA/GB_cuda.hpp

@@ -90,8 +90,8 @@ void GB_cuda_upscale_identity
 // stream pool
 //------------------------------------------------------------------------------
 
-GrB_Info GB_cuda_acquire_stream (cudaStream_t *stream) ;
-GrB_Info GB_cuda_release_stream (cudaStream_t *stream) ;
+GrB_Info GB_cuda_stream_pool_acquire (cudaStream_t *stream) ;
+GrB_Info GB_cuda_stream_pool_release (cudaStream_t *stream) ;
 
 #endif
 

GraphBLAS/CUDA/GB_cuda_AxB_dot3.cpp

@@ -17,7 +17,7 @@
 #define GB_FREE_ALL                                         \
 {                                                           \
     GB_phybix_free (C) ;                                    \
-    GB_cuda_release_stream (&stream) ;                      \
+    GB_cuda_stream_pool_release (&stream) ;                      \
 }
 
 #include "GB_cuda_AxB.hpp"
@@ -84,13 +84,11 @@ GrB_Info GB_cuda_AxB_dot3           // C<M> = A'*B using dot product method
     int device = -1;
     cudaStream_t stream = nullptr ;
 
-    // FIXME: control the GPU to use via the context
-//  CUDA_OK (cudaSetDevice ( 0 )) ;
-    CUDA_OK (cudaGetDevice (&device)) ;     // FIXME
+    CUDA_OK (cudaGetDevice (&device)) ;     // FIXME: use the Context
     printf ("dot3 using cuda device %d\n", device) ;
     int number_of_sms = GB_Global_gpu_sm_get (0) ;
 
-    GB_OK (GB_cuda_acquire_stream (&stream)) ;
+    GB_OK (GB_cuda_stream_pool_acquire (&stream)) ;
 
     //--------------------------------------------------------------------------
     // get M
@@ -230,7 +228,7 @@ GrB_Info GB_cuda_AxB_dot3           // C<M> = A'*B using dot product method
     //--------------------------------------------------------------------------
 
     ASSERT_MATRIX_OK (C, "C result from dot3 cuda A'*B", GB0) ;
-    GB_OK (GB_cuda_release_stream (&stream)) ;
+    GB_OK (GB_cuda_stream_pool_release (&stream)) ;
     return GrB_SUCCESS;
 }
 

GraphBLAS/CUDA/GB_cuda_apply_binop.cpp

@@ -10,7 +10,7 @@
 #define GB_FREE_ALL                                         \
 {                                                           \
     GB_FREE_WORKSPACE ;                                     \
-    GB_cuda_release_stream (&stream) ;                      \
+    GB_cuda_stream_pool_release (&stream) ;                      \
 }
 
 #define BLOCK_SIZE 512
@@ -31,7 +31,7 @@ GrB_Info GB_cuda_apply_binop
     size_t scalarx_cuda_size = 0 ;
 
     cudaStream_t stream = nullptr ;
-    GB_OK (GB_cuda_acquire_stream (&stream)) ;
+    GB_OK (GB_cuda_stream_pool_acquire (&stream)) ;
 
     ASSERT (scalarx != NULL) ;
     // make a copy of scalarx to ensure it's not on the CPU stack
@@ -74,6 +74,6 @@ GrB_Info GB_cuda_apply_binop
     }
 
     GB_FREE_WORKSPACE ;
-    GB_OK (GB_cuda_release_stream (&stream)) ;
+    GB_OK (GB_cuda_stream_pool_release (&stream)) ;
     return GrB_SUCCESS ; 
 }