Anthony Barbier | 6ff3b19 | 2017-09-04 18:44:23 +0100 | [diff] [blame] | 1 | /* |
Gunes Bayir | 9d0c4de | 2023-04-13 18:22:58 +0100 | [diff] [blame] | 2 | * Copyright (c) 2017-2023 Arm Limited. |
Anthony Barbier | 6ff3b19 | 2017-09-04 18:44:23 +0100 | [diff] [blame] | 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 | */ |
Anitha Raj | b566b6e | 2023-08-23 11:40:06 +0100 | [diff] [blame] | 24 | #ifndef ACL_TESTS_VALIDATION_HELPERS_H |
| 25 | #define ACL_TESTS_VALIDATION_HELPERS_H |
Anthony Barbier | 6ff3b19 | 2017-09-04 18:44:23 +0100 | [diff] [blame] | 26 | |
Georgios Pinitas | 7b7858d | 2017-06-21 16:44:24 +0100 | [diff] [blame] | 27 | #include "arm_compute/core/Types.h" |
Moritz Pflanzer | a09de0c | 2017-09-01 20:41:12 +0100 | [diff] [blame] | 28 | #include "arm_compute/core/Utils.h" |
SiCong Li | 9129549 | 2023-07-21 18:16:13 +0100 | [diff] [blame] | 29 | #include "arm_compute/function_info/ActivationLayerInfo.h" |
Moritz Pflanzer | 6c6597c | 2017-09-24 12:09:41 +0100 | [diff] [blame] | 30 | #include "support/Half.h" |
John Richardson | 6f4d49f | 2017-09-07 11:21:10 +0100 | [diff] [blame] | 31 | #include "tests/Globals.h" |
Moritz Pflanzer | 6c6597c | 2017-09-24 12:09:41 +0100 | [diff] [blame] | 32 | #include "tests/SimpleTensor.h" |
Georgios Pinitas | 7b7858d | 2017-06-21 16:44:24 +0100 | [diff] [blame] | 33 | |
Michalis Spyrou | a3c9a3b | 2020-12-08 21:02:16 +0000 | [diff] [blame] | 34 | #include <math.h> |
Georgios Pinitas | 7b7858d | 2017-06-21 16:44:24 +0100 | [diff] [blame] | 35 | #include <random> |
Anthony Barbier | 6ff3b19 | 2017-09-04 18:44:23 +0100 | [diff] [blame] | 36 | #include <type_traits> |
| 37 | #include <utility> |
| 38 | |
| 39 | namespace arm_compute |
| 40 | { |
| 41 | namespace test |
| 42 | { |
| 43 | namespace validation |
| 44 | { |
Moritz Pflanzer | a09de0c | 2017-09-01 20:41:12 +0100 | [diff] [blame] | 45 | template <typename T> |
| 46 | struct is_floating_point : public std::is_floating_point<T> |
Pablo Tello | 8fda1cb | 2017-07-05 15:20:38 +0100 | [diff] [blame] | 47 | { |
Moritz Pflanzer | a09de0c | 2017-09-01 20:41:12 +0100 | [diff] [blame] | 48 | }; |
| 49 | |
| 50 | template <> |
Georgios Pinitas | 583137c | 2017-08-31 18:12:42 +0100 | [diff] [blame] | 51 | struct is_floating_point<half> : public std::true_type |
Moritz Pflanzer | a09de0c | 2017-09-01 20:41:12 +0100 | [diff] [blame] | 52 | { |
| 53 | }; |
Pablo Tello | 8fda1cb | 2017-07-05 15:20:38 +0100 | [diff] [blame] | 54 | |
Anthony Barbier | 6ff3b19 | 2017-09-04 18:44:23 +0100 | [diff] [blame] | 55 | /** Helper function to get the testing range for each activation layer. |
| 56 | * |
Vidhya Sudhan Loganathan | 014333d | 2018-07-02 09:13:49 +0100 | [diff] [blame] | 57 | * @param[in] activation Activation function to test. |
| 58 | * @param[in] data_type Data type. |
Anthony Barbier | 6ff3b19 | 2017-09-04 18:44:23 +0100 | [diff] [blame] | 59 | * |
| 60 | * @return A pair containing the lower upper testing bounds for a given function. |
| 61 | */ |
| 62 | template <typename T> |
Vidhya Sudhan Loganathan | 014333d | 2018-07-02 09:13:49 +0100 | [diff] [blame] | 63 | std::pair<T, T> get_activation_layer_test_bounds(ActivationLayerInfo::ActivationFunction activation, DataType data_type) |
Anthony Barbier | 6ff3b19 | 2017-09-04 18:44:23 +0100 | [diff] [blame] | 64 | { |
Anthony Barbier | 6ff3b19 | 2017-09-04 18:44:23 +0100 | [diff] [blame] | 65 | std::pair<T, T> bounds; |
| 66 | |
Moritz Pflanzer | a09de0c | 2017-09-01 20:41:12 +0100 | [diff] [blame] | 67 | switch(data_type) |
Anthony Barbier | 6ff3b19 | 2017-09-04 18:44:23 +0100 | [diff] [blame] | 68 | { |
Moritz Pflanzer | a09de0c | 2017-09-01 20:41:12 +0100 | [diff] [blame] | 69 | case DataType::F16: |
Isabella Gottardi | 3b77e9d | 2017-06-22 11:05:41 +0100 | [diff] [blame] | 70 | { |
Moritz Pflanzer | a09de0c | 2017-09-01 20:41:12 +0100 | [diff] [blame] | 71 | using namespace half_float::literal; |
Isabella Gottardi | 3b77e9d | 2017-06-22 11:05:41 +0100 | [diff] [blame] | 72 | |
Moritz Pflanzer | a09de0c | 2017-09-01 20:41:12 +0100 | [diff] [blame] | 73 | switch(activation) |
Isabella Gottardi | 3b77e9d | 2017-06-22 11:05:41 +0100 | [diff] [blame] | 74 | { |
Georgios Pinitas | 3463a8b | 2018-08-23 13:11:53 +0100 | [diff] [blame] | 75 | case ActivationLayerInfo::ActivationFunction::TANH: |
Moritz Pflanzer | a09de0c | 2017-09-01 20:41:12 +0100 | [diff] [blame] | 76 | case ActivationLayerInfo::ActivationFunction::SQUARE: |
| 77 | case ActivationLayerInfo::ActivationFunction::LOGISTIC: |
| 78 | case ActivationLayerInfo::ActivationFunction::SOFT_RELU: |
| 79 | // Reduce range as exponent overflows |
Georgios Pinitas | 3463a8b | 2018-08-23 13:11:53 +0100 | [diff] [blame] | 80 | bounds = std::make_pair(-2._h, 2._h); |
Isabella Gottardi | 3b77e9d | 2017-06-22 11:05:41 +0100 | [diff] [blame] | 81 | break; |
Moritz Pflanzer | a09de0c | 2017-09-01 20:41:12 +0100 | [diff] [blame] | 82 | case ActivationLayerInfo::ActivationFunction::SQRT: |
| 83 | // Reduce range as sqrt should take a non-negative number |
Georgios Pinitas | 3463a8b | 2018-08-23 13:11:53 +0100 | [diff] [blame] | 84 | bounds = std::make_pair(0._h, 128._h); |
Isabella Gottardi | 3b77e9d | 2017-06-22 11:05:41 +0100 | [diff] [blame] | 85 | break; |
| 86 | default: |
Moritz Pflanzer | a09de0c | 2017-09-01 20:41:12 +0100 | [diff] [blame] | 87 | bounds = std::make_pair(-255._h, 255._h); |
| 88 | break; |
Isabella Gottardi | 3b77e9d | 2017-06-22 11:05:41 +0100 | [diff] [blame] | 89 | } |
Moritz Pflanzer | a09de0c | 2017-09-01 20:41:12 +0100 | [diff] [blame] | 90 | break; |
Isabella Gottardi | 3b77e9d | 2017-06-22 11:05:41 +0100 | [diff] [blame] | 91 | } |
Moritz Pflanzer | a09de0c | 2017-09-01 20:41:12 +0100 | [diff] [blame] | 92 | case DataType::F32: |
| 93 | switch(activation) |
| 94 | { |
Gunes Bayir | 01934e9 | 2022-11-02 11:50:37 +0000 | [diff] [blame] | 95 | case ActivationLayerInfo::ActivationFunction::SOFT_RELU: |
| 96 | // Reduce range as exponent overflows |
| 97 | bounds = std::make_pair(-40.f, 40.f); |
| 98 | break; |
Moritz Pflanzer | a09de0c | 2017-09-01 20:41:12 +0100 | [diff] [blame] | 99 | case ActivationLayerInfo::ActivationFunction::SQRT: |
| 100 | // Reduce range as sqrt should take a non-negative number |
| 101 | bounds = std::make_pair(0.f, 255.f); |
| 102 | break; |
| 103 | default: |
| 104 | bounds = std::make_pair(-255.f, 255.f); |
| 105 | break; |
| 106 | } |
| 107 | break; |
Moritz Pflanzer | a09de0c | 2017-09-01 20:41:12 +0100 | [diff] [blame] | 108 | default: |
| 109 | ARM_COMPUTE_ERROR("Unsupported data type"); |
Isabella Gottardi | 3b77e9d | 2017-06-22 11:05:41 +0100 | [diff] [blame] | 110 | } |
| 111 | |
Moritz Pflanzer | a09de0c | 2017-09-01 20:41:12 +0100 | [diff] [blame] | 112 | return bounds; |
Isabella Gottardi | 3b77e9d | 2017-06-22 11:05:41 +0100 | [diff] [blame] | 113 | } |
| 114 | |
Sang-Hoon Park | 0779fec | 2019-11-13 17:08:12 +0000 | [diff] [blame] | 115 | /** Convert an asymmetric quantized simple tensor into float using tensor quantization information. |
Anton Lokhmotov | af6204c | 2017-11-08 09:34:19 +0000 | [diff] [blame] | 116 | * |
| 117 | * @param[in] src Quantized tensor. |
| 118 | * |
| 119 | * @return Float tensor. |
Anthony Barbier | f202e50 | 2017-11-23 18:02:04 +0000 | [diff] [blame] | 120 | */ |
Michalis Spyrou | ed7b27d | 2019-11-27 16:04:17 +0000 | [diff] [blame] | 121 | template <typename T> |
| 122 | SimpleTensor<float> convert_from_asymmetric(const SimpleTensor<T> &src); |
Michele Di Giorgio | 578a9fc | 2019-08-23 11:49:04 +0100 | [diff] [blame] | 123 | |
Anton Lokhmotov | af6204c | 2017-11-08 09:34:19 +0000 | [diff] [blame] | 124 | /** Convert float simple tensor into quantized using specified quantization information. |
| 125 | * |
| 126 | * @param[in] src Float tensor. |
| 127 | * @param[in] quantization_info Quantification information. |
| 128 | * |
ramy.elgammal@arm.com | a2561f0 | 2023-06-16 20:45:48 +0100 | [diff] [blame] | 129 | * \relates arm_compute::test::SimpleTensor |
Anton Lokhmotov | af6204c | 2017-11-08 09:34:19 +0000 | [diff] [blame] | 130 | * @return Quantized tensor. |
Anthony Barbier | f202e50 | 2017-11-23 18:02:04 +0000 | [diff] [blame] | 131 | */ |
Michele Di Giorgio | 4aff98f | 2019-08-28 16:27:26 +0100 | [diff] [blame] | 132 | template <typename T> |
| 133 | SimpleTensor<T> convert_to_asymmetric(const SimpleTensor<float> &src, const QuantizationInfo &quantization_info); |
| 134 | |
| 135 | /** Convert quantized simple tensor into float using tensor quantization information. |
| 136 | * |
| 137 | * @param[in] src Quantized tensor. |
| 138 | * |
| 139 | * @return Float tensor. |
| 140 | */ |
Manuel Bottini | 3689fcd | 2019-06-14 17:18:12 +0100 | [diff] [blame] | 141 | template <typename T> |
| 142 | SimpleTensor<float> convert_from_symmetric(const SimpleTensor<T> &src); |
| 143 | |
| 144 | /** Convert float simple tensor into quantized using specified quantization information. |
| 145 | * |
| 146 | * @param[in] src Float tensor. |
| 147 | * @param[in] quantization_info Quantification information. |
ramy.elgammal@arm.com | a2561f0 | 2023-06-16 20:45:48 +0100 | [diff] [blame] | 148 | * \relates arm_compute::test::SimpleTensor |
Manuel Bottini | 3689fcd | 2019-06-14 17:18:12 +0100 | [diff] [blame] | 149 | * @return Quantized tensor. |
| 150 | */ |
| 151 | template <typename T> |
| 152 | SimpleTensor<T> convert_to_symmetric(const SimpleTensor<float> &src, const QuantizationInfo &quantization_info); |
| 153 | |
Giorgio Arena | 1f9ca1d | 2018-03-01 11:13:45 +0000 | [diff] [blame] | 154 | /** Matrix multiply between 2 float simple tensors |
| 155 | * |
| 156 | * @param[in] a Input tensor A |
| 157 | * @param[in] b Input tensor B |
| 158 | * @param[out] out Output tensor |
| 159 | * |
| 160 | */ |
Vidhya Sudhan Loganathan | 71ecf39 | 2018-08-31 16:10:16 +0100 | [diff] [blame] | 161 | template <typename T> |
| 162 | void matrix_multiply(const SimpleTensor<T> &a, const SimpleTensor<T> &b, SimpleTensor<T> &out); |
Giorgio Arena | 1f9ca1d | 2018-03-01 11:13:45 +0000 | [diff] [blame] | 163 | |
| 164 | /** Transpose matrix |
| 165 | * |
| 166 | * @param[in] in Input tensor |
| 167 | * @param[out] out Output tensor |
| 168 | * |
| 169 | */ |
Vidhya Sudhan Loganathan | 71ecf39 | 2018-08-31 16:10:16 +0100 | [diff] [blame] | 170 | template <typename T> |
| 171 | void transpose_matrix(const SimpleTensor<T> &in, SimpleTensor<T> &out); |
Giorgio Arena | 1f9ca1d | 2018-03-01 11:13:45 +0000 | [diff] [blame] | 172 | |
| 173 | /** Get a 2D tile from a tensor |
| 174 | * |
| 175 | * @note In case of out-of-bound reads, the tile will be filled with zeros |
| 176 | * |
| 177 | * @param[in] in Input tensor |
| 178 | * @param[out] tile Tile |
| 179 | * @param[in] coord Coordinates |
| 180 | */ |
| 181 | template <typename T> |
| 182 | void get_tile(const SimpleTensor<T> &in, SimpleTensor<T> &tile, const Coordinates &coord); |
Gian Marco Iodice | f1c2bf0 | 2018-06-13 14:05:54 +0100 | [diff] [blame] | 183 | |
| 184 | /** Fill with zeros the input tensor in the area defined by anchor and shape |
| 185 | * |
| 186 | * @param[in] in Input tensor to fill with zeros |
| 187 | * @param[out] anchor Starting point of the zeros area |
| 188 | * @param[in] shape Ending point of the zeros area |
| 189 | */ |
| 190 | template <typename T> |
| 191 | void zeros(SimpleTensor<T> &in, const Coordinates &anchor, const TensorShape &shape); |
Michele Di Giorgio | ed5a492 | 2018-09-13 16:22:01 +0100 | [diff] [blame] | 192 | |
| 193 | /** Helper function to compute quantized min and max bounds |
| 194 | * |
| 195 | * @param[in] quant_info Quantization info to be used for conversion |
| 196 | * @param[in] min Floating point minimum value to be quantized |
| 197 | * @param[in] max Floating point maximum value to be quantized |
| 198 | */ |
| 199 | std::pair<int, int> get_quantized_bounds(const QuantizationInfo &quant_info, float min, float max); |
Georgios Pinitas | dbdea0d | 2019-10-16 19:21:40 +0100 | [diff] [blame] | 200 | |
Georgios Pinitas | 6e1791b | 2019-12-02 19:01:25 +0000 | [diff] [blame] | 201 | /** Helper function to compute asymmetric quantized signed min and max bounds |
| 202 | * |
| 203 | * @param[in] quant_info Quantization info to be used for conversion |
| 204 | * @param[in] min Floating point minimum value to be quantized |
| 205 | * @param[in] max Floating point maximum value to be quantized |
| 206 | */ |
| 207 | std::pair<int, int> get_quantized_qasymm8_signed_bounds(const QuantizationInfo &quant_info, float min, float max); |
| 208 | |
Georgios Pinitas | dbdea0d | 2019-10-16 19:21:40 +0100 | [diff] [blame] | 209 | /** Helper function to compute symmetric quantized min and max bounds |
| 210 | * |
| 211 | * @param[in] quant_info Quantization info to be used for conversion |
| 212 | * @param[in] min Floating point minimum value to be quantized |
| 213 | * @param[in] max Floating point maximum value to be quantized |
| 214 | * @param[in] channel_id Channel id for per channel quantization info. |
| 215 | */ |
| 216 | std::pair<int, int> get_symm_quantized_per_channel_bounds(const QuantizationInfo &quant_info, float min, float max, size_t channel_id = 0); |
Giorgio Arena | 63825e8 | 2021-03-25 14:54:50 +0000 | [diff] [blame] | 217 | |
Giorgio Arena | ebbb6f9 | 2021-04-13 09:52:18 +0100 | [diff] [blame] | 218 | /** Add random padding along the X axis (between 1 and 16 columns per side) to all the input tensors. |
| 219 | * This is used in our validation suite in order to simulate implicit padding addition after configuring, but before allocating. |
Giorgio Arena | 63825e8 | 2021-03-25 14:54:50 +0000 | [diff] [blame] | 220 | * |
Manuel Bottini | f733e03 | 2021-05-19 16:15:36 +0100 | [diff] [blame] | 221 | * @param[in] tensors List of tensors to add padding to |
| 222 | * @param[in] data_layout (Optional) Data layout of the operator |
| 223 | * @param[in] only_right_pad (Optional) Only right padding testing, in case of cl image padding |
Giorgio Arena | 63825e8 | 2021-03-25 14:54:50 +0000 | [diff] [blame] | 224 | * |
| 225 | * @note This function adds padding to the input tensors only if data_layout == DataLayout::NHWC |
| 226 | */ |
Manuel Bottini | f733e03 | 2021-05-19 16:15:36 +0100 | [diff] [blame] | 227 | void add_padding_x(std::initializer_list<ITensor *> tensors, const DataLayout &data_layout = DataLayout::NHWC, bool only_right_pad = false); |
Gian Marco Iodice | 72b5687 | 2021-06-29 10:08:46 +0100 | [diff] [blame] | 228 | |
Gunes Bayir | 9d0c4de | 2023-04-13 18:22:58 +0100 | [diff] [blame] | 229 | /** For MatMulLowp, given the Lhs/Rhs matrix quantization informations and the matrix multiplication dimensions, |
| 230 | * calculate a suitable output quantization for obtaining non-saturated outputs with high probability. |
| 231 | */ |
| 232 | QuantizationInfo calculate_mat_mul_dst_q_info(const QuantizationInfo &lhs_q_info, const QuantizationInfo &rhs_q_info, int m, int n, int k, DataType data_type); |
Anthony Barbier | 6ff3b19 | 2017-09-04 18:44:23 +0100 | [diff] [blame] | 233 | } // namespace validation |
| 234 | } // namespace test |
| 235 | } // namespace arm_compute |
Anitha Raj | b566b6e | 2023-08-23 11:40:06 +0100 | [diff] [blame] | 236 | #endif // ACL_TESTS_VALIDATION_HELPERS_H |