/* * Copyright (c) 2017-2020 ARM Limited. * * SPDX-License-Identifier: MIT * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to * deal in the Software without restriction, including without limitation the * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or * sell copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in all * copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE * SOFTWARE. */ #include "arm_compute/core/NEON/kernels/NEBatchNormalizationLayerKernel.h" #include "arm_compute/core/CPP/Validate.h" #include "arm_compute/core/Helpers.h" #include "arm_compute/core/NEON/NEFixedPoint.h" #include "arm_compute/core/NEON/NEMath.h" #include "arm_compute/core/NEON/kernels/detail/NEActivationFunctionDetail.h" #include "arm_compute/core/TensorInfo.h" #include "arm_compute/core/Utils.h" #include "arm_compute/core/Validate.h" #include "arm_compute/core/Window.h" #include "arm_compute/core/NEON/wrapper/wrapper.h" #include namespace arm_compute { namespace { Status validate_arguments(const ITensorInfo *input, const ITensorInfo *output, const ITensorInfo *mean, const ITensorInfo *var, const ITensorInfo *beta, const ITensorInfo *gamma, float epsilon, ActivationLayerInfo act_info) { ARM_COMPUTE_UNUSED(epsilon); ARM_COMPUTE_RETURN_ERROR_ON_CPU_F16_UNSUPPORTED(input); ARM_COMPUTE_RETURN_ERROR_ON_DATA_TYPE_CHANNEL_NOT_IN(input, 1, DataType::F16, DataType::F32); if(act_info.enabled()) { ActivationLayerInfo::ActivationFunction act = act_info.activation(); ARM_COMPUTE_RETURN_ERROR_ON(act != ActivationLayerInfo::ActivationLayerInfo::ActivationFunction::RELU && act != ActivationLayerInfo::ActivationLayerInfo::ActivationFunction::BOUNDED_RELU && act != ActivationLayerInfo::ActivationLayerInfo::ActivationFunction::LU_BOUNDED_RELU); ARM_COMPUTE_RETURN_ERROR_ON(act_info.b() > act_info.a()); } if(nullptr != output) { ARM_COMPUTE_RETURN_ERROR_ON_MISMATCHING_SHAPES(input, output); ARM_COMPUTE_RETURN_ERROR_ON_MISMATCHING_DATA_LAYOUT(input, output); ARM_COMPUTE_RETURN_ERROR_ON_MISMATCHING_DATA_TYPES(input, output); } ARM_COMPUTE_RETURN_ERROR_ON_MISMATCHING_DATA_TYPES(input, mean, var); ARM_COMPUTE_RETURN_ERROR_ON_MISMATCHING_SHAPES(mean, var); if(beta != nullptr) { ARM_COMPUTE_RETURN_ERROR_ON_MISMATCHING_DATA_TYPES(input, beta); ARM_COMPUTE_RETURN_ERROR_ON_MISMATCHING_SHAPES(mean, beta); } if(gamma != nullptr) { ARM_COMPUTE_RETURN_ERROR_ON_MISMATCHING_DATA_TYPES(input, gamma); ARM_COMPUTE_RETURN_ERROR_ON_MISMATCHING_SHAPES(mean, gamma); } ARM_COMPUTE_RETURN_ERROR_ON(input->dimension(get_data_layout_dimension_index(input->data_layout(), DataLayoutDimension::CHANNEL)) != mean->dimension(0)); return Status{}; } std::pair validate_and_configure_window(ITensorInfo *input, ITensorInfo *output, ITensorInfo *mean, ITensorInfo *var, ITensorInfo *gamma, ITensorInfo *beta) { ARM_COMPUTE_UNUSED(mean, var, gamma, beta); // Configure kernel window Window win = calculate_max_window(*input, Steps()); if(output != nullptr) { // Output auto initialization if not yet initialized auto_init_if_empty(*output, *input->clone()); // NEBatchNormalizationLayerKernel doesn't need padding so update_window_and_padding() can be skipped Coordinates coord; coord.set_num_dimensions(output->num_dimensions()); output->set_valid_region(ValidRegion(coord, output->tensor_shape())); } return std::make_pair(Status{}, win); } } //namespace template void NEBatchNormalizationLayerKernel::batch_normalization_nchw(const Window &window) { /** NEON vector tag type. */ using ExactTagType = typename wrapper::traits::neon_bitvector_tag_t; const int window_step_x = 16 / sizeof(T); const auto window_start_x = static_cast(window.x().start()); const auto window_end_x = static_cast(window.x().end()); Window win_to_use = window; win_to_use.set(Window::DimX, Window::Dimension(0, 1, 1)); Iterator input(_input, win_to_use); Iterator output(_output, win_to_use); F activation_functor(_act_info); // Hold information about the current feature map we are iterating. // Only compute denominator and NEON vectors once per feature map. int slice = -1; const auto input_mean = reinterpret_cast(_mean->ptr_to_element(Coordinates(0, 0))); const auto input_var = reinterpret_cast(_var->ptr_to_element(Coordinates(0, 0))); const auto input_gamma = (_gamma != nullptr) ? reinterpret_cast(_gamma->ptr_to_element(Coordinates(0, 0))) : nullptr; const auto input_beta = (_beta != nullptr) ? reinterpret_cast(_beta->ptr_to_element(Coordinates(0, 0))) : nullptr; T mean = static_cast(0); T var = static_cast(0); T gamma = static_cast(1); T beta = static_cast(0); T denominator = static_cast(0); auto mean_vec = wrapper::vdup_n(mean, ExactTagType{}); auto var_vec = wrapper::vdup_n(var, ExactTagType{}); auto gamma_vec = wrapper::vdup_n(gamma, ExactTagType{}); auto beta_vec = wrapper::vdup_n(beta, ExactTagType{}); auto denominator_vec = wrapper::vdup_n(denominator, ExactTagType{}); const auto epsilon_vec = wrapper::vdup_n(static_cast(_epsilon), ExactTagType{}); execute_window_loop(win_to_use, [&](const Coordinates & id) { const auto input_ptr = reinterpret_cast(input.ptr()); const auto output_ptr = reinterpret_cast(output.ptr()); if(slice != id.z()) { mean = input_mean[id.z()]; var = input_var[id.z()]; mean_vec = wrapper::vdup_n(mean, ExactTagType{}); var_vec = wrapper::vdup_n(var, ExactTagType{}); if(input_gamma != nullptr) { gamma = input_gamma[id.z()]; gamma_vec = wrapper::vdup_n(gamma, ExactTagType{}); } if(input_beta != nullptr) { beta = input_beta[id.z()]; beta_vec = wrapper::vdup_n(beta, ExactTagType{}); } // Calculate denominator denominator_vec = wrapper::vinvsqrt(wrapper::vadd(var_vec, epsilon_vec)); denominator = wrapper::vgetlane(denominator_vec, 0); slice = id.z(); } // Perform core calculations using vector operations int x = window_start_x; for(; x <= (window_end_x - window_step_x); x += window_step_x) { // Calculate x bar const auto numerator = wrapper::vsub(wrapper::vloadq(input_ptr + x), mean_vec); const auto x_bar = wrapper::vmul(numerator, denominator_vec); auto res = wrapper::vmla(beta_vec, x_bar, gamma_vec); // Perform fused activation if(fused_activation) { activation_functor(res); } // Store results wrapper::vstore(output_ptr + x, res); } // Compute left-over elements for(; x < window_end_x; ++x) { const T numerator = input_ptr[x] - mean; const T x_bar = numerator * denominator; T res = beta + x_bar * gamma; // Perform fused activation if(fused_activation) { activation_functor(res); } // Store results *(output_ptr + x) = res; } }, input, output); } template void NEBatchNormalizationLayerKernel::batch_normalization_nhwc(const Window &window) { /** NEON vector tag type. */ using ExactTagType = typename wrapper::traits::neon_bitvector_tag_t; const int window_step_x = 16 / sizeof(T); const auto window_start_x = static_cast(window.x().start()); const auto window_end_x = static_cast(window.x().end()); Window win_collapsed = window.collapse_if_possible(window, Window::DimZ); win_collapsed.set(Window::DimX, Window::Dimension(0, 1, 1)); Iterator input(_input, win_collapsed); Iterator output(_output, win_collapsed); F activation_functor(_act_info); const auto input_mean = reinterpret_cast(_mean->ptr_to_element(Coordinates(0, 0))); const auto input_var = reinterpret_cast(_var->ptr_to_element(Coordinates(0, 0))); const auto input_gamma = (_gamma != nullptr) ? reinterpret_cast(_gamma->ptr_to_element(Coordinates(0, 0))) : nullptr; const auto input_beta = (_beta != nullptr) ? reinterpret_cast(_beta->ptr_to_element(Coordinates(0, 0))) : nullptr; const auto epsilon_vec = wrapper::vdup_n(static_cast(_epsilon), ExactTagType{}); execute_window_loop(win_collapsed, [&](const Coordinates &) { const auto input_ptr = reinterpret_cast(input.ptr()); const auto output_ptr = reinterpret_cast(output.ptr()); // Perform core calculations using vector operations int x = window_start_x; for(; x <= (window_end_x - window_step_x); x += window_step_x) { // Conctruct vectors const auto mean_vec = wrapper::vloadq(input_mean + x); const auto var_vec = wrapper::vloadq(input_var + x); const auto gamma_vec = (input_gamma != nullptr) ? wrapper::vloadq(input_gamma + x) : wrapper::vdup_n(static_cast(1.f), ExactTagType{}); const auto beta_vec = (input_beta != nullptr) ? wrapper::vloadq(input_beta + x) : wrapper::vdup_n(static_cast(0.f), ExactTagType{}); // Calculate denominator const auto denominator = wrapper::vinvsqrt(wrapper::vadd(var_vec, epsilon_vec)); // Calculate x bar const auto numerator = wrapper::vsub(wrapper::vloadq(input_ptr + x), mean_vec); const auto x_bar = wrapper::vmul(numerator, denominator); auto res = wrapper::vmla(beta_vec, x_bar, gamma_vec); // Perform fused activation if(fused_activation) { activation_functor(res); } // Store results wrapper::vstore(output_ptr + x, res); } // Compute left-over elements for(; x < window_end_x; ++x) { // Conctruct vectors const T gamma = (input_gamma != nullptr) ? input_gamma[x] : 1.f; const T beta = (input_beta != nullptr) ? input_beta[x] : 0.f; const T denominator = sqrt(input_var[x] + _epsilon); const T numerator = input_ptr[x] - input_mean[x]; const T x_bar = numerator / denominator; T res = beta + x_bar * gamma; // Perform fused activation if(fused_activation) { activation_functor(res); } // Store results *reinterpret_cast(output_ptr + x) = res; } }, input, output); } void NEBatchNormalizationLayerKernel::configure_non_fused() { const bool is_nhwc = _input->info()->data_layout() == DataLayout::NHWC; switch(_input->info()->data_type()) { #ifdef __ARM_FEATURE_FP16_VECTOR_ARITHMETIC case DataType::F16: _func = (is_nhwc) ? &NEBatchNormalizationLayerKernel::batch_normalization_nhwc> : &NEBatchNormalizationLayerKernel::batch_normalization_nchw>; break; #endif // __ARM_FEATURE_FP16_VECTOR_ARITHMETIC case DataType::F32: _func = (is_nhwc) ? &NEBatchNormalizationLayerKernel::batch_normalization_nhwc> : &NEBatchNormalizationLayerKernel::batch_normalization_nchw>; break; default: ARM_COMPUTE_ERROR("Element size not supported"); break; } } void NEBatchNormalizationLayerKernel::configure_fused() { // NCHW Fused Batched Normalization with activation functions : FP32 static std::map bn_fused_map_f32_nchw = { { ActivationLayerInfo::ActivationFunction::RELU, &NEBatchNormalizationLayerKernel::batch_normalization_nchw> }, { ActivationLayerInfo::ActivationFunction::BOUNDED_RELU, &NEBatchNormalizationLayerKernel::batch_normalization_nchw> }, { ActivationLayerInfo::ActivationFunction::LU_BOUNDED_RELU, &NEBatchNormalizationLayerKernel::batch_normalization_nchw> } }; // NHWC Fused Batched Normalization with activation functions : FP32 static std::map bn_fused_map_f32_nhwc = { { ActivationLayerInfo::ActivationFunction::RELU, &NEBatchNormalizationLayerKernel::batch_normalization_nhwc> }, { ActivationLayerInfo::ActivationFunction::BOUNDED_RELU, &NEBatchNormalizationLayerKernel::batch_normalization_nhwc> }, { ActivationLayerInfo::ActivationFunction::LU_BOUNDED_RELU, &NEBatchNormalizationLayerKernel::batch_normalization_nhwc> } }; #ifdef __ARM_FEATURE_FP16_VECTOR_ARITHMETIC // NCHW Fused Batched Normalization with activation functions : FP16 static std::map bn_fused_map_f16_nchw = { { ActivationLayerInfo::ActivationFunction::RELU, &NEBatchNormalizationLayerKernel::batch_normalization_nchw> }, { ActivationLayerInfo::ActivationFunction::BOUNDED_RELU, &NEBatchNormalizationLayerKernel::batch_normalization_nchw> }, { ActivationLayerInfo::ActivationFunction::LU_BOUNDED_RELU, &NEBatchNormalizationLayerKernel::batch_normalization_nchw> } }; // NHWC Fused Batched Normalization with activation functions : FP16 static std::map bn_fused_map_f16_nhwc = { { ActivationLayerInfo::ActivationFunction::RELU, &NEBatchNormalizationLayerKernel::batch_normalization_nhwc> }, { ActivationLayerInfo::ActivationFunction::BOUNDED_RELU, &NEBatchNormalizationLayerKernel::batch_normalization_nhwc> }, { ActivationLayerInfo::ActivationFunction::LU_BOUNDED_RELU, &NEBatchNormalizationLayerKernel::batch_normalization_nhwc> } }; #endif // __ARM_FEATURE_FP16_VECTOR_ARITHMETIC switch(_input->info()->data_type()) { #ifdef __ARM_FEATURE_FP16_VECTOR_ARITHMETIC case DataType::F16: _func = (_input->info()->data_layout() == DataLayout::NHWC) ? bn_fused_map_f16_nhwc[_act_info.activation()] : bn_fused_map_f16_nchw[_act_info.activation()]; break; #endif // __ARM_FEATURE_FP16_VECTOR_ARITHMETIC case DataType::F32: _func = (_input->info()->data_layout() == DataLayout::NHWC) ? bn_fused_map_f32_nhwc[_act_info.activation()] : bn_fused_map_f32_nchw[_act_info.activation()]; break; default: ARM_COMPUTE_ERROR("Element size not supported"); break; } } NEBatchNormalizationLayerKernel::NEBatchNormalizationLayerKernel() : _func(nullptr), _input(nullptr), _output(nullptr), _mean(nullptr), _var(nullptr), _gamma(nullptr), _beta(nullptr), _epsilon(), _act_info() { } void NEBatchNormalizationLayerKernel::configure(ITensor *input, ITensor *output, const ITensor *mean, const ITensor *var, const ITensor *beta, const ITensor *gamma, float epsilon, ActivationLayerInfo act_info) { ARM_COMPUTE_ERROR_ON_NULLPTR(input, mean, var); ARM_COMPUTE_ERROR_THROW_ON(validate_arguments(input->info(), (output != nullptr) ? output->info() : nullptr, mean->info(), var->info(), (beta != nullptr) ? beta->info() : nullptr, (gamma != nullptr) ? gamma->info() : nullptr, epsilon, act_info)); _input = input; _output = input; _mean = mean; _var = var; _gamma = gamma; _beta = beta; _epsilon = epsilon; _act_info = act_info; const bool run_in_place = (output == nullptr) || (output == input); if(!run_in_place) { _output = output; } // Configure activation function to run if(_act_info.enabled()) { configure_fused(); } else { configure_non_fused(); } // Configure kernel window auto win_config = validate_and_configure_window(input->info(), (run_in_place) ? nullptr : output->info(), mean->info(), var->info(), (gamma != nullptr) ? gamma->info() : nullptr, (beta != nullptr) ? beta->info() : nullptr); ARM_COMPUTE_ERROR_THROW_ON(win_config.first); INEKernel::configure(win_config.second); } Status NEBatchNormalizationLayerKernel::validate(const ITensorInfo *input, const ITensorInfo *output, const ITensorInfo *mean, const ITensorInfo *var, const ITensorInfo *beta, const ITensorInfo *gamma, float epsilon, ActivationLayerInfo act_info) { ARM_COMPUTE_RETURN_ON_ERROR(validate_arguments(input, output, mean, var, beta, gamma, epsilon, act_info)); ARM_COMPUTE_RETURN_ON_ERROR(validate_and_configure_window(input->clone().get(), output ? output->clone().get() : nullptr, mean->clone().get(), var->clone().get(), (gamma != nullptr) ? gamma->clone().get() : nullptr, (beta != nullptr) ? beta->clone().get() : nullptr) .first); return Status{}; } void NEBatchNormalizationLayerKernel::run(const Window &window, const ThreadInfo &info) { ARM_COMPUTE_UNUSED(info); ARM_COMPUTE_ERROR_ON_UNCONFIGURED_KERNEL(this); ARM_COMPUTE_ERROR_ON_INVALID_SUBWINDOW(INEKernel::window(), window); ARM_COMPUTE_ERROR_ON(_func == nullptr); (this->*_func)(window); } } // namespace arm_compute