前言
編寫 CUDA 程式真心不是個簡單的事兒,除錯也不方便,很費時。那麼有沒有一些現成的 CUDA 庫來呼叫呢?
答案是有的,如 CUBLAS 就是 CUDA 專門用來解決線性代數運算的庫。
本文將大致介紹如何使用 CUBLAS 庫,同時演示一個使用 CUBLAS 庫進行矩陣乘法的例子。
CUBLAS 內容
CUBLAS 是 CUDA 專門用來解決線性代數運算的庫,它分為三個級別:
Lev1. 向量相乘
Lev2. 矩陣乘向量
Lev3. 矩陣乘矩陣
同時該庫還包含狀態結構和一些功能函式。
CUBLAS 用法
大體分成以下幾個步驟:
1. 定義 CUBLAS 庫物件
2. 在視訊記憶體中為待運算的資料以及需要存放結果的變數開闢視訊記憶體空間。( cudaMalloc 函式實現 )
3. 將待運算的資料傳輸進視訊記憶體。( cudaMemcpy,cublasSetVector 等函式實現 )
4. 呼叫 CUBLAS 庫函式 ( 根據 CUBLAS 手冊呼叫需要的函式 )
5. 從視訊記憶體中獲取結果變數。( cudaMemcpy,cublasGetVector 等函式實現 )
6. 釋放申請的視訊記憶體空間以及 CUBLAS 庫物件。( cudaFree 及 cublasDestroy 函式實現 )
程式碼示例
如下程式使用 CUBLAS 庫進行矩陣乘法運算,請仔細閱讀註釋,尤其是 API 的引數說明:
1 // CUDA runtime 庫 + CUBLAS 庫 2 #include "cuda_runtime.h" 3 #include "cublas_v2.h" 4 5 #include <time.h> 6 #include <iostream> 7 8 using namespace std; 9 10 // 定義測試矩陣的維度 11 int const M = 5; 12 int const N = 10; 13 14 int main() 15 { 16 // 定義狀態變數 17 cublasStatus_t status; 18 19 // 在 記憶體 中為將要計算的矩陣開闢空間 20 float *h_A = (float*)malloc (N*M*sizeof(float)); 21 float *h_B = (float*)malloc (N*M*sizeof(float)); 22 23 // 在 記憶體 中為將要存放運算結果的矩陣開闢空間 24 float *h_C = (float*)malloc (M*M*sizeof(float)); 25 26 // 為待運算矩陣的元素賦予 0-10 範圍內的隨機數 27 for (int i=0; i<N*M; i++) { 28 h_A[i] = (float)(rand()%10+1); 29 h_B[i] = (float)(rand()%10+1); 30 31 } 32 33 // 列印待測試的矩陣 34 cout << "矩陣 A :" << endl; 35 for (int i=0; i<N*M; i++){ 36 cout << h_A[i] << " "; 37 if ((i+1)%N == 0) cout << endl; 38 } 39 cout << endl; 40 cout << "矩陣 B :" << endl; 41 for (int i=0; i<N*M; i++){ 42 cout << h_B[i] << " "; 43 if ((i+1)%M == 0) cout << endl; 44 } 45 cout << endl; 46 47 /* 48 ** GPU 計算矩陣相乘 49 */ 50 51 // 建立並初始化 CUBLAS 庫物件 52 cublasHandle_t handle; 53 status = cublasCreate(&handle); 54 55 if (status != CUBLAS_STATUS_SUCCESS) 56 { 57 if (status == CUBLAS_STATUS_NOT_INITIALIZED) { 58 cout << "CUBLAS 物件例項化出錯" << endl; 59 } 60 getchar (); 61 return EXIT_FAILURE; 62 } 63 64 float *d_A, *d_B, *d_C; 65 // 在 視訊記憶體 中為將要計算的矩陣開闢空間 66 cudaMalloc ( 67 (void**)&d_A, // 指向開闢的空間的指標 68 N*M * sizeof(float) // 需要開闢空間的位元組數 69 ); 70 cudaMalloc ( 71 (void**)&d_B, 72 N*M * sizeof(float) 73 ); 74 75 // 在 視訊記憶體 中為將要存放運算結果的矩陣開闢空間 76 cudaMalloc ( 77 (void**)&d_C, 78 M*M * sizeof(float) 79 ); 80 81 // 將矩陣資料傳遞進 視訊記憶體 中已經開闢好了的空間 82 cublasSetVector ( 83 N*M, // 要存入視訊記憶體的元素個數 84 sizeof(float), // 每個元素大小 85 h_A, // 主機端起始地址 86 1, // 連續元素之間的儲存間隔 87 d_A, // GPU 端起始地址 88 1 // 連續元素之間的儲存間隔 89 ); 90 cublasSetVector ( 91 N*M, 92 sizeof(float), 93 h_B, 94 1, 95 d_B, 96 1 97 ); 98 99 // 同步函式 100 cudaThreadSynchronize(); 101 102 // 傳遞進矩陣相乘函式中的引數,具體含義請參考函式手冊。 103 float a=1; float b=0; 104 // 矩陣相乘。該函式必然將陣列解析成列優先陣列 105 cublasSgemm ( 106 handle, // blas 庫物件 107 CUBLAS_OP_T, // 矩陣 A 屬性引數 108 CUBLAS_OP_T, // 矩陣 B 屬性引數 109 M, // A, C 的行數 110 M, // B, C 的列數 111 N, // A 的列數和 B 的行數 112 &a, // 運算式的 α 值 113 d_A, // A 在視訊記憶體中的地址 114 N, // lda 115 d_B, // B 在視訊記憶體中的地址 116 M, // ldb 117 &b, // 運算式的 β 值 118 d_C, // C 在視訊記憶體中的地址(結果矩陣) 119 M // ldc 120 ); 121 122 // 同步函式 123 cudaThreadSynchronize(); 124 125 // 從 視訊記憶體 中取出運算結果至 記憶體中去 126 cublasGetVector ( 127 M*M, // 要取出元素的個數 128 sizeof(float), // 每個元素大小 129 d_C, // GPU 端起始地址 130 1, // 連續元素之間的儲存間隔 131 h_C, // 主機端起始地址 132 1 // 連續元素之間的儲存間隔 133 ); 134 135 // 列印運算結果 136 cout << "計算結果的轉置 ( (A*B)的轉置 ):" << endl; 137 138 for (int i=0;i<M*M; i++){ 139 cout << h_C[i] << " "; 140 if ((i+1)%M == 0) cout << endl; 141 } 142 143 // 清理掉使用過的記憶體 144 free (h_A); 145 free (h_B); 146 free (h_C); 147 cudaFree (d_A); 148 cudaFree (d_B); 149 cudaFree (d_C); 150 151 // 釋放 CUBLAS 庫物件 152 cublasDestroy (handle); 153 154 getchar(); 155 156 return 0; 157 }
執行測試
PS:矩陣元素是隨機生成的
小結
1. 使用 CUDA 庫固然方便,但也要仔細的參閱函式手冊,其中每個引數的含義都要很清晰才不容易出錯。
2. 如果程式僅使用 CUDA 庫的話,用 .cpp 原始碼檔案即可 (不用 .cu)