clSPARSE Library

Lighter version of clSPARSE without Googletest and Boost v1.58 and test files in order to be integrated as a stand-alone dependency of any other project. Only OpenCL 1.x is supported (CL/cl.hpp, work in progress on this side).

Build Status

Pre-built binaries are available on our releases page

Build branch	master	develop
GCC/Clang x64
Visual Studio x64

clSPARSE

an OpenCL™ library implementing Sparse linear algebra routines. This project is a result of a collaboration between AMD Inc. and Vratis Ltd..

What's new in clSPARSE v0.10.1

bug fix release
- Fixes for travis builds
- Fix to the matrix market reader in the cuSPARSE benchmark to synchronize with the regular MM reader
- ~~Replace cl.hpp with cl2.hpp (thanks to arrayfire)~~ (removed for compatibilty reasons with older systems using CUDA libraries)
- Fixes for the Nvidia platform; tested 352.79
  - Fixed buffer overruns in CSR-Adaptive kernels
  - Fix invalid memory access on Nvidia GPUs in CSR-Adaptive SpMV kernel

clSPARSE features

Sparse Matrix - dense Vector multiply (SpM-dV)
Sparse Matrix - dense Matrix multiply (SpM-dM)
Sparse Matrix - Sparse Matrix multiply Sparse Matrix Multiply(SpGEMM) - Single Precision
Iterative conjugate gradient solver (CG)
Iterative biconjugate gradient stabilized solver (BiCGStab)
Dense to CSR conversions (& converse)
COO to CSR conversions (& converse)
Functions to read matrix market files in COO or CSR format

True in spirit with the other clMath libraries, clSPARSE exports a “C” interface to allow projects to build wrappers around clSPARSE in any language they need. A great deal of thought and effort went into designing the API’s to make them less ‘cluttered’ compared to the older clMath libraries. OpenCL state is not explicitly passed through the API, which enables the library to be forward compatible when users are ready to switch from OpenCL 1.2 to OpenCL 2.0 ³

Google Groups

Two mailing lists have been created for the clMath projects:

clmath@googlegroups.com - group whose focus is to answer questions on using the library or reporting issues
clmath-developers@googlegroups.com - group whose focus is for developers interested in contributing to the library code itself

API semantic versioning

Good software is typically the result of iteration and feedback. clSPARSE follows the semantic versioning guidelines, and while the major version number remains '0', the public API should not be considered stable. We release clSPARSE as beta software (0.y.z) early to the community to elicit feedback and comment. This comes with the expectation that with feedback, we may incorporate breaking changes to the API that might require early users to recompile, or rewrite portions of their code as we iterate on the design.

clSPARSE Wiki

The project wiki contains helpful documentation.
A build primer is available, which describes how to use cmake to generate platforms specific build files

Samples

clSPARSE contains a directory of simple OpenCL samples that demonstrate the use of the API in both C and C++. The superbuild script for clSPARSE also builds the samples as an external project, to demonstrate how an application would find and link to clSPARSE with cmake.