Giorgio Arena | dfca60b | 2018-01-31 10:30:59 +0000 | [diff] [blame] | 1 | /* |
| 2 | * Copyright (c) 2018 ARM Limited. |
| 3 | * |
| 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/CLDepthwiseConvolutionLayer3x3NHWCKernel.h" |
| 25 | |
| 26 | #include "arm_compute/core/AccessWindowStatic.h" |
| 27 | #include "arm_compute/core/CL/CLHelpers.h" |
| 28 | #include "arm_compute/core/CL/CLKernelLibrary.h" |
| 29 | #include "arm_compute/core/CL/ICLKernel.h" |
| 30 | #include "arm_compute/core/CL/ICLTensor.h" |
| 31 | #include "arm_compute/core/Error.h" |
| 32 | #include "arm_compute/core/Helpers.h" |
| 33 | #include "arm_compute/core/TensorInfo.h" |
| 34 | #include "arm_compute/core/Types.h" |
| 35 | #include "arm_compute/core/Utils.h" |
| 36 | #include "arm_compute/core/utils/misc/ShapeCalculator.h" |
| 37 | #include "arm_compute/core/utils/quantization/AsymmHelpers.h" |
| 38 | |
| 39 | using namespace arm_compute; |
| 40 | using namespace arm_compute::misc::shape_calculator; |
| 41 | |
| 42 | namespace |
| 43 | { |
Giorgio Arena | 7657224 | 2018-04-04 17:44:26 +0100 | [diff] [blame] | 44 | Status validate_arguments(const ITensorInfo *input, const ITensorInfo *weights, const ITensorInfo *biases, const ITensorInfo *output, const PadStrideInfo &conv_info, unsigned int depth_multiplier, |
Giorgio Arena | dfca60b | 2018-01-31 10:30:59 +0000 | [diff] [blame] | 45 | const ActivationLayerInfo &act_info) |
| 46 | { |
| 47 | ARM_COMPUTE_RETURN_ERROR_ON_DATA_TYPE_CHANNEL_NOT_IN(input, 1, DataType::QASYMM8); |
| 48 | ARM_COMPUTE_RETURN_ERROR_ON_MSG((act_info.enabled()) && (act_info.activation() != ActivationLayerInfo::ActivationFunction::LU_BOUNDED_RELU) |
| 49 | && (act_info.activation() != ActivationLayerInfo::ActivationFunction::BOUNDED_RELU) |
| 50 | && (act_info.activation() != ActivationLayerInfo::ActivationFunction::RELU), |
| 51 | "For QASYMM8 only relu, lower bounded relu and lower-upper bounded relu are supported"); |
| 52 | ARM_COMPUTE_RETURN_ERROR_ON_MISMATCHING_DATA_TYPES(input, weights); |
Giorgio Arena | 7657224 | 2018-04-04 17:44:26 +0100 | [diff] [blame] | 53 | ARM_COMPUTE_RETURN_ERROR_ON(depth_multiplier > 1); // COMPMID-1071 Add depth multiplier support for NHWC |
Giorgio Arena | dfca60b | 2018-01-31 10:30:59 +0000 | [diff] [blame] | 54 | ARM_COMPUTE_RETURN_ERROR_ON(weights->dimension(1) != 3 || weights->dimension(2) != 3); |
| 55 | |
| 56 | if(biases != nullptr) |
| 57 | { |
| 58 | ARM_COMPUTE_RETURN_ERROR_ON_DATA_TYPE_CHANNEL_NOT_IN(biases, 1, DataType::S32); |
| 59 | ARM_COMPUTE_RETURN_ERROR_ON(biases->dimension(0) != weights->dimension(0)); |
| 60 | ARM_COMPUTE_RETURN_ERROR_ON(biases->num_dimensions() > 1); |
| 61 | } |
| 62 | |
| 63 | if(output->total_size() != 0) |
| 64 | { |
Giorgio Arena | 7657224 | 2018-04-04 17:44:26 +0100 | [diff] [blame] | 65 | const TensorShape output_shape = compute_depthwise_convolution_shape(*input, *weights, conv_info, depth_multiplier); |
Giorgio Arena | dfca60b | 2018-01-31 10:30:59 +0000 | [diff] [blame] | 66 | ARM_COMPUTE_RETURN_ERROR_ON_MISMATCHING_DIMENSIONS(output->tensor_shape(), output_shape); |
| 67 | } |
| 68 | |
| 69 | return Status{}; |
| 70 | } |
| 71 | |
Georgios Pinitas | b2d9ebb | 2018-05-14 12:21:51 +0100 | [diff] [blame] | 72 | std::pair<Status, Window> validate_and_configure_window(ITensorInfo *input, ITensorInfo *weights, ITensorInfo *bias, ITensorInfo *output, |
| 73 | const PadStrideInfo &conv_info) |
Giorgio Arena | dfca60b | 2018-01-31 10:30:59 +0000 | [diff] [blame] | 74 | { |
| 75 | const unsigned int num_rows_processed_per_iteration = 4; |
| 76 | const unsigned int num_elems_accessed_per_iteration = 4; |
| 77 | const unsigned int num_rows_read_per_iteration = num_rows_processed_per_iteration + 2; |
| 78 | const unsigned int num_rows_written_per_iteration = num_rows_processed_per_iteration / conv_info.stride().first; |
| 79 | |
Giorgio Arena | fa23f11 | 2018-06-19 11:27:38 +0100 | [diff] [blame] | 80 | const BorderSize border_size(std::max(conv_info.pad_left(), conv_info.pad_top()), 0, std::max(conv_info.pad_right(), conv_info.pad_bottom()), 0); |
Giorgio Arena | dfca60b | 2018-01-31 10:30:59 +0000 | [diff] [blame] | 81 | |
| 82 | // Configure kernel window |
| 83 | Window win = calculate_max_window(*output, Steps(num_elems_accessed_per_iteration, num_rows_written_per_iteration)); |
| 84 | |
| 85 | AccessWindowStatic input_access(input, 0, -border_size.top, ceil_to_multiple(input->dimension(0), num_elems_accessed_per_iteration), |
| 86 | ceil_to_multiple(input->dimension(1) + border_size.bottom, num_rows_read_per_iteration)); |
| 87 | AccessWindowRectangle output_access(output, 0, 0, num_elems_accessed_per_iteration, num_rows_written_per_iteration); |
| 88 | AccessWindowHorizontal weights_access(weights, 0, num_elems_accessed_per_iteration); |
| 89 | |
| 90 | bool window_changed = update_window_and_padding(win, input_access, weights_access, output_access); |
| 91 | |
Georgios Pinitas | b2d9ebb | 2018-05-14 12:21:51 +0100 | [diff] [blame] | 92 | if(bias != nullptr) |
| 93 | { |
| 94 | AccessWindowHorizontal bias_access(bias, 0, num_elems_accessed_per_iteration); |
| 95 | window_changed = window_changed || update_window_and_padding(win, bias_access); |
| 96 | } |
| 97 | |
Giorgio Arena | dfca60b | 2018-01-31 10:30:59 +0000 | [diff] [blame] | 98 | output_access.set_valid_region(win, ValidRegion(Coordinates(), output->tensor_shape())); |
| 99 | |
| 100 | Status err = (window_changed) ? ARM_COMPUTE_CREATE_ERROR(ErrorCode::RUNTIME_ERROR, "Insufficient Padding!") : Status{}; |
| 101 | return std::make_pair(err, win); |
| 102 | } |
| 103 | } // namespace |
| 104 | |
| 105 | CLDepthwiseConvolutionLayer3x3NHWCKernel::CLDepthwiseConvolutionLayer3x3NHWCKernel() |
| 106 | : _num_rows_processed_per_iteration(1) |
| 107 | { |
| 108 | } |
| 109 | |
| 110 | BorderSize CLDepthwiseConvolutionLayer3x3NHWCKernel::border_size() const |
| 111 | { |
| 112 | return _border_size; |
| 113 | } |
| 114 | |
| 115 | void CLDepthwiseConvolutionLayer3x3NHWCKernel::configure(const ICLTensor *input, const ICLTensor *weights, const ICLTensor *biases, ICLTensor *output, const PadStrideInfo &conv_info, |
Giorgio Arena | 7657224 | 2018-04-04 17:44:26 +0100 | [diff] [blame] | 116 | unsigned int depth_multiplier, |
Giorgio Arena | dfca60b | 2018-01-31 10:30:59 +0000 | [diff] [blame] | 117 | ActivationLayerInfo act_info) |
| 118 | { |
| 119 | ARM_COMPUTE_ERROR_ON_NULLPTR(input, weights, output); |
| 120 | |
| 121 | // Get convolved dimensions |
Giorgio Arena | 7657224 | 2018-04-04 17:44:26 +0100 | [diff] [blame] | 122 | const TensorShape output_shape = compute_depthwise_convolution_shape(*input->info(), *weights->info(), conv_info, depth_multiplier); |
Giorgio Arena | dfca60b | 2018-01-31 10:30:59 +0000 | [diff] [blame] | 123 | |
| 124 | // Output auto inizialitation if not yet initialized |
| 125 | auto_init_if_empty(*output->info(), |
| 126 | output_shape, |
| 127 | 1, |
| 128 | input->info()->data_type(), |
| 129 | input->info()->fixed_point_position(), |
| 130 | input->info()->quantization_info()); |
| 131 | |
Giorgio Arena | 7657224 | 2018-04-04 17:44:26 +0100 | [diff] [blame] | 132 | ARM_COMPUTE_ERROR_THROW_ON(validate_arguments(input->info(), weights->info(), (biases != nullptr) ? biases->info() : nullptr, output->info(), conv_info, depth_multiplier, act_info)); |
Giorgio Arena | dfca60b | 2018-01-31 10:30:59 +0000 | [diff] [blame] | 133 | |
| 134 | const unsigned int conv_stride_x = conv_info.stride().first; |
| 135 | ARM_COMPUTE_ERROR_ON(conv_stride_x < 1 || conv_stride_x > 2); |
| 136 | ARM_COMPUTE_ERROR_ON(std::max(conv_info.pad_top(), conv_info.pad_bottom()) > 1); |
| 137 | |
| 138 | _input = input; |
| 139 | _output = output; |
| 140 | _weights = weights; |
| 141 | _biases = biases; |
| 142 | _conv_stride_y = conv_info.stride().second; |
Giorgio Arena | dfca60b | 2018-01-31 10:30:59 +0000 | [diff] [blame] | 143 | _num_rows_processed_per_iteration = 4; |
| 144 | |
| 145 | const unsigned int num_elems_accessed_per_iteration = 4; |
Giorgio Arena | dfca60b | 2018-01-31 10:30:59 +0000 | [diff] [blame] | 146 | |
Giorgio Arena | fa23f11 | 2018-06-19 11:27:38 +0100 | [diff] [blame] | 147 | _border_size = BorderSize(std::max(conv_info.pad_left(), conv_info.pad_top()), 0, std::max(conv_info.pad_right(), conv_info.pad_bottom()), 0); |
Giorgio Arena | dfca60b | 2018-01-31 10:30:59 +0000 | [diff] [blame] | 148 | |
| 149 | float multiplier = _input->info()->quantization_info().scale * _weights->info()->quantization_info().scale / _output->info()->quantization_info().scale; |
| 150 | int output_multiplier = 0; |
| 151 | int output_shift = 0; |
| 152 | quantization::calculate_quantized_multiplier_less_than_one(multiplier, &output_multiplier, &output_shift); |
| 153 | |
| 154 | CLBuildOptions build_opts; |
| 155 | build_opts.add_option_if(_biases != nullptr, "-DHAS_BIAS"); |
| 156 | build_opts.add_option("-DINPUT_OFFSET=" + support::cpp11::to_string(-_input->info()->quantization_info().offset)); |
| 157 | build_opts.add_option("-DWEIGHTS_OFFSET=" + support::cpp11::to_string(-_weights->info()->quantization_info().offset)); |
| 158 | build_opts.add_option("-DOUTPUT_OFFSET=" + support::cpp11::to_string(_output->info()->quantization_info().offset)); |
| 159 | build_opts.add_option("-DK_OFFSET=" + support::cpp11::to_string(9 * input->info()->quantization_info().offset * weights->info()->quantization_info().offset)); |
| 160 | build_opts.add_option("-DOUTPUT_MULTIPLIER=" + support::cpp11::to_string(output_multiplier)); |
| 161 | build_opts.add_option("-DOUTPUT_SHIFT=" + support::cpp11::to_string(output_shift)); |
| 162 | build_opts.add_option("-DVEC_SIZE=" + support::cpp11::to_string(num_elems_accessed_per_iteration)); |
Giorgio Arena | fa23f11 | 2018-06-19 11:27:38 +0100 | [diff] [blame] | 163 | build_opts.add_option("-DSRC_DIM_1=" + support::cpp11::to_string(_input->info()->dimension(1))); |
| 164 | build_opts.add_option("-DSRC_DIM_2=" + support::cpp11::to_string(_input->info()->dimension(2))); |
Giorgio Arena | dfca60b | 2018-01-31 10:30:59 +0000 | [diff] [blame] | 165 | build_opts.add_option("-DCONV_PAD_TOP=" + support::cpp11::to_string(conv_info.pad_top())); |
Giorgio Arena | fa23f11 | 2018-06-19 11:27:38 +0100 | [diff] [blame] | 166 | build_opts.add_option("-DCONV_PAD_LEFT=" + support::cpp11::to_string(conv_info.pad_left())); |
Giorgio Arena | dfca60b | 2018-01-31 10:30:59 +0000 | [diff] [blame] | 167 | |
| 168 | if(act_info.enabled()) |
| 169 | { |
| 170 | const int a_val = input->info()->quantization_info().quantize(act_info.a(), RoundingPolicy::TO_NEAREST_UP); |
| 171 | const int b_val = input->info()->quantization_info().quantize(act_info.b(), RoundingPolicy::TO_NEAREST_UP); |
| 172 | const int o1 = input->info()->quantization_info().offset; |
| 173 | |
| 174 | build_opts.add_option("-DFUSED_ACTIVATION=" + lower_string(string_from_activation_func(act_info.activation()))); |
| 175 | build_opts.add_option("-DA_VAL=" + support::cpp11::to_string(a_val)); |
| 176 | build_opts.add_option("-DB_VAL=" + support::cpp11::to_string(b_val)); |
| 177 | build_opts.add_option("-DCONST_0=" + support::cpp11::to_string(o1)); |
| 178 | |
| 179 | if(output != nullptr) |
| 180 | { |
| 181 | const float s1 = input->info()->quantization_info().scale; |
| 182 | const float s2 = output->info()->quantization_info().scale; |
| 183 | const int o2 = output->info()->quantization_info().offset; |
| 184 | |
| 185 | if(o1 != o2 || s1 != s2) |
| 186 | { |
| 187 | build_opts.add_option("-DS1_VAL=" + float_to_string_with_full_precision(s1)); |
| 188 | build_opts.add_option("-DS2_VAL=" + float_to_string_with_full_precision(s2)); |
| 189 | build_opts.add_option("-DO1_VAL=" + support::cpp11::to_string(o1)); |
| 190 | build_opts.add_option("-DO2_VAL=" + support::cpp11::to_string(o2)); |
| 191 | } |
| 192 | } |
| 193 | } |
| 194 | |
| 195 | // Create kernel |
| 196 | std::string kernel_name = std::string("depthwise_convolution_3x3_quantized_nhwc_stride") + support::cpp11::to_string(conv_stride_x); |
| 197 | _kernel = static_cast<cl::Kernel>(CLKernelLibrary::get().create_kernel(kernel_name, build_opts.options())); |
| 198 | |
| 199 | // Configure kernel window |
Georgios Pinitas | b2d9ebb | 2018-05-14 12:21:51 +0100 | [diff] [blame] | 200 | auto win_config = validate_and_configure_window(input->info(), weights->info(), biases != nullptr ? biases->info() : nullptr, output->info(), conv_info); |
Giorgio Arena | dfca60b | 2018-01-31 10:30:59 +0000 | [diff] [blame] | 201 | ARM_COMPUTE_ERROR_THROW_ON(win_config.first); |
| 202 | ICLKernel::configure(win_config.second); |
| 203 | |
| 204 | // Set config_id for enabling LWS tuning |
| 205 | _config_id = kernel_name; |
| 206 | _config_id += "_"; |
| 207 | _config_id += support::cpp11::to_string(input->info()->dimension(0)); |
| 208 | _config_id += "_"; |
| 209 | _config_id += support::cpp11::to_string(input->info()->dimension(1)); |
| 210 | _config_id += "_"; |
| 211 | _config_id += support::cpp11::to_string(input->info()->dimension(2)); |
| 212 | _config_id += "_"; |
| 213 | _config_id += support::cpp11::to_string(output->info()->dimension(0)); |
| 214 | _config_id += "_"; |
| 215 | _config_id += support::cpp11::to_string(output->info()->dimension(1)); |
| 216 | } |
| 217 | |
| 218 | Status CLDepthwiseConvolutionLayer3x3NHWCKernel::validate(const ITensorInfo *input, const ITensorInfo *weights, const ITensorInfo *biases, const ITensorInfo *output, const PadStrideInfo &conv_info, |
Giorgio Arena | 7657224 | 2018-04-04 17:44:26 +0100 | [diff] [blame] | 219 | unsigned int depth_multiplier, |
Giorgio Arena | dfca60b | 2018-01-31 10:30:59 +0000 | [diff] [blame] | 220 | ActivationLayerInfo act_info) |
| 221 | { |
Giorgio Arena | 7657224 | 2018-04-04 17:44:26 +0100 | [diff] [blame] | 222 | ARM_COMPUTE_RETURN_ON_ERROR(validate_arguments(input, weights, biases, output, conv_info, depth_multiplier, act_info)); |
Georgios Pinitas | b2d9ebb | 2018-05-14 12:21:51 +0100 | [diff] [blame] | 223 | ARM_COMPUTE_RETURN_ON_ERROR(validate_and_configure_window(input->clone().get(), weights->clone().get(), |
| 224 | biases != nullptr ? biases->clone().get() : nullptr, |
| 225 | output->clone().get(), conv_info) |
| 226 | .first); |
Giorgio Arena | dfca60b | 2018-01-31 10:30:59 +0000 | [diff] [blame] | 227 | |
| 228 | return Status{}; |
| 229 | } |
| 230 | |
| 231 | void CLDepthwiseConvolutionLayer3x3NHWCKernel::run(const Window &window, cl::CommandQueue &queue) |
| 232 | { |
| 233 | ARM_COMPUTE_ERROR_ON_UNCONFIGURED_KERNEL(this); |
| 234 | ARM_COMPUTE_ERROR_ON_INVALID_SUBWINDOW(IKernel::window(), window); |
| 235 | |
| 236 | // Create input window and adjust |
| 237 | Window win_in = window; |
Giorgio Arena | dfca60b | 2018-01-31 10:30:59 +0000 | [diff] [blame] | 238 | win_in.set_dimension_step(Window::DimY, _num_rows_processed_per_iteration); |
| 239 | win_in.set_dimension_step(Window::DimZ, _conv_stride_y); |
| 240 | |
| 241 | ARM_COMPUTE_ERROR_ON((win_in.y().step() < window.y().step()) || (win_in.z().step() < window.z().step())); |
| 242 | |
| 243 | Window slice_in = win_in.first_slice_window_3D(); |
| 244 | Window slice_out = window.first_slice_window_3D(); |
| 245 | |
| 246 | if(_biases != nullptr) |
| 247 | { |
| 248 | unsigned int idx = 3 * num_arguments_per_3D_tensor(); |
| 249 | Window win_biases; |
| 250 | win_biases.use_tensor_dimensions(_biases->info()->tensor_shape()); |
| 251 | win_biases.set_dimension_step(Window::DimX, window.x().step()); |
| 252 | add_1D_tensor_argument(idx, _biases, win_biases); |
| 253 | } |
| 254 | |
| 255 | do |
| 256 | { |
| 257 | unsigned int idx = 0; |
| 258 | add_3D_tensor_argument(idx, _input, slice_in); |
| 259 | add_3D_tensor_argument(idx, _output, slice_out); |
| 260 | add_3D_tensor_argument(idx, _weights, slice_out); |
| 261 | |
| 262 | enqueue(queue, *this, slice_out, _lws_hint); |
| 263 | } |
| 264 | while(window.slide_window_slice_3D(slice_out) && win_in.slide_window_slice_3D(slice_in)); |
| 265 | } |