4 cuSPARSE数据类型参考

4.1 数据类型

float,double,cuComplex,cuDoubleComplex后两个类型是来自cuComplex.h

4.2 cusparseStatus_t

表示库函数返回的状态，可以有以下取值：

CUSPARSE_STATUS_SUCCESS 操作成功完成
CUSPARSE_STATUS_NOT_INITIALIZED 库没有初始化，通常是因为缺少预先调用，或者是硬件配置错误
CUSPARSE_STATUS_ALLOC_FAILEDcuSPARSE内存分配失败，通常是由设备内存分配（cudaMalloc）或者主机内存分配失败造成的，可以在函数调用前尽可能地释放之前分配的内存
CUSPARSE_STATUS_INVALID_VALUE传入的参数值有误
CUSPARSE_STATUS_ARCH_MISMATCH设备问题，需要在具有适当计算运行能力的设备上编译并运行应用程序
CUSPARSE_STATUS_EXECUTION_FAILEDGPU程序执行失败。处理步骤这通常是由GPU内核启动失败引起的，这可能是由多种原因引起的:检查硬件、适当版本的驱动程序和cuSPARSE库是否正确安装
CUSPARSE_STATUS_INTERNAL_ERROR检查硬件、适当版本的驱动程序和cuSPARSE库是否正确安装。另外，检查作为参数传递给例程的内存是否在例程完成之前被释放
CUSPARSE_STATUS_MATRIX_TYPE_NOT_SUPPORTED此函数不支持矩阵类型。这通常是由于向函数传递无效的矩阵描述符引起的
纠正方法:检查cusparseMatDescr_t descrA中的字段是否设置正确
CUSPARSE_STATUS_NOT_SUPPORTED该函数目前不支持操作或数据类型组合
CUSPARSE_STATUS_INSUFFICIENT_RESOURCES 用于计算的资源(如GPU全局内存或共享内存)不足以完成该操作。该错误也可以表明当前的计算模式(例如稀疏矩阵索引的比特大小)不允许处理给定的输入

4.3 cusparseHandle_t

这是一个指针类型，用户必须在调用cusparseCreate()任何其他库函数之前初始化该上下文。由cusparseCreate()创建和返回的句柄必须传递给每个cuSPARSE函数。

4.4. cusparsePointerMode_t

表示向量是否在主机或者GPU上通过引用传递。如果在函数调用中通过引用传递几个标量值，那么它们将遵循相同的单指针模式。指针模式可以分别使用cusparseSetPointerMode()和cusparseGetPointerMode()例程设置和检索。

CUSPARSE_POINTER_MODE_HOST标量在主机上通过引用传递
CUSPARSE_POINTER_MODE_DEVICE标量在设备上通过引用传递

4.5. cusparseOperation_t

此类型指示操作是仅对索引执行，还是对数据和索引执行。

CUSPARSE_ACTION_SYMBOLIC操作只对索引进行
CUSPARSE_ACTION_NUMERIC操作对数值和索引都执行

4.7. cusparseDirection_t

该类型表示函数cusparse[S|D|C|Z]nnz中密集矩阵的元素应该按行还是按列(假设密集矩阵的内存中有列为主存储)进行解析。此外，BSR格式的块的存储格式也由该类型控制。

CUSPARSE_DIRECTION_ROW矩阵应该按行解析
CUSPARSE_DIRECTION_COLUMN矩阵应该按列解析

4.8. cusparseMatDescr_t

这个结构用来描述矩阵的形状和性质

typedef struct {
    cusparseMatrixType_t MatrixType;
    cusparseFillMode_t FillMode;
    cusparseDiagType_t DiagType;
    cusparseIndexBase_t IndexBase;
} cusparseMatDescr_t;