• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 /*
2  * Copyright (c) 2017-2020 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 #ifndef ARM_COMPUTE_CPPDETECTIONWINDOWNONMAXIMASUPPRESSIONKERNEL_H
25 #define ARM_COMPUTE_CPPDETECTIONWINDOWNONMAXIMASUPPRESSIONKERNEL_H
26 
27 #include "arm_compute/core/CPP/ICPPKernel.h"
28 #include "arm_compute/core/IArray.h"
29 #include "arm_compute/core/IHOG.h"
30 #include "arm_compute/core/Types.h"
31 
32 namespace arm_compute
33 {
34 /** CPP kernel to perform in-place computation of euclidean distance on IDetectionWindowArray
35  *
36  * @note This kernel is meant to be used alongside HOG or other object detection algorithms to perform a non-maxima suppression on a
37  *       IDetectionWindowArray
38  */
39 class CPPDetectionWindowNonMaximaSuppressionKernel : public ICPPKernel
40 {
41 public:
name()42     const char *name() const override
43     {
44         return "CPPDetectionWindowNonMaximaSuppressionKernel";
45     }
46     /** Default constructor */
47     CPPDetectionWindowNonMaximaSuppressionKernel();
48     /** Prevent instances of this class from being copied (As this class contains pointers) */
49     CPPDetectionWindowNonMaximaSuppressionKernel(const CPPDetectionWindowNonMaximaSuppressionKernel &) = delete;
50     /** Prevent instances of this class from being copied (As this class contains pointers) */
51     CPPDetectionWindowNonMaximaSuppressionKernel &operator=(const CPPDetectionWindowNonMaximaSuppressionKernel &) = delete;
52     /** Allow instances of this class to be moved */
53     CPPDetectionWindowNonMaximaSuppressionKernel(CPPDetectionWindowNonMaximaSuppressionKernel &&) = default;
54     /** Allow instances of this class to be moved */
55     CPPDetectionWindowNonMaximaSuppressionKernel &operator=(CPPDetectionWindowNonMaximaSuppressionKernel &&) = default;
56     /** Default destructor */
57     ~CPPDetectionWindowNonMaximaSuppressionKernel() = default;
58     /** Initialise the kernel's input, output and the euclidean minimum distance
59      *
60      * @attention: If @ref IDetectionWindowArray is passed to the kernel, the map() and unmap() methods @ref IDetectionWindowArray must be called respectively before and after
61      *             the run() method of @ref CPPDetectionWindowNonMaximaSuppressionKernel
62      *
63      * @param[in, out] input_output Input/Output array of @ref DetectionWindow
64      * @param[in]      min_distance Radial Euclidean distance for non-maxima suppression
65      */
66     void configure(IDetectionWindowArray *input_output, float min_distance);
67 
68     // Inherited methods overridden:
69     void run(const Window &window, const ThreadInfo &info) override;
70     bool is_parallelisable() const override;
71 
72 private:
73     IDetectionWindowArray *_input_output;
74     float                  _min_distance;
75 };
76 } // namespace arm_compute
77 #endif /* ARM_COMPUTE_CPPDETECTIONWINDOWNONMAXIMASUPPRESSIONKERNEL_H */
78