Anthony Barbier | 6ff3b19 | 2017-09-04 18:44:23 +0100 | [diff] [blame] | 1 | /* |
Michele Di Giorgio | d9eaf61 | 2020-07-08 11:12:57 +0100 | [diff] [blame] | 2 | * Copyright (c) 2016-2020 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 | */ |
Michalis Spyrou | f464337 | 2019-11-29 16:17:13 +0000 | [diff] [blame] | 24 | #ifndef ARM_COMPUTE_NEARITHMETICSUBTRACTION_H |
| 25 | #define ARM_COMPUTE_NEARITHMETICSUBTRACTION_H |
Anthony Barbier | 6ff3b19 | 2017-09-04 18:44:23 +0100 | [diff] [blame] | 26 | |
| 27 | #include "arm_compute/core/Types.h" |
Michalis Spyrou | 173ba9b | 2020-06-23 17:25:43 +0100 | [diff] [blame] | 28 | #include "arm_compute/runtime/IFunction.h" |
| 29 | #include "arm_compute/runtime/NEON/INEOperator.h" |
Anthony Barbier | 6ff3b19 | 2017-09-04 18:44:23 +0100 | [diff] [blame] | 30 | |
| 31 | namespace arm_compute |
| 32 | { |
| 33 | class ITensor; |
| 34 | |
Michalis Spyrou | 173ba9b | 2020-06-23 17:25:43 +0100 | [diff] [blame] | 35 | namespace experimental |
| 36 | { |
Georgios Pinitas | cbf39c6 | 2018-09-10 15:07:45 +0100 | [diff] [blame] | 37 | /** Basic function to run @ref NEArithmeticSubtractionKernel |
| 38 | * |
SiCong Li | 903f8cc | 2020-08-27 10:17:10 +0100 | [diff] [blame] | 39 | * @note The tensor data type for the inputs must be U8/QASYMM8/S16/S32/F16/F32. |
Georgios Pinitas | cbf39c6 | 2018-09-10 15:07:45 +0100 | [diff] [blame] | 40 | * @note The function performs an arithmetic subtraction between two tensors. |
| 41 | * |
| 42 | * This function calls the following kernels: |
Georgios Pinitas | cbf39c6 | 2018-09-10 15:07:45 +0100 | [diff] [blame] | 43 | * -# @ref NEArithmeticSubtractionKernel |
| 44 | */ |
Michalis Spyrou | 173ba9b | 2020-06-23 17:25:43 +0100 | [diff] [blame] | 45 | class NEArithmeticSubtraction : public INEOperator |
Anthony Barbier | 6ff3b19 | 2017-09-04 18:44:23 +0100 | [diff] [blame] | 46 | { |
| 47 | public: |
| 48 | /** Initialise the kernel's inputs, output and conversion policy. |
| 49 | * |
Michele Di Giorgio | f9b595a | 2020-07-03 13:34:52 +0100 | [diff] [blame] | 50 | * Valid configurations (Input1,Input2) -> Output : |
| 51 | * |
| 52 | * - (U8,U8) -> U8 |
| 53 | * - (U8,U8) -> S16 |
| 54 | * - (QASYMM8, QASYMM8) -> QASYMM8 |
| 55 | * - (QASYMM8_SIGNED, QASYMM8_SIGNED) -> QASYMM8_SIGNED |
| 56 | * - (S16,U8) -> S16 |
| 57 | * - (U8,S16) -> S16 |
| 58 | * - (S16,S16) -> S16 |
SiCong Li | 903f8cc | 2020-08-27 10:17:10 +0100 | [diff] [blame] | 59 | * - (S32,S32) -> S32 |
Michele Di Giorgio | f9b595a | 2020-07-03 13:34:52 +0100 | [diff] [blame] | 60 | * - (F16,F16) -> F16 |
| 61 | * - (F32,F32) -> F32 |
| 62 | * |
SiCong Li | 903f8cc | 2020-08-27 10:17:10 +0100 | [diff] [blame] | 63 | * @param[in] input1 First tensor input info. Data types supported: U8/QASYMM8/QASYMM8_SIGNED/QSYMM16/S16/S32/F16/F32 |
| 64 | * @param[in] input2 Second tensor input info. Data types supported: U8/QASYMM8/QASYMM8_SIGNED/QSYMM16/S16/S32/F16/F32 |
| 65 | * @param[out] output Output tensor info. Data types supported: U8/QASYMM8/QASYMM8_SIGNED/QSYMM16/S16/S32/F16/F32 |
Giorgio Arena | 8b2a7d3 | 2020-02-11 17:21:31 +0000 | [diff] [blame] | 66 | * @param[in] policy Policy to use to handle overflow. Convert policy cannot be WRAP if datatype is quantized. |
| 67 | * @param[in] act_info (Optional) Activation layer information in case of a fused activation. Currently not supported. |
Anthony Barbier | 6ff3b19 | 2017-09-04 18:44:23 +0100 | [diff] [blame] | 68 | */ |
Michalis Spyrou | 173ba9b | 2020-06-23 17:25:43 +0100 | [diff] [blame] | 69 | void configure(const ITensorInfo *input1, const ITensorInfo *input2, ITensorInfo *output, ConvertPolicy policy, const ActivationLayerInfo &act_info = ActivationLayerInfo()); |
Ioan-Cristian Szabo | 397d58a | 2017-11-30 15:19:11 +0000 | [diff] [blame] | 70 | /** Static function to check if given info will lead to a valid configuration of @ref NEArithmeticSubtraction |
| 71 | * |
Michele Di Giorgio | f9b595a | 2020-07-03 13:34:52 +0100 | [diff] [blame] | 72 | * Valid configurations (Input1,Input2) -> Output : |
| 73 | * |
| 74 | * - (U8,U8) -> U8 |
| 75 | * - (U8,U8) -> S16 |
| 76 | * - (QASYMM8, QASYMM8) -> QASYMM8 |
| 77 | * - (QASYMM8_SIGNED, QASYMM8_SIGNED) -> QASYMM8_SIGNED |
| 78 | * - (S16,U8) -> S16 |
| 79 | * - (U8,S16) -> S16 |
| 80 | * - (S16,S16) -> S16 |
SiCong Li | 903f8cc | 2020-08-27 10:17:10 +0100 | [diff] [blame] | 81 | * - (S32,S32) -> S32 |
Michele Di Giorgio | f9b595a | 2020-07-03 13:34:52 +0100 | [diff] [blame] | 82 | * - (F16,F16) -> F16 |
| 83 | * - (F32,F32) -> F32 |
| 84 | * |
SiCong Li | 903f8cc | 2020-08-27 10:17:10 +0100 | [diff] [blame] | 85 | * @param[in] input1 First tensor input. Data types supported: U8/QASYMM8/QASYMM8_SIGNED/S16/S32/F16/F32 |
| 86 | * @param[in] input2 Second tensor input. Data types supported: U8/QASYMM8/QASYMM8_SIGNED/S16/S32/F16/F32 |
| 87 | * @param[in] output Output tensor. Data types supported: U8/QASYMM8/QASYMM8_SIGNED/S16/S32/F16/F32 |
Giorgio Arena | 8b2a7d3 | 2020-02-11 17:21:31 +0000 | [diff] [blame] | 88 | * @param[in] policy Policy to use to handle overflow. Convert policy cannot be WRAP if datatype is quantized. |
| 89 | * @param[in] act_info (Optional) Activation layer information in case of a fused activation. Currently not supported. |
Ioan-Cristian Szabo | 397d58a | 2017-11-30 15:19:11 +0000 | [diff] [blame] | 90 | * |
Georgios Pinitas | 631c41a | 2017-12-06 11:53:03 +0000 | [diff] [blame] | 91 | * @return a status |
Ioan-Cristian Szabo | 397d58a | 2017-11-30 15:19:11 +0000 | [diff] [blame] | 92 | */ |
Giorgio Arena | 8b2a7d3 | 2020-02-11 17:21:31 +0000 | [diff] [blame] | 93 | static Status validate(const ITensorInfo *input1, const ITensorInfo *input2, const ITensorInfo *output, ConvertPolicy policy, const ActivationLayerInfo &act_info = ActivationLayerInfo()); |
Michalis Spyrou | 173ba9b | 2020-06-23 17:25:43 +0100 | [diff] [blame] | 94 | }; |
| 95 | } // namespace experimental |
| 96 | |
| 97 | /** Basic function to run @ref NEArithmeticSubtractionKernel |
| 98 | * |
SiCong Li | 903f8cc | 2020-08-27 10:17:10 +0100 | [diff] [blame] | 99 | * @note The tensor data type for the inputs must be U8/QASYMM8/S16/S32/F16/F32. |
Michalis Spyrou | 173ba9b | 2020-06-23 17:25:43 +0100 | [diff] [blame] | 100 | * @note The function performs an arithmetic subtraction between two tensors. |
| 101 | * |
| 102 | * This function calls the following kernels: |
| 103 | * -# @ref NEArithmeticSubtractionKernel |
| 104 | */ |
| 105 | class NEArithmeticSubtraction : public IFunction |
| 106 | { |
| 107 | public: |
| 108 | /** Default Constructor */ |
| 109 | NEArithmeticSubtraction(); |
| 110 | /** Default Destructor */ |
| 111 | ~NEArithmeticSubtraction(); |
| 112 | /** Prevent instances of this class from being copied (As this class contains pointers) */ |
| 113 | NEArithmeticSubtraction(const NEArithmeticSubtraction &) = delete; |
| 114 | /** Default move constructor */ |
| 115 | NEArithmeticSubtraction(NEArithmeticSubtraction &&); |
| 116 | /** Prevent instances of this class from being copied (As this class contains pointers) */ |
| 117 | NEArithmeticSubtraction &operator=(const NEArithmeticSubtraction &) = delete; |
| 118 | /** Default move assignment operator */ |
| 119 | NEArithmeticSubtraction &operator=(NEArithmeticSubtraction &&); |
| 120 | /** Initialise the kernel's inputs, output and conversion policy. |
| 121 | * |
SiCong Li | 903f8cc | 2020-08-27 10:17:10 +0100 | [diff] [blame] | 122 | * @param[in] input1 First tensor input. Data types supported: U8/QASYMM8/QASYMM8_SIGNED/QSYMM16/S16/S32/F16/F32 |
| 123 | * @param[in] input2 Second tensor input. Data types supported: U8/QASYMM8/QASYMM8_SIGNED/QSYMM16/S16/S32/F16/F32 |
| 124 | * @param[out] output Output tensor. Data types supported: U8/QASYMM8/QASYMM8_SIGNED/QSYMM16/S16/S32/F16/F32 |
Michalis Spyrou | 173ba9b | 2020-06-23 17:25:43 +0100 | [diff] [blame] | 125 | * @param[in] policy Policy to use to handle overflow. Convert policy cannot be WRAP if datatype is quantized. |
| 126 | * @param[in] act_info (Optional) Activation layer information in case of a fused activation. Currently not supported. |
| 127 | */ |
| 128 | void configure(const ITensor *input1, const ITensor *input2, ITensor *output, ConvertPolicy policy, const ActivationLayerInfo &act_info = ActivationLayerInfo()); |
| 129 | /** Static function to check if given info will lead to a valid configuration of @ref NEArithmeticSubtraction |
| 130 | * |
SiCong Li | 903f8cc | 2020-08-27 10:17:10 +0100 | [diff] [blame] | 131 | * @param[in] input1 First tensor input. Data types supported: U8/QASYMM8/QASYMM8_SIGNED/S16/S32/F16/F32 |
| 132 | * @param[in] input2 Second tensor input. Data types supported: U8/QASYMM8/QASYMM8_SIGNED/S16/S32/F16/F32 |
| 133 | * @param[in] output Output tensor. Data types supported: U8/QASYMM8/QASYMM8_SIGNED/S16/S32/F16/F32 |
Michalis Spyrou | 173ba9b | 2020-06-23 17:25:43 +0100 | [diff] [blame] | 134 | * @param[in] policy Policy to use to handle overflow. Convert policy cannot be WRAP if datatype is quantized. |
| 135 | * @param[in] act_info (Optional) Activation layer information in case of a fused activation. Currently not supported. |
| 136 | * |
| 137 | * @return a status |
| 138 | */ |
| 139 | static Status validate(const ITensorInfo *input1, const ITensorInfo *input2, const ITensorInfo *output, ConvertPolicy policy, const ActivationLayerInfo &act_info = ActivationLayerInfo()); |
| 140 | |
| 141 | // Inherited methods overridden: |
| 142 | void run() override; |
| 143 | |
| 144 | private: |
| 145 | struct Impl; |
| 146 | std::unique_ptr<Impl> _impl; |
Anthony Barbier | 6ff3b19 | 2017-09-04 18:44:23 +0100 | [diff] [blame] | 147 | }; |
Georgios Pinitas | b2842be | 2020-06-22 21:27:14 +0100 | [diff] [blame] | 148 | } // namespace arm_compute |
Michalis Spyrou | f464337 | 2019-11-29 16:17:13 +0000 | [diff] [blame] | 149 | #endif /* ARM_COMPUTE_NEARITHMETICSUBTRACTION_H */ |