1 /*
2 * Copyright (c) 2016-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 #include "arm_compute/runtime/NEON/functions/NEHOGDescriptor.h"
25
26 #include "arm_compute/core/Error.h"
27 #include "arm_compute/core/HOGInfo.h"
28 #include "arm_compute/core/Size2D.h"
29 #include "arm_compute/core/Validate.h"
30 #include "arm_compute/runtime/NEON/NEScheduler.h"
31 #include "src/core/NEON/kernels/NEDerivativeKernel.h"
32 #include "src/core/NEON/kernels/NEFillBorderKernel.h"
33 #include "src/core/NEON/kernels/NEHOGDescriptorKernel.h"
34 #include "support/MemorySupport.h"
35
36 namespace arm_compute
37 {
38 NEHOGDescriptor::~NEHOGDescriptor() = default;
39
NEHOGDescriptor(std::shared_ptr<IMemoryManager> memory_manager)40 NEHOGDescriptor::NEHOGDescriptor(std::shared_ptr<IMemoryManager> memory_manager)
41 : _memory_group(std::move(memory_manager)), _gradient(), _orient_bin(), _block_norm(), _mag(), _phase(), _hog_space()
42 {
43 }
44
configure(ITensor * input,ITensor * output,const IHOG * hog,BorderMode border_mode,uint8_t constant_border_value)45 void NEHOGDescriptor::configure(ITensor *input, ITensor *output, const IHOG *hog, BorderMode border_mode, uint8_t constant_border_value)
46 {
47 ARM_COMPUTE_ERROR_ON_DATA_TYPE_CHANNEL_NOT_IN(input, 1, DataType::U8);
48 ARM_COMPUTE_ERROR_ON(nullptr == output);
49 ARM_COMPUTE_ERROR_ON(nullptr == hog);
50
51 const HOGInfo *hog_info = hog->info();
52 const size_t width = input->info()->dimension(Window::DimX);
53 const size_t height = input->info()->dimension(Window::DimY);
54 const size_t num_bins = hog_info->num_bins();
55
56 Size2D cell_size = hog_info->cell_size();
57
58 // Calculate number of cells along the x and y directions for the hog_space
59 const size_t num_cells_x = width / cell_size.width;
60 const size_t num_cells_y = height / cell_size.height;
61
62 // TensorShape of the input image
63 const TensorShape &shape_img = input->info()->tensor_shape();
64
65 // TensorShape of the hog space
66 TensorShape shape_hog_space = input->info()->tensor_shape();
67 shape_hog_space.set(Window::DimX, num_cells_x);
68 shape_hog_space.set(Window::DimY, num_cells_y);
69
70 // Allocate memory for magnitude, phase and hog space
71 TensorInfo info_mag(shape_img, Format::S16);
72 _mag.allocator()->init(info_mag);
73
74 TensorInfo info_phase(shape_img, Format::U8);
75 _phase.allocator()->init(info_phase);
76
77 TensorInfo info_space(shape_hog_space, num_bins, DataType::F32);
78 _hog_space.allocator()->init(info_space);
79
80 // Manage intermediate buffers
81 _memory_group.manage(&_mag);
82 _memory_group.manage(&_phase);
83
84 // Initialise gradient kernel
85 _gradient.configure(input, &_mag, &_phase, hog_info->phase_type(), border_mode, constant_border_value);
86
87 // Manage intermediate buffers
88 _memory_group.manage(&_hog_space);
89
90 // Initialise orientation binning kernel
91 _orient_bin = arm_compute::support::cpp14::make_unique<NEHOGOrientationBinningKernel>();
92 _orient_bin->configure(&_mag, &_phase, &_hog_space, hog->info());
93
94 // Initialize HOG norm kernel
95 _block_norm = arm_compute::support::cpp14::make_unique<NEHOGBlockNormalizationKernel>();
96 _block_norm->configure(&_hog_space, output, hog->info());
97
98 // Allocate intermediate tensors
99 _mag.allocator()->allocate();
100 _phase.allocator()->allocate();
101 _hog_space.allocator()->allocate();
102 }
103
run()104 void NEHOGDescriptor::run()
105 {
106 MemoryGroupResourceScope scope_mg(_memory_group);
107
108 // Run gradient
109 _gradient.run();
110
111 // Run orientation binning kernel
112 NEScheduler::get().schedule(_orient_bin.get(), Window::DimY);
113
114 // Run block normalization kernel
115 NEScheduler::get().schedule(_block_norm.get(), Window::DimY);
116 }
117 } // namespace arm_compute
118