xref: /libCEED/backends/hip-gen/ceed-hip-gen-operator.c (revision efa41df35aba6fbf99ee55a3580c03081f41c595)
1 // Copyright (c) 2017-2024, Lawrence Livermore National Security, LLC and other CEED contributors.
2 // All Rights Reserved. See the top-level LICENSE and NOTICE files for details.
3 //
4 // SPDX-License-Identifier: BSD-2-Clause
5 //
6 // This file is part of CEED:  http://github.com/ceed
7 
8 #include <ceed.h>
9 #include <ceed/backend.h>
10 #include <ceed/jit-source/hip/hip-types.h>
11 #include <stddef.h>
12 #include <hip/hiprtc.h>
13 
14 #include "../hip/ceed-hip-common.h"
15 #include "../hip/ceed-hip-compile.h"
16 #include "ceed-hip-gen-operator-build.h"
17 #include "ceed-hip-gen.h"
18 
19 //------------------------------------------------------------------------------
20 // Destroy operator
21 //------------------------------------------------------------------------------
22 static int CeedOperatorDestroy_Hip_gen(CeedOperator op) {
23   Ceed                  ceed;
24   CeedOperator_Hip_gen *impl;
25 
26   CeedCallBackend(CeedOperatorGetCeed(op, &ceed));
27   CeedCallBackend(CeedOperatorGetData(op, &impl));
28   if (impl->points.num_per_elem) CeedCallHip(ceed, hipFree((void **)impl->points.num_per_elem));
29   CeedCallBackend(CeedFree(&impl));
30   CeedCallBackend(CeedDestroy(&ceed));
31   return CEED_ERROR_SUCCESS;
32 }
33 
34 //------------------------------------------------------------------------------
35 // Apply and add to output
36 //------------------------------------------------------------------------------
37 static int CeedOperatorApplyAddCore_Hip_gen(CeedOperator op, hipStream_t stream, const CeedScalar *input_arr, CeedScalar *output_arr,
38                                             bool *is_run_good, CeedRequest *request) {
39   bool                   is_at_points, is_tensor;
40   Ceed                   ceed;
41   CeedInt                num_elem, num_input_fields, num_output_fields;
42   CeedEvalMode           eval_mode;
43   CeedQFunctionField    *qf_input_fields, *qf_output_fields;
44   CeedQFunction_Hip_gen *qf_data;
45   CeedQFunction          qf;
46   CeedOperatorField     *op_input_fields, *op_output_fields;
47   CeedOperator_Hip_gen  *data;
48 
49   // Creation of the operator
50   CeedCallBackend(CeedOperatorBuildKernel_Hip_gen(op, is_run_good));
51   if (!(*is_run_good)) return CEED_ERROR_SUCCESS;
52 
53   CeedCallBackend(CeedOperatorGetCeed(op, &ceed));
54   CeedCallBackend(CeedOperatorGetData(op, &data));
55   CeedCallBackend(CeedOperatorGetQFunction(op, &qf));
56   CeedCallBackend(CeedQFunctionGetData(qf, &qf_data));
57   CeedCallBackend(CeedOperatorGetNumElements(op, &num_elem));
58   CeedCallBackend(CeedOperatorGetFields(op, &num_input_fields, &op_input_fields, &num_output_fields, &op_output_fields));
59   CeedCallBackend(CeedQFunctionGetFields(qf, NULL, &qf_input_fields, NULL, &qf_output_fields));
60 
61   // Input vectors
62   for (CeedInt i = 0; i < num_input_fields; i++) {
63     CeedCallBackend(CeedQFunctionFieldGetEvalMode(qf_input_fields[i], &eval_mode));
64     if (eval_mode == CEED_EVAL_WEIGHT) {  // Skip
65       data->fields.inputs[i] = NULL;
66     } else {
67       bool       is_active;
68       CeedVector vec;
69 
70       // Get input vector
71       CeedCallBackend(CeedOperatorFieldGetVector(op_input_fields[i], &vec));
72       is_active = vec == CEED_VECTOR_ACTIVE;
73       if (is_active) data->fields.inputs[i] = input_arr;
74       else CeedCallBackend(CeedVectorGetArrayRead(vec, CEED_MEM_DEVICE, &data->fields.inputs[i]));
75       CeedCallBackend(CeedVectorDestroy(&vec));
76     }
77   }
78 
79   // Output vectors
80   for (CeedInt i = 0; i < num_output_fields; i++) {
81     CeedCallBackend(CeedQFunctionFieldGetEvalMode(qf_output_fields[i], &eval_mode));
82     if (eval_mode == CEED_EVAL_WEIGHT) {  // Skip
83       data->fields.outputs[i] = NULL;
84     } else {
85       bool       is_active;
86       CeedVector vec;
87 
88       // Get output vector
89       CeedCallBackend(CeedOperatorFieldGetVector(op_output_fields[i], &vec));
90       is_active = vec == CEED_VECTOR_ACTIVE;
91       if (is_active) data->fields.outputs[i] = output_arr;
92       else CeedCallBackend(CeedVectorGetArray(vec, CEED_MEM_DEVICE, &data->fields.outputs[i]));
93       CeedCallBackend(CeedVectorDestroy(&vec));
94     }
95   }
96 
97   // Point coordinates, if needed
98   CeedCallBackend(CeedOperatorIsAtPoints(op, &is_at_points));
99   if (is_at_points) {
100     // Coords
101     CeedVector vec;
102 
103     CeedCallBackend(CeedOperatorAtPointsGetPoints(op, NULL, &vec));
104     CeedCallBackend(CeedVectorGetArrayRead(vec, CEED_MEM_DEVICE, &data->points.coords));
105     CeedCallBackend(CeedVectorDestroy(&vec));
106 
107     // Points per elem
108     if (num_elem != data->points.num_elem) {
109       CeedInt            *points_per_elem;
110       const CeedInt       num_bytes   = num_elem * sizeof(CeedInt);
111       CeedElemRestriction rstr_points = NULL;
112 
113       data->points.num_elem = num_elem;
114       CeedCallBackend(CeedOperatorAtPointsGetPoints(op, &rstr_points, NULL));
115       CeedCallBackend(CeedCalloc(num_elem, &points_per_elem));
116       for (CeedInt e = 0; e < num_elem; e++) {
117         CeedInt num_points_elem;
118 
119         CeedCallBackend(CeedElemRestrictionGetNumPointsInElement(rstr_points, e, &num_points_elem));
120         points_per_elem[e] = num_points_elem;
121       }
122       if (data->points.num_per_elem) CeedCallHip(ceed, hipFree((void **)data->points.num_per_elem));
123       CeedCallHip(ceed, hipMalloc((void **)&data->points.num_per_elem, num_bytes));
124       CeedCallHip(ceed, hipMemcpy((void *)data->points.num_per_elem, points_per_elem, num_bytes, hipMemcpyHostToDevice));
125       CeedCallBackend(CeedElemRestrictionDestroy(&rstr_points));
126       CeedCallBackend(CeedFree(&points_per_elem));
127     }
128   }
129 
130   // Get context data
131   CeedCallBackend(CeedQFunctionGetInnerContextData(qf, CEED_MEM_DEVICE, &qf_data->d_c));
132 
133   // Apply operator
134   void *opargs[] = {(void *)&num_elem, &qf_data->d_c, &data->indices, &data->fields, &data->B, &data->G, &data->W, &data->points};
135 
136   CeedCallBackend(CeedOperatorHasTensorBases(op, &is_tensor));
137   const CeedInt thread_1d = CeedIntMax(is_tensor ? data->Q_1d : data->Q, data->max_P_1d);
138 
139   CeedInt block_sizes[3] = {thread_1d, ((!is_tensor || data->dim == 1) ? 1 : thread_1d), -1};
140 
141   if (is_tensor) {
142     CeedCallBackend(BlockGridCalculate_Hip_gen(data->dim, num_elem, data->max_P_1d, data->Q_1d, block_sizes));
143     if (is_at_points) block_sizes[2] = 1;
144   } else {
145     CeedInt elems_per_block = 64 * thread_1d > 256 ? 256 / thread_1d : 64;
146 
147     elems_per_block = elems_per_block > 0 ? elems_per_block : 1;
148     block_sizes[2]  = elems_per_block;
149   }
150   if (data->dim == 1 || !is_tensor) {
151     CeedInt grid      = num_elem / block_sizes[2] + ((num_elem / block_sizes[2] * block_sizes[2] < num_elem) ? 1 : 0);
152     CeedInt sharedMem = block_sizes[2] * thread_1d * sizeof(CeedScalar);
153 
154     CeedCallBackend(
155         CeedTryRunKernelDimShared_Hip(ceed, data->op, stream, grid, block_sizes[0], block_sizes[1], block_sizes[2], sharedMem, is_run_good, opargs));
156   } else if (data->dim == 2) {
157     CeedInt grid      = num_elem / block_sizes[2] + ((num_elem / block_sizes[2] * block_sizes[2] < num_elem) ? 1 : 0);
158     CeedInt sharedMem = block_sizes[2] * thread_1d * thread_1d * sizeof(CeedScalar);
159 
160     CeedCallBackend(
161         CeedTryRunKernelDimShared_Hip(ceed, data->op, stream, grid, block_sizes[0], block_sizes[1], block_sizes[2], sharedMem, is_run_good, opargs));
162   } else if (data->dim == 3) {
163     CeedInt grid      = num_elem / block_sizes[2] + ((num_elem / block_sizes[2] * block_sizes[2] < num_elem) ? 1 : 0);
164     CeedInt sharedMem = block_sizes[2] * thread_1d * thread_1d * sizeof(CeedScalar);
165 
166     CeedCallBackend(
167         CeedTryRunKernelDimShared_Hip(ceed, data->op, stream, grid, block_sizes[0], block_sizes[1], block_sizes[2], sharedMem, is_run_good, opargs));
168   }
169 
170   // Restore input arrays
171   for (CeedInt i = 0; i < num_input_fields; i++) {
172     CeedCallBackend(CeedQFunctionFieldGetEvalMode(qf_input_fields[i], &eval_mode));
173     if (eval_mode == CEED_EVAL_WEIGHT) {  // Skip
174     } else {
175       bool       is_active;
176       CeedVector vec;
177 
178       CeedCallBackend(CeedOperatorFieldGetVector(op_input_fields[i], &vec));
179       is_active = vec == CEED_VECTOR_ACTIVE;
180       if (!is_active) CeedCallBackend(CeedVectorRestoreArrayRead(vec, &data->fields.inputs[i]));
181       CeedCallBackend(CeedVectorDestroy(&vec));
182     }
183   }
184 
185   // Restore output arrays
186   for (CeedInt i = 0; i < num_output_fields; i++) {
187     CeedCallBackend(CeedQFunctionFieldGetEvalMode(qf_output_fields[i], &eval_mode));
188     if (eval_mode == CEED_EVAL_WEIGHT) {  // Skip
189     } else {
190       bool       is_active;
191       CeedVector vec;
192 
193       CeedCallBackend(CeedOperatorFieldGetVector(op_output_fields[i], &vec));
194       is_active = vec == CEED_VECTOR_ACTIVE;
195       if (!is_active) CeedCallBackend(CeedVectorRestoreArray(vec, &data->fields.outputs[i]));
196       CeedCallBackend(CeedVectorDestroy(&vec));
197     }
198   }
199 
200   // Restore point coordinates, if needed
201   if (is_at_points) {
202     CeedVector vec;
203 
204     CeedCallBackend(CeedOperatorAtPointsGetPoints(op, NULL, &vec));
205     CeedCallBackend(CeedVectorRestoreArrayRead(vec, &data->points.coords));
206     CeedCallBackend(CeedVectorDestroy(&vec));
207   }
208 
209   // Restore context data
210   CeedCallBackend(CeedQFunctionRestoreInnerContextData(qf, &qf_data->d_c));
211 
212   // Cleanup
213   CeedCallBackend(CeedDestroy(&ceed));
214   CeedCallBackend(CeedQFunctionDestroy(&qf));
215   if (!(*is_run_good)) data->use_fallback = true;
216   return CEED_ERROR_SUCCESS;
217 }
218 
219 static int CeedOperatorApplyAdd_Hip_gen(CeedOperator op, CeedVector input_vec, CeedVector output_vec, CeedRequest *request) {
220   bool              is_run_good = false;
221   const CeedScalar *input_arr   = NULL;
222   CeedScalar       *output_arr  = NULL;
223 
224   // Try to run kernel
225   if (input_vec != CEED_VECTOR_NONE) CeedCallBackend(CeedVectorGetArrayRead(input_vec, CEED_MEM_DEVICE, &input_arr));
226   if (output_vec != CEED_VECTOR_NONE) CeedCallBackend(CeedVectorGetArray(output_vec, CEED_MEM_DEVICE, &output_arr));
227   CeedCallBackend(CeedOperatorApplyAddCore_Hip_gen(op, NULL, input_arr, output_arr, &is_run_good, request));
228   if (input_vec != CEED_VECTOR_NONE) CeedCallBackend(CeedVectorRestoreArrayRead(input_vec, &input_arr));
229   if (output_vec != CEED_VECTOR_NONE) CeedCallBackend(CeedVectorRestoreArray(output_vec, &output_arr));
230 
231   // Fallback on unsuccessful run
232   if (!is_run_good) {
233     CeedOperator op_fallback;
234 
235     CeedDebug256(CeedOperatorReturnCeed(op), CEED_DEBUG_COLOR_SUCCESS, "Falling back to /gpu/hip/ref CeedOperator");
236     CeedCallBackend(CeedOperatorGetFallback(op, &op_fallback));
237     CeedCallBackend(CeedOperatorApplyAdd(op_fallback, input_vec, output_vec, request));
238   }
239   return CEED_ERROR_SUCCESS;
240 }
241 
242 static int CeedOperatorApplyAddComposite_Hip_gen(CeedOperator op, CeedVector input_vec, CeedVector output_vec, CeedRequest *request) {
243   bool              is_run_good[CEED_COMPOSITE_MAX] = {false};
244   CeedInt           num_suboperators;
245   const CeedScalar *input_arr  = NULL;
246   CeedScalar       *output_arr = NULL;
247   Ceed              ceed;
248   CeedOperator     *sub_operators;
249 
250   CeedCallBackend(CeedOperatorGetCeed(op, &ceed));
251   CeedCall(CeedCompositeOperatorGetNumSub(op, &num_suboperators));
252   CeedCall(CeedCompositeOperatorGetSubList(op, &sub_operators));
253   if (input_vec != CEED_VECTOR_NONE) CeedCallBackend(CeedVectorGetArrayRead(input_vec, CEED_MEM_DEVICE, &input_arr));
254   if (output_vec != CEED_VECTOR_NONE) CeedCallBackend(CeedVectorGetArray(output_vec, CEED_MEM_DEVICE, &output_arr));
255   for (CeedInt i = 0; i < num_suboperators; i++) {
256     CeedInt num_elem = 0;
257 
258     CeedCall(CeedOperatorGetNumElements(sub_operators[i], &num_elem));
259     if (num_elem > 0) {
260       hipStream_t stream = NULL;
261 
262       CeedCallHip(ceed, hipStreamCreate(&stream));
263       CeedCallBackend(CeedOperatorApplyAddCore_Hip_gen(sub_operators[i], stream, input_arr, output_arr, &is_run_good[i], request));
264       CeedCallHip(ceed, hipStreamDestroy(stream));
265     }
266   }
267   if (input_vec != CEED_VECTOR_NONE) CeedCallBackend(CeedVectorRestoreArrayRead(input_vec, &input_arr));
268   if (output_vec != CEED_VECTOR_NONE) CeedCallBackend(CeedVectorRestoreArray(output_vec, &output_arr));
269   CeedCallHip(ceed, hipDeviceSynchronize());
270 
271   // Fallback on unsuccessful run
272   for (CeedInt i = 0; i < num_suboperators; i++) {
273     if (!is_run_good[i]) {
274       CeedOperator op_fallback;
275 
276       CeedDebug256(ceed, CEED_DEBUG_COLOR_SUCCESS, "Falling back to /gpu/hip/ref CeedOperator");
277       CeedCallBackend(CeedOperatorGetFallback(sub_operators[i], &op_fallback));
278       CeedCallBackend(CeedOperatorApplyAdd(op_fallback, input_vec, output_vec, request));
279     }
280   }
281   CeedCallBackend(CeedDestroy(&ceed));
282   return CEED_ERROR_SUCCESS;
283 }
284 
285 //------------------------------------------------------------------------------
286 // Create operator
287 //------------------------------------------------------------------------------
288 int CeedOperatorCreate_Hip_gen(CeedOperator op) {
289   bool                  is_composite;
290   Ceed                  ceed;
291   CeedOperator_Hip_gen *impl;
292 
293   CeedCallBackend(CeedOperatorGetCeed(op, &ceed));
294   CeedCallBackend(CeedCalloc(1, &impl));
295   CeedCallBackend(CeedOperatorSetData(op, impl));
296   CeedCall(CeedOperatorIsComposite(op, &is_composite));
297   if (is_composite) {
298     CeedCallBackend(CeedSetBackendFunction(ceed, "Operator", op, "ApplyAddComposite", CeedOperatorApplyAddComposite_Hip_gen));
299   } else {
300     CeedCallBackend(CeedSetBackendFunction(ceed, "Operator", op, "ApplyAdd", CeedOperatorApplyAdd_Hip_gen));
301   }
302   CeedCallBackend(CeedSetBackendFunction(ceed, "Operator", op, "Destroy", CeedOperatorDestroy_Hip_gen));
303   CeedCallBackend(CeedDestroy(&ceed));
304   return CEED_ERROR_SUCCESS;
305 }
306 
307 //------------------------------------------------------------------------------
308