blob: b3ea309c93a5968a08bbdfe24f6185e15e5d3b26 [file] [log] [blame]
Anthony Barbier6ff3b192017-09-04 18:44:23 +01001/*
giuros011c9efeb2019-01-11 14:04:43 +00002 * Copyright (c) 2017-2019 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 */
24#include "arm_compute/core/CL/kernels/CLGEMMMatrixMultiplyKernel.h"
25
26#include "arm_compute/core/AccessWindowStatic.h"
Anthony Barbier6ff3b192017-09-04 18:44:23 +010027#include "arm_compute/core/CL/CLHelpers.h"
28#include "arm_compute/core/CL/CLKernelLibrary.h"
Vidhya Sudhan Loganathanf1f49062018-05-25 13:21:26 +010029#include "arm_compute/core/CL/CLValidate.h"
Anthony Barbier6ff3b192017-09-04 18:44:23 +010030#include "arm_compute/core/CL/ICLTensor.h"
31#include "arm_compute/core/CL/OpenCL.h"
32#include "arm_compute/core/Error.h"
33#include "arm_compute/core/Helpers.h"
Isabella Gottardid56e7702018-02-28 14:29:36 +000034#include "arm_compute/core/TensorInfo.h"
Anthony Barbier6ff3b192017-09-04 18:44:23 +010035#include "arm_compute/core/Types.h"
36#include "arm_compute/core/Utils.h"
Anthony Barbier6ff3b192017-09-04 18:44:23 +010037#include "arm_compute/core/Window.h"
Gian Marco Iodice82d9dd12019-06-10 16:45:40 +010038#include "arm_compute/core/utils/helpers/float_ops.h"
Gian Marco36a0a462018-01-12 10:21:40 +000039#include "arm_compute/core/utils/misc/ShapeCalculator.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 Marco36a0a462018-01-12 10:21:40 +000064
Michele Di Giorgioebc3a902018-11-16 16:04:25 +000065 const bool is_beta_one = std::abs(1.0f - beta) < 0.00001f;
66 const bool has_vec_c = input2 != nullptr && beta != 0.f;
67 ARM_COMPUTE_RETURN_ERROR_ON_MSG(has_vec_c && !is_beta_one, "Adding input2 is only supported for beta equal to 1");
68
Georgios Pinitas358ca202017-12-07 16:47:52 +000069 if(!is_interleaved_transposed)
70 {
71 ARM_COMPUTE_RETURN_ERROR_ON(input0->dimension(0) != input1->dimension(1));
Michele Di Giorgioebc3a902018-11-16 16:04:25 +000072
73 if(has_vec_c)
74 {
75 ARM_COMPUTE_RETURN_ERROR_ON_MISMATCHING_DATA_TYPES(input0, input2);
76 ARM_COMPUTE_RETURN_ERROR_ON_MSG(input2->num_dimensions() > 1, "input2 must be a 1D tensor");
77 ARM_COMPUTE_RETURN_ERROR_ON_MSG(input2->dimension(0) != input1->dimension(0), "Length of Vector C must match the number of columns of matrix B");
78 }
Gian Marco36a0a462018-01-12 10:21:40 +000079 }
80 else
81 {
giuros018b6b4a92018-12-18 19:01:33 +000082 GEMMRHSMatrixInfo rhs_info;
giuros011c9efeb2019-01-11 14:04:43 +000083 GEMMLHSMatrixInfo lhs_info;
giuros018b6b4a92018-12-18 19:01:33 +000084 const int m = reshape_info.m();
85 const int n = reshape_info.n();
86 const int k = reshape_info.k();
87 const int mult_transpose1xW_width = reshape_info.mult_transpose1xW_width();
88 const int mult_interleave4x4_height = reshape_info.mult_interleave4x4_height();
89 rhs_info.n0 = 16 / input1->element_size();
90 rhs_info.k0 = 1;
91 rhs_info.h0 = mult_transpose1xW_width;
92 rhs_info.interleave = false;
93 rhs_info.transpose = false;
giuros011c9efeb2019-01-11 14:04:43 +000094 lhs_info.m0 = 4;
95 lhs_info.k0 = 4;
96 lhs_info.v0 = mult_interleave4x4_height;
97 lhs_info.interleave = true;
98 lhs_info.transpose = true;
Gian Marco36a0a462018-01-12 10:21:40 +000099
100 TensorShape tensor_shape0{ input0->tensor_shape() };
101 tensor_shape0.set(0, k);
102 tensor_shape0.set(1, m);
103
104 TensorShape tensor_shape1{ input1->tensor_shape() };
105 tensor_shape1.set(0, n);
106 tensor_shape1.set(1, k);
107
108 const TensorInfo tensor_info0 = input0->clone()->set_tensor_shape(tensor_shape0);
109 const TensorInfo tensor_info1 = input1->clone()->set_tensor_shape(tensor_shape1);
110
giuros011c9efeb2019-01-11 14:04:43 +0000111 const TensorInfo tensor_info_reshaped0 = input0->clone()->set_tensor_shape(compute_lhs_reshaped_shape(tensor_info0, lhs_info));
giuros018b6b4a92018-12-18 19:01:33 +0000112 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 +0000113
114 ARM_COMPUTE_RETURN_ERROR_ON_MISMATCHING_SHAPES(input0, &tensor_info_reshaped0);
115 ARM_COMPUTE_RETURN_ERROR_ON_MISMATCHING_SHAPES(input1, &tensor_info_reshaped1);
Michele Di Giorgioebc3a902018-11-16 16:04:25 +0000116
117 if(has_vec_c)
118 {
119 ARM_COMPUTE_RETURN_ERROR_ON_MISMATCHING_DATA_TYPES(input0, input2);
120 ARM_COMPUTE_RETURN_ERROR_ON_MSG(input2->num_dimensions() > 1, "input2 must be a 1D tensor");
121 }
Isabella Gottardi8e74f442018-03-01 16:42:00 +0000122 }
Gian Marco36a0a462018-01-12 10:21:40 +0000123
Isabella Gottardi8e74f442018-03-01 16:42:00 +0000124 if(output->total_size() != 0)
125 {
126 const TensorInfo tensor_info_output = output->clone()->set_tensor_shape(compute_mm_shape(*input0, *input1, is_interleaved_transposed, reshape_info));
127 ARM_COMPUTE_RETURN_ERROR_ON_MISMATCHING_SHAPES(output, &tensor_info_output);
128 ARM_COMPUTE_RETURN_ERROR_ON_MISMATCHING_DATA_TYPES(input0, output);
Georgios Pinitas358ca202017-12-07 16:47:52 +0000129 }
130
131 return Status{};
132}
133
Michele Di Giorgioebc3a902018-11-16 16:04:25 +0000134inline std::pair<Status, Window> validate_and_configure_window(ITensorInfo *input0, ITensorInfo *input1, ITensorInfo *input2, ITensorInfo *output,
135 float beta, bool is_interleaved_transposed, const GEMMReshapeInfo &reshape_info, GPUTarget gpu_target,
Georgios Pinitas358ca202017-12-07 16:47:52 +0000136 ElementsProcessed &num_elements_processed)
137{
Michele Di Giorgioebc3a902018-11-16 16:04:25 +0000138 ARM_COMPUTE_UNUSED(beta);
Georgios Pinitas358ca202017-12-07 16:47:52 +0000139 bool window_changed = false;
140 Window win{};
Isabella Gottardi8e74f442018-03-01 16:42:00 +0000141 Window win_out{};
Georgios Pinitas358ca202017-12-07 16:47:52 +0000142
143 const DataType data_type = input0->data_type();
144 unsigned int &num_elems_processed_per_iteration_x = num_elements_processed[0];
145 unsigned int &num_elems_processed_per_iteration_y = num_elements_processed[1];
Gian Marco Iodiced39e2b12018-08-06 14:31:15 +0100146 bool reinterpret_input_as_3d = reshape_info.reinterpret_input_as_3d();
Gian Marco Iodice3139f032018-11-05 14:26:32 +0000147 bool reinterpret_output_as_3d = (reshape_info.depth_output_gemm3d() != 0);
Michele Di Giorgioebc3a902018-11-16 16:04:25 +0000148 const bool has_vec_c = input2 != nullptr && beta != 0.f;
Gian Marco Iodiced39e2b12018-08-06 14:31:15 +0100149
150 // In case both input and output have to be reinterpreted as 3D tensors,
151 // force reinterpret_input_as_3d and reinterpret_output_as_3d to be false.
152 if(reinterpret_input_as_3d == reinterpret_output_as_3d)
153 {
154 reinterpret_input_as_3d = false;
155 reinterpret_output_as_3d = false;
156 }
Georgios Pinitas358ca202017-12-07 16:47:52 +0000157
Gian Marco Iodice750641d2018-05-08 12:01:57 +0100158 // Output tensor auto inizialitation if not yet initialized
Isabella Gottardic4f582e2018-10-11 19:14:55 +0100159 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 +0100160
Isabella Gottardi8e74f442018-03-01 16:42:00 +0000161 TensorInfo tmp_info(*output);
162
Gian Marco Iodiced39e2b12018-08-06 14:31:15 +0100163 if(reinterpret_output_as_3d)
Isabella Gottardi8e74f442018-03-01 16:42:00 +0000164 {
165 // Since the output tensor has to be reinterpreted as 3D and the execute window is based on a 2D GEMM,
166 // the window needs to be constructed on the 2D collapsed version of the tensor
167 TensorShape tmp_shape(output->tensor_shape());
168 tmp_shape.collapse(2U, 1U);
169 tmp_info.set_tensor_shape(tmp_shape);
170 }
171
Georgios Pinitas358ca202017-12-07 16:47:52 +0000172 if(is_interleaved_transposed)
173 {
Gian Marco Iodice68a3f562018-07-26 11:44:03 +0100174 // reinterpret_input_as_3d is not supported if is_interleaved_transposed is set
Isabella Gottardic4f582e2018-10-11 19:14:55 +0100175 ARM_COMPUTE_ERROR_ON(reshape_info.reinterpret_input_as_3d());
Gian Marco Iodice68a3f562018-07-26 11:44:03 +0100176
Georgios Pinitas358ca202017-12-07 16:47:52 +0000177 // Configure kernel window
178 num_elems_processed_per_iteration_x = max_cl_vector_width / data_size_from_type(data_type);
179 num_elems_processed_per_iteration_y = 4;
180
Isabella Gottardi8e74f442018-03-01 16:42:00 +0000181 // Note: bottom paddings are calculated manually as the output can be reinterpreted as 3D tensor
182 // The only way to set properly the paddings, it is to set those explicitly through the AccessWindowStatic
183 const int m = reshape_info.m();
184 const int bottom_pad = (num_elems_processed_per_iteration_y - (m % num_elems_processed_per_iteration_y)) % num_elems_processed_per_iteration_y;
185
186 win = calculate_max_window(tmp_info, Steps(num_elems_processed_per_iteration_x, num_elems_processed_per_iteration_y));
187 win_out = calculate_max_window(*output, Steps(num_elems_processed_per_iteration_x, num_elems_processed_per_iteration_y));
Georgios Pinitas358ca202017-12-07 16:47:52 +0000188
Michele Di Giorgio17a01a32019-01-03 15:12:27 +0000189 AccessWindowStatic input0_access(input0, 0, 0, input0->dimension(0), input0->dimension(1));
190 AccessWindowStatic input1_access(input1, 0, 0,
191 ceil_to_multiple(input1->dimension(0), num_elems_processed_per_iteration_x),
192 ceil_to_multiple(input1->dimension(1), num_elems_processed_per_iteration_y));
Isabella Gottardi8e74f442018-03-01 16:42:00 +0000193 AccessWindowStatic output_access(output, 0, 0,
194 ceil_to_multiple(output->dimension(0), num_elems_processed_per_iteration_x),
195 output->dimension(1) + bottom_pad);
Georgios Pinitas358ca202017-12-07 16:47:52 +0000196
Isabella Gottardi8e74f442018-03-01 16:42:00 +0000197 window_changed = update_window_and_padding(win, input0_access, input1_access) || // window used by the execute_window_loop
198 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 +0000199 if(has_vec_c)
200 {
201 AccessWindowHorizontal input2_access(input2, 0, num_elems_processed_per_iteration_x);
202 window_changed = window_changed || update_window_and_padding(win, input2_access);
203 }
Georgios Pinitas358ca202017-12-07 16:47:52 +0000204
Isabella Gottardi8e74f442018-03-01 16:42:00 +0000205 output_access.set_valid_region(win_out, ValidRegion(Coordinates(0, 0), output->tensor_shape()));
Georgios Pinitas358ca202017-12-07 16:47:52 +0000206 }
207 else // The input tensors have not been reshaped
208 {
209 // Special case for 1xN, 2xN, 3xN and 4xN input0 tensor. num_elems_processed_per_iteration_x is set up for the default case.
210 num_elems_processed_per_iteration_x = max_cl_vector_width / data_size_from_type(data_type);
211 num_elems_processed_per_iteration_y = std::min(static_cast<int>(output->dimension(1)), 4);
212
Isabella Gottardi8e74f442018-03-01 16:42:00 +0000213 // Note: bottom paddings are calculated manually as the output can be reinterpreted as 3D tensor
214 // The only way to set properly the paddings, it is to set those explicitly through the AccessWindowStatic
Gian Marco Iodiced39e2b12018-08-06 14:31:15 +0100215 const int m = reinterpret_input_as_3d ? input0->tensor_shape()[1] * input0->tensor_shape()[2] : input0->tensor_shape()[1];
Isabella Gottardi8e74f442018-03-01 16:42:00 +0000216 const int bottom_pad = (num_elems_processed_per_iteration_y - (m % num_elems_processed_per_iteration_y)) % num_elems_processed_per_iteration_y;
217
Georgios Pinitas358ca202017-12-07 16:47:52 +0000218 // Create kernels according to the architecture, data type and input size.
Michalis Spyroua9676112018-02-22 18:07:43 +0000219 GPUTarget arch_target = get_arch_from_target(gpu_target);
220 if(arch_target == GPUTarget::BIFROST && data_type == DataType::F32)
Georgios Pinitas358ca202017-12-07 16:47:52 +0000221 {
Gian Marco1d25ed52017-12-16 19:33:50 +0000222 num_elems_processed_per_iteration_x = (input1->dimension(0) <= 1000 && input0->num_dimensions() == 1) ? 2 : 4;
Georgios Pinitas358ca202017-12-07 16:47:52 +0000223 }
224
225 // Configure window
Isabella Gottardi8e74f442018-03-01 16:42:00 +0000226 win = calculate_max_window(tmp_info, Steps(num_elems_processed_per_iteration_x, num_elems_processed_per_iteration_y));
227 win_out = calculate_max_window(*output, Steps(num_elems_processed_per_iteration_x, num_elems_processed_per_iteration_y));
Georgios Pinitas358ca202017-12-07 16:47:52 +0000228
Gian Marco Iodice68a3f562018-07-26 11:44:03 +0100229 AccessWindowStatic input0_access(input0, 0, 0, input0->dimension(0), input0->dimension(1) + bottom_pad);
Isabella Gottardi8e74f442018-03-01 16:42:00 +0000230 AccessWindowStatic input1_access(input1, 0, 0, ceil_to_multiple(input1->dimension(0), num_elems_processed_per_iteration_x), input1->dimension(1));
231 AccessWindowStatic output_access(output, 0, 0,
232 ceil_to_multiple(output->dimension(0), num_elems_processed_per_iteration_x),
233 output->dimension(1) + bottom_pad);
Georgios Pinitas358ca202017-12-07 16:47:52 +0000234
Isabella Gottardi8e74f442018-03-01 16:42:00 +0000235 window_changed = update_window_and_padding(win, input0_access, input1_access) || // window used by the execute_window_loop
236 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 +0000237 if(has_vec_c)
238 {
239 AccessWindowHorizontal input2_access(input2, 0, num_elems_processed_per_iteration_x);
240 window_changed = window_changed || update_window_and_padding(win, input2_access);
241 }
Georgios Pinitas358ca202017-12-07 16:47:52 +0000242
243 Coordinates coord;
244 coord.set_num_dimensions(output->num_dimensions());
Isabella Gottardi8e74f442018-03-01 16:42:00 +0000245 output_access.set_valid_region(win_out, ValidRegion(coord, output->tensor_shape()));
Georgios Pinitas358ca202017-12-07 16:47:52 +0000246 }
247
Gian Marcoae2af742018-02-15 12:35:44 +0000248 // Collapse along the Z direction
249 // This collapse needs to be here in order to tune the Z dimension of LWS
Gian Marco Iodice81b28c42018-03-29 10:29:36 +0100250 Window collapsed = win;
251 const unsigned int dimension_to_collapse = std::min(static_cast<unsigned int>(output->num_dimensions()), 2u);
252 collapsed = win.collapse(win, dimension_to_collapse);
Gian Marcoae2af742018-02-15 12:35:44 +0000253
Georgios Pinitas358ca202017-12-07 16:47:52 +0000254 Status err = (window_changed) ? ARM_COMPUTE_CREATE_ERROR(ErrorCode::RUNTIME_ERROR, "Insufficient Padding!") : Status{};
Gian Marcoae2af742018-02-15 12:35:44 +0000255 return std::make_pair(err, collapsed);
Georgios Pinitas358ca202017-12-07 16:47:52 +0000256}
257} // namespace
258
Anthony Barbier6ff3b192017-09-04 18:44:23 +0100259CLGEMMMatrixMultiplyKernel::CLGEMMMatrixMultiplyKernel()
Michele Di Giorgioebc3a902018-11-16 16:04:25 +0000260 : _input0(nullptr), _input1(nullptr), _input2(nullptr), _output(nullptr), _slide_matrix_b(true), _reinterpret_input_as_3d(false), _reinterpret_output_as_3d(false), _has_vec_c(false)
Anthony Barbier6ff3b192017-09-04 18:44:23 +0100261{
262}
263
Michele Di Giorgioebc3a902018-11-16 16:04:25 +0000264void CLGEMMMatrixMultiplyKernel::configure(const ICLTensor *input0, const ICLTensor *input1, const ICLTensor *input2, ICLTensor *output, float alpha, float beta,
265 bool is_interleaved_transposed, const GEMMReshapeInfo &reshape_info, bool fp_mixed_precision)
Anthony Barbier6ff3b192017-09-04 18:44:23 +0100266{
Georgios Pinitas358ca202017-12-07 16:47:52 +0000267 ARM_COMPUTE_ERROR_ON_NULLPTR(input0, input1, output);
268
269 // Perform validate step
Michele Di Giorgioebc3a902018-11-16 16:04:25 +0000270 ARM_COMPUTE_ERROR_THROW_ON(validate_arguments(input0->info(), input1->info(), (input2 != nullptr) ? input2->info() : nullptr, output->info(), beta,
271 is_interleaved_transposed, reshape_info, fp_mixed_precision));
Anthony Barbier6ff3b192017-09-04 18:44:23 +0100272
Gian Marco Iodice68a3f562018-07-26 11:44:03 +0100273 _input0 = input0;
274 _input1 = input1;
Michele Di Giorgioebc3a902018-11-16 16:04:25 +0000275 _input2 = input2;
Gian Marco Iodice68a3f562018-07-26 11:44:03 +0100276 _output = output;
277 _reinterpret_input_as_3d = reshape_info.reinterpret_input_as_3d();
Gian Marco Iodice3139f032018-11-05 14:26:32 +0000278 _reinterpret_output_as_3d = (reshape_info.depth_output_gemm3d() != 0);
Gian Marco Iodice68a3f562018-07-26 11:44:03 +0100279
Gian Marco Iodiced39e2b12018-08-06 14:31:15 +0100280 // In case both input and output have to be reinterpreted as 3D tensors,
281 // force reinterpret_input_as_3d and reinterpret_output_as_3d to be false.
282 if(_reinterpret_input_as_3d == _reinterpret_output_as_3d)
283 {
284 _reinterpret_input_as_3d = false;
285 _reinterpret_output_as_3d = false;
286 }
287
Gian Marco Iodice68a3f562018-07-26 11:44:03 +0100288 // Check if we need to slide the matrix B
289 const unsigned int num_dimensions_input0 = _reinterpret_input_as_3d ? _input0->info()->num_dimensions() - 1 : _input0->info()->num_dimensions();
290
291 _slide_matrix_b = (_input1->info()->num_dimensions() >= num_dimensions_input0);
Anthony Barbier6ff3b192017-09-04 18:44:23 +0100292
Isabella Gottardi8e74f442018-03-01 16:42:00 +0000293 const DataType data_type = input0->info()->data_type();
Isabella Gottardi8e74f442018-03-01 16:42:00 +0000294
295 // Get target architecture
296 GPUTarget gpu_target = get_target();
297
Georgios Pinitas358ca202017-12-07 16:47:52 +0000298 ElementsProcessed num_elements_processed{};
299
300 // Configure kernel window
Michele Di Giorgioebc3a902018-11-16 16:04:25 +0000301 auto win_config = validate_and_configure_window(input0->info(), input1->info(), (input2 != nullptr) ? input2->info() : nullptr, output->info(), beta, is_interleaved_transposed, reshape_info,
302 gpu_target, num_elements_processed);
Georgios Pinitas358ca202017-12-07 16:47:52 +0000303 ARM_COMPUTE_ERROR_THROW_ON(win_config.first);
Anthony Barbierb6eb3532018-08-08 13:20:04 +0100304 ICLKernel::configure_internal(win_config.second);
Georgios Pinitas358ca202017-12-07 16:47:52 +0000305
Anton Lokhmotov3e80c7f2017-11-20 11:02:10 +0000306 // Create build options
307 CLBuildOptions build_opts;
Anton Lokhmotov3e80c7f2017-11-20 11:02:10 +0000308
Anton Lokhmotov3e80c7f2017-11-20 11:02:10 +0000309 // Only define ALPHA when alpha is not 1.0f. This avoids performing unnecessary multiplications.
Gian Marco Iodice82d9dd12019-06-10 16:45:40 +0100310 if(!(helpers::float_ops::is_one(alpha)))
Anthony Barbier6ff3b192017-09-04 18:44:23 +0100311 {
Vidhya Sudhan Loganathan7485d5a2018-07-04 09:34:00 +0100312 build_opts.add_option("-DALPHA=" + float_to_string_with_full_precision(alpha));
Anthony Barbier6ff3b192017-09-04 18:44:23 +0100313 }
Gian Marco Iodice68a3f562018-07-26 11:44:03 +0100314 build_opts.add_option_if(_reinterpret_input_as_3d, "-DREINTERPRET_INPUT_AS_3D");
315 build_opts.add_option_if(_reinterpret_output_as_3d, "-DREINTERPRET_OUTPUT_AS_3D");
316 build_opts.add_option_if(_reinterpret_input_as_3d || _reinterpret_output_as_3d, "-DHEIGHT_GEMM3D=" + support::cpp11::to_string(output->info()->dimension(1)));
317 build_opts.add_option_if(_reinterpret_input_as_3d || _reinterpret_output_as_3d, "-DDEPTH_GEMM3D=" + support::cpp11::to_string(output->info()->dimension(2)));
Anthony Barbier6ff3b192017-09-04 18:44:23 +0100318
Gian Marco Iodiced2fab732018-03-02 11:18:12 +0000319 // Do not slide matrix B if _slide_matrix_b = false
320 build_opts.add_option_if(!_slide_matrix_b, "-DMATRIX_B_DEPTH=" + support::cpp11::to_string(input1->info()->dimension(2)));
321
Gian Marco Iodicebb36a8e2018-04-19 12:05:08 +0100322 const bool is_bifrost = get_arch_from_target(gpu_target) == GPUTarget::BIFROST;
323
Michele Di Giorgioebc3a902018-11-16 16:04:25 +0000324 _has_vec_c = input2 != nullptr && beta != 0.f;
325
Anton Lokhmotov3e80c7f2017-11-20 11:02:10 +0000326 std::string kernel_name;
Gian Marco Iodiceedfa9f42017-08-15 11:45:22 +0100327 if(is_interleaved_transposed)
Anthony Barbier6ff3b192017-09-04 18:44:23 +0100328 {
Gian Marco36a0a462018-01-12 10:21:40 +0000329 const int mult_transpose1xW_width = reshape_info.mult_transpose1xW_width();
330 const int mult_interleave4x4_height = reshape_info.mult_interleave4x4_height();
331
Anton Lokhmotov3e80c7f2017-11-20 11:02:10 +0000332 build_opts.add_option("-DCOLS_B=" + support::cpp11::to_string(input1->info()->dimension(0)));
Gian Marco36a0a462018-01-12 10:21:40 +0000333 build_opts.add_option("-DMULT_TRANSPOSE1XW_WIDTH=" + support::cpp11::to_string(mult_transpose1xW_width));
334 build_opts.add_option("-DMULT_INTERLEAVE4X4_HEIGHT=" + support::cpp11::to_string(mult_interleave4x4_height));
335
Gian Marco Iodicebb36a8e2018-04-19 12:05:08 +0100336 if(is_data_type_float(data_type) && is_bifrost)
Anthony Barbier6ff3b192017-09-04 18:44:23 +0100337 {
Gian Marco Iodicebb36a8e2018-04-19 12:05:08 +0100338 kernel_name = "gemm_mm_interleaved_transposed_" + lower_string(string_from_data_type(data_type)) + "_bifrost";
Anthony Barbier6ff3b192017-09-04 18:44:23 +0100339 }
340 else
341 {
Anton Lokhmotov3e80c7f2017-11-20 11:02:10 +0000342 kernel_name = "gemm_mm_interleaved_transposed_" + lower_string(string_from_data_type(data_type));
Vidhya Sudhan Loganathan38d93bd2018-11-20 15:38:13 +0000343 if(fp_mixed_precision && data_type == DataType::F16)
344 {
345 // currently wider accumulator is only supported for fp16 kernels.
346 kernel_name += "_acc32";
347 }
Anthony Barbier6ff3b192017-09-04 18:44:23 +0100348 }
Anthony Barbier6ff3b192017-09-04 18:44:23 +0100349 }
Gian Marco Iodiceedfa9f42017-08-15 11:45:22 +0100350 else // The input tensors have not been reshaped
351 {
Anton Lokhmotov3e80c7f2017-11-20 11:02:10 +0000352 build_opts.add_option("-DCOLS_A=" + support::cpp11::to_string(input0->info()->dimension(0)));
Gian Marco Iodicee52a3002018-04-11 15:59:10 +0100353 build_opts.add_option("-DDATA_TYPE=" + get_cl_type_from_data_type(data_type));
Gian Marco Iodiceedfa9f42017-08-15 11:45:22 +0100354
Anton Lokhmotov3e80c7f2017-11-20 11:02:10 +0000355 // Create kernels according to the architecture, data type and input size.
Gian Marco Iodicebb36a8e2018-04-19 12:05:08 +0100356 if(is_data_type_float(data_type) && is_bifrost)
Gian Marco Iodiceedfa9f42017-08-15 11:45:22 +0100357 {
Gian Marco Iodicee52a3002018-04-11 15:59:10 +0100358 kernel_name = "gemm_mm_floating_point";
359
360 if(input0->info()->num_dimensions() != 1)
Gian Marco Iodicefd683112018-04-17 09:52:44 +0100361 {
Gian Marco Iodicee52a3002018-04-11 15:59:10 +0100362 kernel_name += "_" + lower_string(string_from_data_type(data_type)) + "_bifrost";
Vidhya Sudhan Loganathan38d93bd2018-11-20 15:38:13 +0000363 if(fp_mixed_precision && data_type == DataType::F16)
364 {
365 // currently wider accumulator is only supported for fp16 kernels.
366 kernel_name += "_acc32";
367 }
Gian Marco Iodicee52a3002018-04-11 15:59:10 +0100368 }
369 else if(input1->info()->dimension(0) <= 1000 && data_type == DataType::F32)
370 {
371 // The first kernel is optimized for the case of 1000 or less output elements (e.g. FC8 of AlexNet and VGG-16, and
372 // FC1 of Inception v3). The second kernel is optimized for the case of greater than 1000 output elements (e.g.
373 // FC6 and FC7 of AlexNet and VGG-16).
374 kernel_name += "_" + lower_string(string_from_data_type(data_type)) + "_bifrost_1000";
Gian Marco Iodicefd683112018-04-17 09:52:44 +0100375 }
Georgios Pinitas358ca202017-12-07 16:47:52 +0000376
Anton Lokhmotov3e80c7f2017-11-20 11:02:10 +0000377 // The work-group size equal to the Bifrost quad size has been proved to be optimal for these kernels
378 // via exhaustive autotuning over a range of representative layer configurations.
Anthony Barbierb6eb3532018-08-08 13:20:04 +0100379 set_lws_hint(cl::NDRange(4));
Gian Marco Iodiceedfa9f42017-08-15 11:45:22 +0100380 }
Anton Lokhmotov3e80c7f2017-11-20 11:02:10 +0000381 else // (MIDGARD and F32) or (F16)
382 {
Anton Lokhmotov3e80c7f2017-11-20 11:02:10 +0000383 kernel_name = "gemm_mm_floating_point";
384 }
Georgios Pinitas358ca202017-12-07 16:47:52 +0000385 build_opts.add_option("-DNUM_ELEMS_PROCESSED_PER_THREAD_Y=" + support::cpp11::to_string(num_elements_processed.y()));
386 build_opts.add_option("-DNUM_ELEMS_PROCESSED_PER_THREAD_X=" + support::cpp11::to_string(num_elements_processed.x()));
Gian Marco Iodiceedfa9f42017-08-15 11:45:22 +0100387 }
Anton Lokhmotov3e80c7f2017-11-20 11:02:10 +0000388
Michele Di Giorgioebc3a902018-11-16 16:04:25 +0000389 // Configure matrix C addition if necessary
390 build_opts.add_option_if(_has_vec_c, "-DADD_VEC_C");
391
Anton Lokhmotov3e80c7f2017-11-20 11:02:10 +0000392 // Create kernel
393 _kernel = static_cast<cl::Kernel>(CLKernelLibrary::get().create_kernel(kernel_name, build_opts.options()));
394
395 // Set config_id for enabling LWS tuning
396 _config_id = "gemm_";
397 _config_id += (is_interleaved_transposed ? "reshaped_" : "");
Vidhya Sudhan Loganathana25d16c2018-11-16 11:33:12 +0000398 _config_id += (fp_mixed_precision ? "fp_mixed_" : "");
Gian Marco Iodice68a3f562018-07-26 11:44:03 +0100399 _config_id += (_reinterpret_input_as_3d ? "3di_" : "");
400 _config_id += (_reinterpret_output_as_3d ? "3do_" : "");
Anton Lokhmotov3e80c7f2017-11-20 11:02:10 +0000401 _config_id += lower_string(string_from_data_type(input0->info()->data_type()));
402 _config_id += "_";
403 _config_id += support::cpp11::to_string(output->info()->dimension(1));
404 _config_id += "_";
405 _config_id += support::cpp11::to_string(output->info()->dimension(0));
406 _config_id += "_";
Gian Marcoae2af742018-02-15 12:35:44 +0000407 _config_id += support::cpp11::to_string(output->info()->dimension(2));
408 _config_id += "_";
409 _config_id += support::cpp11::to_string(output->info()->dimension(3));
410 _config_id += "_";
Anton Lokhmotov3e80c7f2017-11-20 11:02:10 +0000411 _config_id += (is_interleaved_transposed ? support::cpp11::to_string(input1->info()->dimension(0)) : support::cpp11::to_string(input1->info()->dimension(1)));
Anthony Barbier6ff3b192017-09-04 18:44:23 +0100412}
413
Michele Di Giorgioebc3a902018-11-16 16:04:25 +0000414Status CLGEMMMatrixMultiplyKernel::validate(const ITensorInfo *input0, const ITensorInfo *input1, const ITensorInfo *input2, const ITensorInfo *output, float alpha, float beta,
415 bool is_interleaved_transposed, const GEMMReshapeInfo &reshape_info, GPUTarget gpu_target, bool fp_mixed_precision)
Georgios Pinitas358ca202017-12-07 16:47:52 +0000416{
Gian Marco36a0a462018-01-12 10:21:40 +0000417 // Note: num_elements_processed will be set in validate_and_configure_window()
Georgios Pinitas358ca202017-12-07 16:47:52 +0000418 ElementsProcessed num_elements_processed{};
419 ARM_COMPUTE_UNUSED(alpha);
Michele Di Giorgioebc3a902018-11-16 16:04:25 +0000420 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 +0000421 ARM_COMPUTE_RETURN_ON_ERROR(validate_and_configure_window(input0->clone().get(),
422 input1->clone().get(),
Michele Di Giorgioebc3a902018-11-16 16:04:25 +0000423 (input2 != nullptr) ? input2->clone().get() : nullptr,
Georgios Pinitas358ca202017-12-07 16:47:52 +0000424 output->clone().get(),
Michele Di Giorgioebc3a902018-11-16 16:04:25 +0000425 beta,
Georgios Pinitas358ca202017-12-07 16:47:52 +0000426 is_interleaved_transposed,
Gian Marco Iodice750641d2018-05-08 12:01:57 +0100427 reshape_info,
Georgios Pinitas358ca202017-12-07 16:47:52 +0000428 gpu_target,
429 num_elements_processed)
430 .first);
431
432 return Status{};
433}
434
Anthony Barbier6ff3b192017-09-04 18:44:23 +0100435void CLGEMMMatrixMultiplyKernel::run(const Window &window, cl::CommandQueue &queue)
436{
437 ARM_COMPUTE_ERROR_ON_UNCONFIGURED_KERNEL(this);
438 ARM_COMPUTE_ERROR_ON_INVALID_SUBWINDOW(ICLKernel::window(), window);
439
Gian Marcoae2af742018-02-15 12:35:44 +0000440 if(_input1->info()->num_dimensions() < 3)
441 {
442 // The stride_z for matrix B must be zero if we do not slice
443 ARM_COMPUTE_ERROR_ON(_input1->info()->strides_in_bytes()[3] != 0);
444 }
445
446 Window slice = window.first_slice_window_3D();
Anthony Barbier6ff3b192017-09-04 18:44:23 +0100447 Window slice_matrix_b = slice;
Gian Marco Iodiceedfa9f42017-08-15 11:45:22 +0100448
449 slice_matrix_b.set(Window::DimX, Window::Dimension(0, 1, 1));
450 slice_matrix_b.set(Window::DimY, Window::Dimension(0, 1, 1));
Anthony Barbier6ff3b192017-09-04 18:44:23 +0100451
Michele Di Giorgioebc3a902018-11-16 16:04:25 +0000452 const unsigned int num_arguments_vec_c = (_has_vec_c) ? num_arguments_per_1D_tensor() : 0;
453
Gian Marco Iodice68a3f562018-07-26 11:44:03 +0100454 if(_reinterpret_input_as_3d)
Isabella Gottardi8e74f442018-03-01 16:42:00 +0000455 {
Isabella Gottardib92805b2018-09-28 18:24:27 +0100456 // Pass bottom paddings to the kernel if the input has to be reinterpreted as 3D tensor
Michele Di Giorgioebc3a902018-11-16 16:04:25 +0000457 const unsigned int idx0 = 3 * num_arguments_per_2D_tensor() + 3 + num_arguments_vec_c;
Gian Marco Iodice68a3f562018-07-26 11:44:03 +0100458 const unsigned int total_cross_plane_pad = _input0->info()->padding().top + _input0->info()->padding().bottom;
459 _kernel.setArg<cl_uint>(idx0, static_cast<unsigned int>(total_cross_plane_pad));
460 }
461
462 if(_reinterpret_output_as_3d)
463 {
464 // Pass bottom paddings to the kernel if the output has to be reinterpreted as 3D tensor
Michele Di Giorgioebc3a902018-11-16 16:04:25 +0000465 const unsigned int idx0 = 3 * num_arguments_per_2D_tensor() + 3 + (_reinterpret_input_as_3d ? 1 : 0) + num_arguments_vec_c;
Georgios Pinitase8bd2c72018-07-11 15:54:56 +0100466 const unsigned int total_cross_plane_pad = _output->info()->padding().top + _output->info()->padding().bottom;
467 _kernel.setArg<cl_uint>(idx0, static_cast<unsigned int>(total_cross_plane_pad));
Isabella Gottardi8e74f442018-03-01 16:42:00 +0000468 }
469
Anthony Barbier6ff3b192017-09-04 18:44:23 +0100470 do
471 {
472 Window slice_b = slice;
473 // 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 +0000474 // This scenario can happen when the matrix multiplication is used to perform a convolution operation
Gian Marco Iodiced2fab732018-03-02 11:18:12 +0000475 if(!_slide_matrix_b)
Anthony Barbier6ff3b192017-09-04 18:44:23 +0100476 {
477 slice_b = slice_matrix_b;
478 }
479
480 unsigned int idx = 0;
481 add_2D_tensor_argument(idx, _input0, slice);
482 add_2D_tensor_argument(idx, _input1, slice_b);
Michele Di Giorgioebc3a902018-11-16 16:04:25 +0000483 if(_has_vec_c)
484 {
485 add_1D_tensor_argument(idx, _input2, slice);
486 }
Anthony Barbier6ff3b192017-09-04 18:44:23 +0100487 add_2D_tensor_argument(idx, _output, slice);
Gian Marco Iodiced2fab732018-03-02 11:18:12 +0000488 _kernel.setArg<cl_uint>(idx++, static_cast<unsigned int>(_input0->info()->strides_in_bytes()[2]));
489 _kernel.setArg<cl_uint>(idx++, static_cast<unsigned int>(_input1->info()->strides_in_bytes()[2]));
490 _kernel.setArg<cl_uint>(idx++, static_cast<unsigned int>(_output->info()->strides_in_bytes()[2]));
Anthony Barbierb6eb3532018-08-08 13:20:04 +0100491 enqueue(queue, *this, slice, lws_hint());
Anthony Barbier6ff3b192017-09-04 18:44:23 +0100492 }
Gian Marcoae2af742018-02-15 12:35:44 +0000493 while(window.slide_window_slice_3D(slice));
Anthony Barbier6ff3b192017-09-04 18:44:23 +0100494}
giuros011c9efeb2019-01-11 14:04:43 +0000495} // namespace arm_compute