blob: a653e29f8f10a6516c370522c5164848c2d4a6bc [file] [log] [blame]
Anthony Barbier6ff3b192017-09-04 18:44:23 +01001/*
Giorgio Arena9f7d55a2021-02-08 13:20:24 +00002 * Copyright (c) 2017-2021 Arm Limited.
Anthony Barbier6ff3b192017-09-04 18:44:23 +01003 *
4 * SPDX-License-Identifier: MIT
5 *
6 * Permission is hereby granted, free of charge, to any person obtaining a copy
7 * of this software and associated documentation files (the "Software"), to
8 * deal in the Software without restriction, including without limitation the
9 * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
10 * sell copies of the Software, and to permit persons to whom the Software is
11 * furnished to do so, subject to the following conditions:
12 *
13 * The above copyright notice and this permission notice shall be included in all
14 * copies or substantial portions of the Software.
15 *
16 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
19 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
22 * SOFTWARE.
23 */
Sang-Hoon Parkbef7fa22020-10-21 15:58:54 +010024#include "src/core/CL/kernels/CLGEMMMatrixMultiplyKernel.h"
Anthony Barbier6ff3b192017-09-04 18:44:23 +010025
Anthony Barbier6ff3b192017-09-04 18:44:23 +010026#include "arm_compute/core/CL/CLHelpers.h"
27#include "arm_compute/core/CL/CLKernelLibrary.h"
28#include "arm_compute/core/CL/ICLTensor.h"
29#include "arm_compute/core/CL/OpenCL.h"
Anthony Barbier6ff3b192017-09-04 18:44:23 +010030#include "arm_compute/core/Helpers.h"
Isabella Gottardid56e7702018-02-28 14:29:36 +000031#include "arm_compute/core/TensorInfo.h"
Anthony Barbier6ff3b192017-09-04 18:44:23 +010032#include "arm_compute/core/Utils.h"
Gian Marco36a0a462018-01-12 10:21:40 +000033#include "arm_compute/core/utils/misc/ShapeCalculator.h"
Sang-Hoon Park68dd25f2020-10-19 16:00:11 +010034#include "src/core/AccessWindowStatic.h"
35#include "src/core/CL/CLValidate.h"
36#include "src/core/helpers/AutoConfiguration.h"
37#include "src/core/helpers/WindowHelpers.h"
38#include "src/core/utils/helpers/float_ops.h"
Matthew Bentham758b5ba2020-03-05 23:37:48 +000039#include "support/StringSupport.h"
Anthony Barbier6ff3b192017-09-04 18:44:23 +010040
41#include <set>
Anthony Barbier6ff3b192017-09-04 18:44:23 +010042#include <string>
43
giuros011c9efeb2019-01-11 14:04:43 +000044namespace arm_compute
45{
Gian Marco36a0a462018-01-12 10:21:40 +000046using namespace arm_compute::misc::shape_calculator;
Anthony Barbier6ff3b192017-09-04 18:44:23 +010047
Georgios Pinitas358ca202017-12-07 16:47:52 +000048namespace
49{
50using ElementsProcessed = Steps;
51
Michele Di Giorgioebc3a902018-11-16 16:04:25 +000052inline Status validate_arguments(const ITensorInfo *input0, const ITensorInfo *input1, const ITensorInfo *input2, const ITensorInfo *output, float beta,
53 bool is_interleaved_transposed, const GEMMReshapeInfo &reshape_info, bool fp_mixed_precision)
Georgios Pinitas358ca202017-12-07 16:47:52 +000054{
Georgios Pinitas78c00902018-01-09 17:33:11 +000055 ARM_COMPUTE_RETURN_ERROR_ON_NULLPTR(input0, input1, output);
Vidhya Sudhan Loganathanf1f49062018-05-25 13:21:26 +010056 ARM_COMPUTE_RETURN_ERROR_ON_F16_UNSUPPORTED(input0);
Vidhya Sudhan Loganathan7485d5a2018-07-04 09:34:00 +010057 ARM_COMPUTE_RETURN_ERROR_ON_DATA_TYPE_CHANNEL_NOT_IN(input0, 1, DataType::F16, DataType::F32);
Gian Marco36a0a462018-01-12 10:21:40 +000058 ARM_COMPUTE_RETURN_ERROR_ON_MISMATCHING_DATA_TYPES(input0, input1);
Vidhya Sudhan Loganathana25d16c2018-11-16 11:33:12 +000059 ARM_COMPUTE_RETURN_ERROR_ON_MSG((fp_mixed_precision && (input0->data_type() != DataType::F16)), "Mixed precision floating point is supported only for F16 data");
Isabella Gottardi8e74f442018-03-01 16:42:00 +000060 ARM_COMPUTE_RETURN_ERROR_ON_MSG(input0->num_dimensions() > 4, "The number of dimensions for the matrix A must be <= 4");
Gian Marco Iodiced2fab732018-03-02 11:18:12 +000061 ARM_COMPUTE_RETURN_ERROR_ON_MSG(input1->num_dimensions() > 3, "The number of dimensions for the matrix B must be <= 3");
Gian Marco Iodice68a3f562018-07-26 11:44:03 +010062 ARM_COMPUTE_RETURN_ERROR_ON_MSG(is_interleaved_transposed && reshape_info.reinterpret_input_as_3d(), "The input tensor cannot be reinterpreted as 3D if is_interleaved_transposed is true");
Gian Marco Iodiced39e2b12018-08-06 14:31:15 +010063 ARM_COMPUTE_RETURN_ERROR_ON_MSG(input1->num_dimensions() > 2 && reshape_info.reinterpret_input_as_3d(), "The input1 tensor cannot have more than 2 dimensions if input0 has to be reinterpreted as 3D");
Gian Marco Iodiceb238f5f2019-08-02 09:09:53 +010064 ARM_COMPUTE_RETURN_ERROR_ON_MSG((reshape_info.reinterpret_input_as_3d() || reshape_info.depth_output_gemm3d() != 0) && (input2 != nullptr)
Matthew Bentham758b5ba2020-03-05 23:37:48 +000065 && (!reshape_info.broadcast_bias()),
66 "Bias addition only supported with broadcast mode in case the input or output has to be reinterpreted as 3D");
Gian Marco36a0a462018-01-12 10:21:40 +000067
Georgios Pinitas358ca202017-12-07 16:47:52 +000068 if(!is_interleaved_transposed)
69 {
70 ARM_COMPUTE_RETURN_ERROR_ON(input0->dimension(0) != input1->dimension(1));
Michele Di Giorgioebc3a902018-11-16 16:04:25 +000071
Gian Marco Iodiced1f54762019-07-19 09:54:47 +010072 if(input2 != nullptr && !(helpers::float_ops::is_zero(beta)))
Michele Di Giorgioebc3a902018-11-16 16:04:25 +000073 {
Gian Marco Iodiced1f54762019-07-19 09:54:47 +010074 const unsigned int m = reshape_info.reinterpret_input_as_3d() ? input0->dimension(1) * input0->dimension(2) : input0->dimension(1);
75 const unsigned int n = input1->dimension(0);
76 const unsigned int input2_dim0 = input2->dimension(0);
77 const unsigned int input2_dim1 = input2->dimension(1);
78
79 ARM_COMPUTE_RETURN_ERROR_ON_MISMATCHING_DATA_TYPES(input2, input1);
80 if(reshape_info.broadcast_bias())
81 {
82 ARM_COMPUTE_RETURN_ERROR_ON_MSG((input2_dim1 != 1 || input2_dim0 != n), "Incorrect dimension of bias matrix which is to be broadcasted");
83 }
84 else
85 {
86 ARM_COMPUTE_RETURN_ERROR_ON_MSG((input2_dim0 != n || input2_dim1 != m), "Incorrect dimension of bias matrix");
87 }
Michele Di Giorgioebc3a902018-11-16 16:04:25 +000088 }
Gian Marco36a0a462018-01-12 10:21:40 +000089 }
90 else
91 {
giuros018b6b4a92018-12-18 19:01:33 +000092 GEMMRHSMatrixInfo rhs_info;
giuros011c9efeb2019-01-11 14:04:43 +000093 GEMMLHSMatrixInfo lhs_info;
Gian Marco Iodiced1f54762019-07-19 09:54:47 +010094 const auto m = static_cast<unsigned int>(reshape_info.m());
95 const auto n = static_cast<unsigned int>(reshape_info.n());
giuros018b6b4a92018-12-18 19:01:33 +000096 const int k = reshape_info.k();
97 const int mult_transpose1xW_width = reshape_info.mult_transpose1xW_width();
98 const int mult_interleave4x4_height = reshape_info.mult_interleave4x4_height();
SiCong Li4abc9d12020-10-28 14:19:28 +000099 rhs_info.n0 = max_cl_vector_width / input1->element_size();
giuros018b6b4a92018-12-18 19:01:33 +0000100 rhs_info.k0 = 1;
101 rhs_info.h0 = mult_transpose1xW_width;
102 rhs_info.interleave = false;
103 rhs_info.transpose = false;
giuros011c9efeb2019-01-11 14:04:43 +0000104 lhs_info.m0 = 4;
105 lhs_info.k0 = 4;
106 lhs_info.v0 = mult_interleave4x4_height;
107 lhs_info.interleave = true;
108 lhs_info.transpose = true;
Gian Marco36a0a462018-01-12 10:21:40 +0000109
110 TensorShape tensor_shape0{ input0->tensor_shape() };
111 tensor_shape0.set(0, k);
112 tensor_shape0.set(1, m);
113
114 TensorShape tensor_shape1{ input1->tensor_shape() };
115 tensor_shape1.set(0, n);
116 tensor_shape1.set(1, k);
117
118 const TensorInfo tensor_info0 = input0->clone()->set_tensor_shape(tensor_shape0);
119 const TensorInfo tensor_info1 = input1->clone()->set_tensor_shape(tensor_shape1);
120
giuros011c9efeb2019-01-11 14:04:43 +0000121 const TensorInfo tensor_info_reshaped0 = input0->clone()->set_tensor_shape(compute_lhs_reshaped_shape(tensor_info0, lhs_info));
giuros018b6b4a92018-12-18 19:01:33 +0000122 const TensorInfo tensor_info_reshaped1 = input1->clone()->set_tensor_shape(compute_rhs_reshaped_shape(tensor_info1, rhs_info));
Gian Marco36a0a462018-01-12 10:21:40 +0000123
124 ARM_COMPUTE_RETURN_ERROR_ON_MISMATCHING_SHAPES(input0, &tensor_info_reshaped0);
125 ARM_COMPUTE_RETURN_ERROR_ON_MISMATCHING_SHAPES(input1, &tensor_info_reshaped1);
Michele Di Giorgioebc3a902018-11-16 16:04:25 +0000126
Gian Marco Iodiced1f54762019-07-19 09:54:47 +0100127 if(input2 != nullptr && !(helpers::float_ops::is_zero(beta)))
Michele Di Giorgioebc3a902018-11-16 16:04:25 +0000128 {
Gian Marco Iodiced1f54762019-07-19 09:54:47 +0100129 const unsigned int input2_dim0 = input2->dimension(0);
130 const unsigned int input2_dim1 = input2->dimension(1);
131
132 ARM_COMPUTE_RETURN_ERROR_ON_MISMATCHING_DATA_TYPES(input2, input1);
133 if(reshape_info.broadcast_bias())
134 {
135 ARM_COMPUTE_RETURN_ERROR_ON_MSG((input2_dim1 != 1 || input2_dim0 != n), "Incorrect dimension of bias matrix which is to be broadcasted");
136 }
137 else
138 {
139 ARM_COMPUTE_RETURN_ERROR_ON_MSG((input2_dim0 != n || input2_dim1 != m), "Incorrect dimension of bias matrix");
140 }
Michele Di Giorgioebc3a902018-11-16 16:04:25 +0000141 }
Isabella Gottardi8e74f442018-03-01 16:42:00 +0000142 }
Gian Marco36a0a462018-01-12 10:21:40 +0000143
Isabella Gottardi8e74f442018-03-01 16:42:00 +0000144 if(output->total_size() != 0)
145 {
146 const TensorInfo tensor_info_output = output->clone()->set_tensor_shape(compute_mm_shape(*input0, *input1, is_interleaved_transposed, reshape_info));
147 ARM_COMPUTE_RETURN_ERROR_ON_MISMATCHING_SHAPES(output, &tensor_info_output);
148 ARM_COMPUTE_RETURN_ERROR_ON_MISMATCHING_DATA_TYPES(input0, output);
Georgios Pinitas358ca202017-12-07 16:47:52 +0000149 }
150
151 return Status{};
152}
153
Michele Di Giorgioebc3a902018-11-16 16:04:25 +0000154inline std::pair<Status, Window> validate_and_configure_window(ITensorInfo *input0, ITensorInfo *input1, ITensorInfo *input2, ITensorInfo *output,
155 float beta, bool is_interleaved_transposed, const GEMMReshapeInfo &reshape_info, GPUTarget gpu_target,
Georgios Pinitas358ca202017-12-07 16:47:52 +0000156 ElementsProcessed &num_elements_processed)
157{
Michele Di Giorgioebc3a902018-11-16 16:04:25 +0000158 ARM_COMPUTE_UNUSED(beta);
Georgios Pinitas358ca202017-12-07 16:47:52 +0000159 bool window_changed = false;
160 Window win{};
Isabella Gottardi8e74f442018-03-01 16:42:00 +0000161 Window win_out{};
Georgios Pinitas358ca202017-12-07 16:47:52 +0000162
163 const DataType data_type = input0->data_type();
164 unsigned int &num_elems_processed_per_iteration_x = num_elements_processed[0];
165 unsigned int &num_elems_processed_per_iteration_y = num_elements_processed[1];
Gian Marco Iodiced39e2b12018-08-06 14:31:15 +0100166 bool reinterpret_input_as_3d = reshape_info.reinterpret_input_as_3d();
Gian Marco Iodice3139f032018-11-05 14:26:32 +0000167 bool reinterpret_output_as_3d = (reshape_info.depth_output_gemm3d() != 0);
Gian Marco Iodiced39e2b12018-08-06 14:31:15 +0100168
169 // In case both input and output have to be reinterpreted as 3D tensors,
170 // force reinterpret_input_as_3d and reinterpret_output_as_3d to be false.
171 if(reinterpret_input_as_3d == reinterpret_output_as_3d)
172 {
173 reinterpret_input_as_3d = false;
174 reinterpret_output_as_3d = false;
175 }
Georgios Pinitas358ca202017-12-07 16:47:52 +0000176
Gian Marco Iodice750641d2018-05-08 12:01:57 +0100177 // Output tensor auto inizialitation if not yet initialized
Isabella Gottardic4f582e2018-10-11 19:14:55 +0100178 auto_init_if_empty(*output, input0->clone()->set_tensor_shape(compute_mm_shape(*input0, *input1, is_interleaved_transposed, reshape_info)));
Gian Marco Iodice750641d2018-05-08 12:01:57 +0100179
Isabella Gottardi8e74f442018-03-01 16:42:00 +0000180 TensorInfo tmp_info(*output);
181
Gian Marco Iodiced39e2b12018-08-06 14:31:15 +0100182 if(reinterpret_output_as_3d)
Isabella Gottardi8e74f442018-03-01 16:42:00 +0000183 {
184 // Since the output tensor has to be reinterpreted as 3D and the execute window is based on a 2D GEMM,
185 // the window needs to be constructed on the 2D collapsed version of the tensor
186 TensorShape tmp_shape(output->tensor_shape());
187 tmp_shape.collapse(2U, 1U);
188 tmp_info.set_tensor_shape(tmp_shape);
189 }
190
Georgios Pinitas358ca202017-12-07 16:47:52 +0000191 if(is_interleaved_transposed)
192 {
Gian Marco Iodice68a3f562018-07-26 11:44:03 +0100193 // reinterpret_input_as_3d is not supported if is_interleaved_transposed is set
Isabella Gottardic4f582e2018-10-11 19:14:55 +0100194 ARM_COMPUTE_ERROR_ON(reshape_info.reinterpret_input_as_3d());
Gian Marco Iodice68a3f562018-07-26 11:44:03 +0100195
Georgios Pinitas358ca202017-12-07 16:47:52 +0000196 // Configure kernel window
197 num_elems_processed_per_iteration_x = max_cl_vector_width / data_size_from_type(data_type);
198 num_elems_processed_per_iteration_y = 4;
199
SiCong Li0ea50e32020-11-05 09:18:11 +0000200 win = calculate_max_window(tmp_info, Steps(num_elems_processed_per_iteration_x, num_elems_processed_per_iteration_y));
Gian Marco Iodiced1f54762019-07-19 09:54:47 +0100201 if(input2 != nullptr)
Michele Di Giorgioebc3a902018-11-16 16:04:25 +0000202 {
Gian Marco Iodiced1f54762019-07-19 09:54:47 +0100203 const int bias_processed_per_iteration_x = num_elems_processed_per_iteration_x;
204
205 const int bias_processed_per_iteration_y = reshape_info.broadcast_bias() ? 1 : num_elems_processed_per_iteration_y;
206
207 AccessWindowStatic input2_access(input2, 0, 0,
208 ceil_to_multiple(input2->dimension(0), bias_processed_per_iteration_x),
209 ceil_to_multiple(input2->dimension(1), bias_processed_per_iteration_y));
210
SiCong Li0ea50e32020-11-05 09:18:11 +0000211 window_changed = update_window_and_padding(win, input2_access); // window used by the execute_window_loop
Gian Marco Iodiced1f54762019-07-19 09:54:47 +0100212 }
Georgios Pinitas358ca202017-12-07 16:47:52 +0000213 }
214 else // The input tensors have not been reshaped
215 {
216 // Special case for 1xN, 2xN, 3xN and 4xN input0 tensor. num_elems_processed_per_iteration_x is set up for the default case.
217 num_elems_processed_per_iteration_x = max_cl_vector_width / data_size_from_type(data_type);
218 num_elems_processed_per_iteration_y = std::min(static_cast<int>(output->dimension(1)), 4);
219
220 // Create kernels according to the architecture, data type and input size.
Michalis Spyroua9676112018-02-22 18:07:43 +0000221 GPUTarget arch_target = get_arch_from_target(gpu_target);
222 if(arch_target == GPUTarget::BIFROST && data_type == DataType::F32)
Georgios Pinitas358ca202017-12-07 16:47:52 +0000223 {
Gian Marco1d25ed52017-12-16 19:33:50 +0000224 num_elems_processed_per_iteration_x = (input1->dimension(0) <= 1000 && input0->num_dimensions() == 1) ? 2 : 4;
Georgios Pinitas358ca202017-12-07 16:47:52 +0000225 }
226
227 // Configure window
Isabella Gottardi8e74f442018-03-01 16:42:00 +0000228 win = calculate_max_window(tmp_info, Steps(num_elems_processed_per_iteration_x, num_elems_processed_per_iteration_y));
229 win_out = calculate_max_window(*output, Steps(num_elems_processed_per_iteration_x, num_elems_processed_per_iteration_y));
SiCong Li0ea50e32020-11-05 09:18:11 +0000230 AccessWindowStatic input0_access(input0, 0, 0, input0->dimension(0), input0->dimension(1));
Isabella Gottardi8e74f442018-03-01 16:42:00 +0000231 AccessWindowStatic input1_access(input1, 0, 0, ceil_to_multiple(input1->dimension(0), num_elems_processed_per_iteration_x), input1->dimension(1));
232 AccessWindowStatic output_access(output, 0, 0,
SiCong Li0ea50e32020-11-05 09:18:11 +0000233 output->dimension(0),
234 output->dimension(1));
Georgios Pinitas358ca202017-12-07 16:47:52 +0000235
Gian Marco Iodiced1f54762019-07-19 09:54:47 +0100236 if(input2 != nullptr)
Michele Di Giorgioebc3a902018-11-16 16:04:25 +0000237 {
Gian Marco Iodiced1f54762019-07-19 09:54:47 +0100238 const int bias_processed_per_iteration_x = num_elems_processed_per_iteration_x;
239
Gian Marco Iodiced1f54762019-07-19 09:54:47 +0100240 AccessWindowStatic input2_access(input2, 0, 0,
241 ceil_to_multiple(input2->dimension(0), bias_processed_per_iteration_x),
SiCong Li0ea50e32020-11-05 09:18:11 +0000242 input2->dimension(1));
Gian Marco Iodiced1f54762019-07-19 09:54:47 +0100243
244 window_changed = update_window_and_padding(win, input0_access, input1_access, input2_access) || // window used by the execute_window_loop
245 update_window_and_padding(win_out, output_access); // window used to update the padding requirements of output tensor
246 }
247 else
248 {
249 window_changed = update_window_and_padding(win, input0_access, input1_access) || // window used by the execute_window_loop
250 update_window_and_padding(win_out, output_access); // window used to update the padding requirements of output tensor
Michele Di Giorgioebc3a902018-11-16 16:04:25 +0000251 }
Georgios Pinitas358ca202017-12-07 16:47:52 +0000252
253 Coordinates coord;
254 coord.set_num_dimensions(output->num_dimensions());
Isabella Gottardi8e74f442018-03-01 16:42:00 +0000255 output_access.set_valid_region(win_out, ValidRegion(coord, output->tensor_shape()));
Georgios Pinitas358ca202017-12-07 16:47:52 +0000256 }
257
Gian Marcoae2af742018-02-15 12:35:44 +0000258 // Collapse along the Z direction
259 // This collapse needs to be here in order to tune the Z dimension of LWS
Gian Marco Iodice81b28c42018-03-29 10:29:36 +0100260 Window collapsed = win;
261 const unsigned int dimension_to_collapse = std::min(static_cast<unsigned int>(output->num_dimensions()), 2u);
262 collapsed = win.collapse(win, dimension_to_collapse);
Gian Marcoae2af742018-02-15 12:35:44 +0000263
Georgios Pinitas358ca202017-12-07 16:47:52 +0000264 Status err = (window_changed) ? ARM_COMPUTE_CREATE_ERROR(ErrorCode::RUNTIME_ERROR, "Insufficient Padding!") : Status{};
Gian Marcoae2af742018-02-15 12:35:44 +0000265 return std::make_pair(err, collapsed);
Georgios Pinitas358ca202017-12-07 16:47:52 +0000266}
267} // namespace
268
Anthony Barbier6ff3b192017-09-04 18:44:23 +0100269CLGEMMMatrixMultiplyKernel::CLGEMMMatrixMultiplyKernel()
Gian Marco Iodiced1f54762019-07-19 09:54:47 +0100270 : _input0(nullptr), _input1(nullptr), _input2(nullptr), _output(nullptr), _slide_matrix_b(true), _reinterpret_input_as_3d(false), _reinterpret_output_as_3d(false), _add_bias(false),
271 _broadcast_bias(false)
Anthony Barbier6ff3b192017-09-04 18:44:23 +0100272{
273}
274
Michele Di Giorgioebc3a902018-11-16 16:04:25 +0000275void CLGEMMMatrixMultiplyKernel::configure(const ICLTensor *input0, const ICLTensor *input1, const ICLTensor *input2, ICLTensor *output, float alpha, float beta,
Gian Marco Iodiced1f54762019-07-19 09:54:47 +0100276 bool is_interleaved_transposed, const GEMMReshapeInfo &reshape_info, bool fp_mixed_precision, const ActivationLayerInfo &activation_info)
Anthony Barbier6ff3b192017-09-04 18:44:23 +0100277{
Manuel Bottini4c6bd512020-04-08 10:15:51 +0100278 configure(CLKernelLibrary::get().get_compile_context(), input0, input1, input2, output, alpha, beta, is_interleaved_transposed, reshape_info, fp_mixed_precision, activation_info);
279}
280
Sang-Hoon Park68dd25f2020-10-19 16:00:11 +0100281void CLGEMMMatrixMultiplyKernel::configure(const CLCompileContext &compile_context, const ICLTensor *input0, const ICLTensor *input1, const ICLTensor *input2, ICLTensor *output, float alpha,
282 float beta,
Manuel Bottini4c6bd512020-04-08 10:15:51 +0100283 bool is_interleaved_transposed, const GEMMReshapeInfo &reshape_info, bool fp_mixed_precision, const ActivationLayerInfo &activation_info)
284{
Georgios Pinitas358ca202017-12-07 16:47:52 +0000285 ARM_COMPUTE_ERROR_ON_NULLPTR(input0, input1, output);
286
287 // Perform validate step
Michele Di Giorgioebc3a902018-11-16 16:04:25 +0000288 ARM_COMPUTE_ERROR_THROW_ON(validate_arguments(input0->info(), input1->info(), (input2 != nullptr) ? input2->info() : nullptr, output->info(), beta,
289 is_interleaved_transposed, reshape_info, fp_mixed_precision));
Anthony Barbier6ff3b192017-09-04 18:44:23 +0100290
SiCong Li0ea50e32020-11-05 09:18:11 +0000291 auto padding_info = is_interleaved_transposed ? get_padding_info({ input0, input1, output }) : get_padding_info({ input0, output });
292
Gian Marco Iodice68a3f562018-07-26 11:44:03 +0100293 _input0 = input0;
294 _input1 = input1;
Gian Marco Iodiced1f54762019-07-19 09:54:47 +0100295 _input2 = helpers::float_ops::is_zero(beta) ? nullptr : input2;
Gian Marco Iodice68a3f562018-07-26 11:44:03 +0100296 _output = output;
297 _reinterpret_input_as_3d = reshape_info.reinterpret_input_as_3d();
Gian Marco Iodice3139f032018-11-05 14:26:32 +0000298 _reinterpret_output_as_3d = (reshape_info.depth_output_gemm3d() != 0);
Gian Marco Iodiced1f54762019-07-19 09:54:47 +0100299 _add_bias = _input2 != nullptr;
300 _broadcast_bias = reshape_info.broadcast_bias();
Gian Marco Iodice68a3f562018-07-26 11:44:03 +0100301
Gian Marco Iodiced39e2b12018-08-06 14:31:15 +0100302 // In case both input and output have to be reinterpreted as 3D tensors,
303 // force reinterpret_input_as_3d and reinterpret_output_as_3d to be false.
304 if(_reinterpret_input_as_3d == _reinterpret_output_as_3d)
305 {
306 _reinterpret_input_as_3d = false;
307 _reinterpret_output_as_3d = false;
308 }
309
Gian Marco Iodice68a3f562018-07-26 11:44:03 +0100310 // Check if we need to slide the matrix B
311 const unsigned int num_dimensions_input0 = _reinterpret_input_as_3d ? _input0->info()->num_dimensions() - 1 : _input0->info()->num_dimensions();
312
313 _slide_matrix_b = (_input1->info()->num_dimensions() >= num_dimensions_input0);
Anthony Barbier6ff3b192017-09-04 18:44:23 +0100314
Isabella Gottardi8e74f442018-03-01 16:42:00 +0000315 const DataType data_type = input0->info()->data_type();
Isabella Gottardi8e74f442018-03-01 16:42:00 +0000316
317 // Get target architecture
318 GPUTarget gpu_target = get_target();
319
Georgios Pinitas358ca202017-12-07 16:47:52 +0000320 ElementsProcessed num_elements_processed{};
321
322 // Configure kernel window
Michele Di Giorgioebc3a902018-11-16 16:04:25 +0000323 auto win_config = validate_and_configure_window(input0->info(), input1->info(), (input2 != nullptr) ? input2->info() : nullptr, output->info(), beta, is_interleaved_transposed, reshape_info,
324 gpu_target, num_elements_processed);
Georgios Pinitas358ca202017-12-07 16:47:52 +0000325 ARM_COMPUTE_ERROR_THROW_ON(win_config.first);
Anthony Barbierb6eb3532018-08-08 13:20:04 +0100326 ICLKernel::configure_internal(win_config.second);
Georgios Pinitas358ca202017-12-07 16:47:52 +0000327
SiCong Li0ea50e32020-11-05 09:18:11 +0000328 // If _reinterpret_input_as_3d = _reinterpret_output_as_3d = true, both will be turned off (false)
329 // in which case we will dispatch a batched-GEMM to reduce the complexity of the address calculation within the OpenCL kernel.
330 // This means that the actual m used by the kernel is given by output->info()->dimension(1)
331 const unsigned int internal_m = _reinterpret_output_as_3d ? output->info()->dimension(1) * output->info()->dimension(2) : output->info()->dimension(1);
332 const unsigned int n = output->info()->dimension(0);
333
SiCong Li4abc9d12020-10-28 14:19:28 +0000334 const unsigned int h_gemm_3d = _reinterpret_output_as_3d ? output->info()->dimension(1) : input0->info()->dimension(1);
335 const unsigned int d_gemm_3d = _reinterpret_output_as_3d ? output->info()->dimension(2) : input0->info()->dimension(2);
336
337 const unsigned int m0 = num_elements_processed.y();
338 const unsigned int n0 = num_elements_processed.x();
339
SiCong Li0ea50e32020-11-05 09:18:11 +0000340 // Calculate partial (store instead of load) M0 and partial N0 for the partial blocks at the end of a row/column if any. This is to avoid padding.
341 const unsigned int partial_store_m0 = internal_m % m0;
342 const unsigned int partial_store_n0 = n % n0;
343
Anton Lokhmotov3e80c7f2017-11-20 11:02:10 +0000344 // Create build options
345 CLBuildOptions build_opts;
Anton Lokhmotov3e80c7f2017-11-20 11:02:10 +0000346
Gian Marco Iodiced1f54762019-07-19 09:54:47 +0100347 build_opts.add_option_if(!(helpers::float_ops::is_one(alpha)), "-DALPHA=" + float_to_string_with_full_precision(alpha));
348 build_opts.add_option_if(_input2 != nullptr, "-DBETA=" + float_to_string_with_full_precision(beta));
349 build_opts.add_option_if(helpers::float_ops::is_one(beta), "-DUNIT_BETA");
350 build_opts.add_option_if(reshape_info.broadcast_bias(), "-DBROADCAST_BIAS");
Gian Marco Iodice68a3f562018-07-26 11:44:03 +0100351 build_opts.add_option_if(_reinterpret_input_as_3d, "-DREINTERPRET_INPUT_AS_3D");
352 build_opts.add_option_if(_reinterpret_output_as_3d, "-DREINTERPRET_OUTPUT_AS_3D");
SiCong Li4abc9d12020-10-28 14:19:28 +0000353 build_opts.add_option_if(_reinterpret_input_as_3d || _reinterpret_output_as_3d, "-DHEIGHT_GEMM3D=" + support::cpp11::to_string(h_gemm_3d));
354 build_opts.add_option_if(_reinterpret_input_as_3d || _reinterpret_output_as_3d, "-DDEPTH_GEMM3D=" + support::cpp11::to_string(d_gemm_3d));
Gian Marco Iodiced2fab732018-03-02 11:18:12 +0000355 build_opts.add_option_if(!_slide_matrix_b, "-DMATRIX_B_DEPTH=" + support::cpp11::to_string(input1->info()->dimension(2)));
Gian Marco Iodiced1f54762019-07-19 09:54:47 +0100356 build_opts.add_option_if(activation_info.enabled(), "-DACTIVATION_TYPE=" + lower_string(string_from_activation_func(activation_info.activation())));
357 build_opts.add_option_if(activation_info.enabled(), "-DA_VAL=" + float_to_string_with_full_precision(activation_info.a()));
358 build_opts.add_option_if(activation_info.enabled(), "-DB_VAL=" + float_to_string_with_full_precision(activation_info.b()));
Gian Marco Iodiced2fab732018-03-02 11:18:12 +0000359
Gian Marco Iodicebb36a8e2018-04-19 12:05:08 +0100360 const bool is_bifrost = get_arch_from_target(gpu_target) == GPUTarget::BIFROST;
361
Anton Lokhmotov3e80c7f2017-11-20 11:02:10 +0000362 std::string kernel_name;
Gian Marco Iodiceedfa9f42017-08-15 11:45:22 +0100363 if(is_interleaved_transposed)
Anthony Barbier6ff3b192017-09-04 18:44:23 +0100364 {
Gian Marco36a0a462018-01-12 10:21:40 +0000365 const int mult_transpose1xW_width = reshape_info.mult_transpose1xW_width();
366 const int mult_interleave4x4_height = reshape_info.mult_interleave4x4_height();
367
SiCong Li0ea50e32020-11-05 09:18:11 +0000368 build_opts.add_option("-DM=" + support::cpp11::to_string(internal_m));
369 build_opts.add_option("-DN=" + support::cpp11::to_string(n));
SiCong Li4abc9d12020-10-28 14:19:28 +0000370 build_opts.add_option("-DK=" + support::cpp11::to_string(input1->info()->dimension(0) / (n0 * mult_transpose1xW_width)));
371 build_opts.add_option("-DH0=" + support::cpp11::to_string(mult_transpose1xW_width));
372 build_opts.add_option("-DV0=" + support::cpp11::to_string(mult_interleave4x4_height));
SiCong Li0ea50e32020-11-05 09:18:11 +0000373 build_opts.add_option("-DPARTIAL_STORE_M0=" + support::cpp11::to_string(partial_store_m0));
374 build_opts.add_option("-DPARTIAL_STORE_N0=" + support::cpp11::to_string(partial_store_n0));
Gian Marco36a0a462018-01-12 10:21:40 +0000375
Gian Marco Iodicebb36a8e2018-04-19 12:05:08 +0100376 if(is_data_type_float(data_type) && is_bifrost)
Anthony Barbier6ff3b192017-09-04 18:44:23 +0100377 {
Gian Marco Iodicebb36a8e2018-04-19 12:05:08 +0100378 kernel_name = "gemm_mm_interleaved_transposed_" + lower_string(string_from_data_type(data_type)) + "_bifrost";
Anthony Barbier6ff3b192017-09-04 18:44:23 +0100379 }
380 else
381 {
Anton Lokhmotov3e80c7f2017-11-20 11:02:10 +0000382 kernel_name = "gemm_mm_interleaved_transposed_" + lower_string(string_from_data_type(data_type));
Vidhya Sudhan Loganathan38d93bd2018-11-20 15:38:13 +0000383 if(fp_mixed_precision && data_type == DataType::F16)
384 {
385 // currently wider accumulator is only supported for fp16 kernels.
386 kernel_name += "_acc32";
387 }
Anthony Barbier6ff3b192017-09-04 18:44:23 +0100388 }
Anthony Barbier6ff3b192017-09-04 18:44:23 +0100389 }
Gian Marco Iodiceedfa9f42017-08-15 11:45:22 +0100390 else // The input tensors have not been reshaped
391 {
SiCong Li0ea50e32020-11-05 09:18:11 +0000392 build_opts.add_option("-DN=" + support::cpp11::to_string(n));
SiCong Li4abc9d12020-10-28 14:19:28 +0000393 build_opts.add_option("-DK=" + support::cpp11::to_string(input0->info()->dimension(0)));
Gian Marco Iodicee52a3002018-04-11 15:59:10 +0100394 build_opts.add_option("-DDATA_TYPE=" + get_cl_type_from_data_type(data_type));
SiCong Li0ea50e32020-11-05 09:18:11 +0000395 build_opts.add_option("-DM0=" + support::cpp11::to_string(m0));
396 build_opts.add_option("-DN0=" + support::cpp11::to_string(n0));
397 build_opts.add_option("-DPARTIAL_STORE_M0=" + support::cpp11::to_string(partial_store_m0));
398 build_opts.add_option("-DPARTIAL_STORE_N0=" + support::cpp11::to_string(partial_store_n0));
Gian Marco Iodiceedfa9f42017-08-15 11:45:22 +0100399
Anton Lokhmotov3e80c7f2017-11-20 11:02:10 +0000400 // Create kernels according to the architecture, data type and input size.
Gian Marco Iodicebb36a8e2018-04-19 12:05:08 +0100401 if(is_data_type_float(data_type) && is_bifrost)
Gian Marco Iodiceedfa9f42017-08-15 11:45:22 +0100402 {
Gian Marco Iodicee52a3002018-04-11 15:59:10 +0100403 kernel_name = "gemm_mm_floating_point";
404
405 if(input0->info()->num_dimensions() != 1)
Gian Marco Iodicefd683112018-04-17 09:52:44 +0100406 {
Gian Marco Iodicee52a3002018-04-11 15:59:10 +0100407 kernel_name += "_" + lower_string(string_from_data_type(data_type)) + "_bifrost";
Vidhya Sudhan Loganathan38d93bd2018-11-20 15:38:13 +0000408 if(fp_mixed_precision && data_type == DataType::F16)
409 {
410 // currently wider accumulator is only supported for fp16 kernels.
411 kernel_name += "_acc32";
412 }
Gian Marco Iodicee52a3002018-04-11 15:59:10 +0100413 }
414 else if(input1->info()->dimension(0) <= 1000 && data_type == DataType::F32)
415 {
416 // The first kernel is optimized for the case of 1000 or less output elements (e.g. FC8 of AlexNet and VGG-16, and
417 // FC1 of Inception v3). The second kernel is optimized for the case of greater than 1000 output elements (e.g.
418 // FC6 and FC7 of AlexNet and VGG-16).
419 kernel_name += "_" + lower_string(string_from_data_type(data_type)) + "_bifrost_1000";
Gian Marco Iodicefd683112018-04-17 09:52:44 +0100420 }
Georgios Pinitas358ca202017-12-07 16:47:52 +0000421
Anton Lokhmotov3e80c7f2017-11-20 11:02:10 +0000422 // The work-group size equal to the Bifrost quad size has been proved to be optimal for these kernels
423 // via exhaustive autotuning over a range of representative layer configurations.
Anthony Barbierb6eb3532018-08-08 13:20:04 +0100424 set_lws_hint(cl::NDRange(4));
Gian Marco Iodiceedfa9f42017-08-15 11:45:22 +0100425 }
Anton Lokhmotov3e80c7f2017-11-20 11:02:10 +0000426 else // (MIDGARD and F32) or (F16)
427 {
Anton Lokhmotov3e80c7f2017-11-20 11:02:10 +0000428 kernel_name = "gemm_mm_floating_point";
429 }
Gian Marco Iodiceedfa9f42017-08-15 11:45:22 +0100430 }
Anton Lokhmotov3e80c7f2017-11-20 11:02:10 +0000431
432 // Create kernel
Manuel Bottini4c6bd512020-04-08 10:15:51 +0100433 _kernel = create_kernel(compile_context, kernel_name, build_opts.options());
Anton Lokhmotov3e80c7f2017-11-20 11:02:10 +0000434
435 // Set config_id for enabling LWS tuning
436 _config_id = "gemm_";
437 _config_id += (is_interleaved_transposed ? "reshaped_" : "");
Gian Marco Iodiced1f54762019-07-19 09:54:47 +0100438 _config_id += (_add_bias ? "add_bias_" : "");
439 _config_id += (_broadcast_bias ? "broadcast_bias_" : "");
Vidhya Sudhan Loganathana25d16c2018-11-16 11:33:12 +0000440 _config_id += (fp_mixed_precision ? "fp_mixed_" : "");
Gian Marco Iodice68a3f562018-07-26 11:44:03 +0100441 _config_id += (_reinterpret_input_as_3d ? "3di_" : "");
442 _config_id += (_reinterpret_output_as_3d ? "3do_" : "");
Anton Lokhmotov3e80c7f2017-11-20 11:02:10 +0000443 _config_id += lower_string(string_from_data_type(input0->info()->data_type()));
444 _config_id += "_";
445 _config_id += support::cpp11::to_string(output->info()->dimension(1));
446 _config_id += "_";
447 _config_id += support::cpp11::to_string(output->info()->dimension(0));
448 _config_id += "_";
Gian Marcoae2af742018-02-15 12:35:44 +0000449 _config_id += support::cpp11::to_string(output->info()->dimension(2));
450 _config_id += "_";
451 _config_id += support::cpp11::to_string(output->info()->dimension(3));
452 _config_id += "_";
Anton Lokhmotov3e80c7f2017-11-20 11:02:10 +0000453 _config_id += (is_interleaved_transposed ? support::cpp11::to_string(input1->info()->dimension(0)) : support::cpp11::to_string(input1->info()->dimension(1)));
SiCong Li0ea50e32020-11-05 09:18:11 +0000454
455 ARM_COMPUTE_ERROR_ON(has_padding_changed(padding_info));
Anthony Barbier6ff3b192017-09-04 18:44:23 +0100456}
457
Michele Di Giorgioebc3a902018-11-16 16:04:25 +0000458Status CLGEMMMatrixMultiplyKernel::validate(const ITensorInfo *input0, const ITensorInfo *input1, const ITensorInfo *input2, const ITensorInfo *output, float alpha, float beta,
Gian Marco Iodiced1f54762019-07-19 09:54:47 +0100459 bool is_interleaved_transposed, const GEMMReshapeInfo &reshape_info, GPUTarget gpu_target, bool fp_mixed_precision, const ActivationLayerInfo &activation_info)
Georgios Pinitas358ca202017-12-07 16:47:52 +0000460{
Gian Marco36a0a462018-01-12 10:21:40 +0000461 // Note: num_elements_processed will be set in validate_and_configure_window()
Georgios Pinitas358ca202017-12-07 16:47:52 +0000462 ElementsProcessed num_elements_processed{};
463 ARM_COMPUTE_UNUSED(alpha);
Gian Marco Iodiced1f54762019-07-19 09:54:47 +0100464 ARM_COMPUTE_UNUSED(activation_info);
Michele Di Giorgioebc3a902018-11-16 16:04:25 +0000465 ARM_COMPUTE_RETURN_ON_ERROR(validate_arguments(input0, input1, input2, output, beta, is_interleaved_transposed, reshape_info, fp_mixed_precision));
Georgios Pinitas358ca202017-12-07 16:47:52 +0000466 ARM_COMPUTE_RETURN_ON_ERROR(validate_and_configure_window(input0->clone().get(),
467 input1->clone().get(),
Michele Di Giorgioebc3a902018-11-16 16:04:25 +0000468 (input2 != nullptr) ? input2->clone().get() : nullptr,
Georgios Pinitas358ca202017-12-07 16:47:52 +0000469 output->clone().get(),
Michele Di Giorgioebc3a902018-11-16 16:04:25 +0000470 beta,
Georgios Pinitas358ca202017-12-07 16:47:52 +0000471 is_interleaved_transposed,
Gian Marco Iodice750641d2018-05-08 12:01:57 +0100472 reshape_info,
Georgios Pinitas358ca202017-12-07 16:47:52 +0000473 gpu_target,
474 num_elements_processed)
475 .first);
476
477 return Status{};
478}
479
Anthony Barbier6ff3b192017-09-04 18:44:23 +0100480void CLGEMMMatrixMultiplyKernel::run(const Window &window, cl::CommandQueue &queue)
481{
482 ARM_COMPUTE_ERROR_ON_UNCONFIGURED_KERNEL(this);
483 ARM_COMPUTE_ERROR_ON_INVALID_SUBWINDOW(ICLKernel::window(), window);
484
Gian Marcoae2af742018-02-15 12:35:44 +0000485 if(_input1->info()->num_dimensions() < 3)
486 {
Giorgio Arena9f7d55a2021-02-08 13:20:24 +0000487 // The stride_w for matrix B must be the same as stride_z if we do not slice
488 ARM_COMPUTE_ERROR_ON(_input1->info()->strides_in_bytes()[3] != _input1->info()->strides_in_bytes()[2]);
Gian Marcoae2af742018-02-15 12:35:44 +0000489 }
490
491 Window slice = window.first_slice_window_3D();
Anthony Barbier6ff3b192017-09-04 18:44:23 +0100492 Window slice_matrix_b = slice;
Gian Marco Iodiceedfa9f42017-08-15 11:45:22 +0100493
494 slice_matrix_b.set(Window::DimX, Window::Dimension(0, 1, 1));
495 slice_matrix_b.set(Window::DimY, Window::Dimension(0, 1, 1));
Anthony Barbier6ff3b192017-09-04 18:44:23 +0100496
Gian Marco Iodiced1f54762019-07-19 09:54:47 +0100497 const unsigned int num_arguments_bias = _add_bias ? num_arguments_per_2D_tensor() + 1 : 0;
Michele Di Giorgioebc3a902018-11-16 16:04:25 +0000498
Gian Marco Iodice68a3f562018-07-26 11:44:03 +0100499 if(_reinterpret_input_as_3d)
Isabella Gottardi8e74f442018-03-01 16:42:00 +0000500 {
Isabella Gottardib92805b2018-09-28 18:24:27 +0100501 // Pass bottom paddings to the kernel if the input has to be reinterpreted as 3D tensor
Gian Marco Iodiced1f54762019-07-19 09:54:47 +0100502 const unsigned int idx0 = 3 * num_arguments_per_2D_tensor() + 3 + num_arguments_bias;
Gian Marco Iodice68a3f562018-07-26 11:44:03 +0100503 const unsigned int total_cross_plane_pad = _input0->info()->padding().top + _input0->info()->padding().bottom;
504 _kernel.setArg<cl_uint>(idx0, static_cast<unsigned int>(total_cross_plane_pad));
505 }
506
507 if(_reinterpret_output_as_3d)
508 {
509 // Pass bottom paddings to the kernel if the output has to be reinterpreted as 3D tensor
Gian Marco Iodiced1f54762019-07-19 09:54:47 +0100510 const unsigned int idx0 = 3 * num_arguments_per_2D_tensor() + 3 + (_reinterpret_input_as_3d ? 1 : 0) + num_arguments_bias;
Georgios Pinitase8bd2c72018-07-11 15:54:56 +0100511 const unsigned int total_cross_plane_pad = _output->info()->padding().top + _output->info()->padding().bottom;
512 _kernel.setArg<cl_uint>(idx0, static_cast<unsigned int>(total_cross_plane_pad));
Isabella Gottardi8e74f442018-03-01 16:42:00 +0000513 }
514
Anthony Barbier6ff3b192017-09-04 18:44:23 +0100515 do
516 {
517 Window slice_b = slice;
518 // Don't slice matrix B along the z dimension if matrix B has just 2 dimensions and matrix A more than 2
Gian Marcoae2af742018-02-15 12:35:44 +0000519 // This scenario can happen when the matrix multiplication is used to perform a convolution operation
Gian Marco Iodiced2fab732018-03-02 11:18:12 +0000520 if(!_slide_matrix_b)
Anthony Barbier6ff3b192017-09-04 18:44:23 +0100521 {
522 slice_b = slice_matrix_b;
523 }
524
525 unsigned int idx = 0;
526 add_2D_tensor_argument(idx, _input0, slice);
527 add_2D_tensor_argument(idx, _input1, slice_b);
Gian Marco Iodiced1f54762019-07-19 09:54:47 +0100528 if(_add_bias)
Michele Di Giorgioebc3a902018-11-16 16:04:25 +0000529 {
Gian Marco Iodiced1f54762019-07-19 09:54:47 +0100530 add_2D_tensor_argument(idx, _input2, slice);
Michele Di Giorgioebc3a902018-11-16 16:04:25 +0000531 }
Anthony Barbier6ff3b192017-09-04 18:44:23 +0100532 add_2D_tensor_argument(idx, _output, slice);
Gian Marco Iodiced2fab732018-03-02 11:18:12 +0000533 _kernel.setArg<cl_uint>(idx++, static_cast<unsigned int>(_input0->info()->strides_in_bytes()[2]));
534 _kernel.setArg<cl_uint>(idx++, static_cast<unsigned int>(_input1->info()->strides_in_bytes()[2]));
Gian Marco Iodiced1f54762019-07-19 09:54:47 +0100535 if(_add_bias)
536 {
537 _kernel.setArg<cl_uint>(idx++, static_cast<unsigned int>(_input2->info()->strides_in_bytes()[2]));
538 }
Gian Marco Iodiced2fab732018-03-02 11:18:12 +0000539 _kernel.setArg<cl_uint>(idx++, static_cast<unsigned int>(_output->info()->strides_in_bytes()[2]));
Anthony Barbierb6eb3532018-08-08 13:20:04 +0100540 enqueue(queue, *this, slice, lws_hint());
Anthony Barbier6ff3b192017-09-04 18:44:23 +0100541 }
Gian Marcoae2af742018-02-15 12:35:44 +0000542 while(window.slide_window_slice_3D(slice));
Anthony Barbier6ff3b192017-09-04 18:44:23 +0100543}
giuros011c9efeb2019-01-11 14:04:43 +0000544} // namespace arm_compute