1 /*
2 * Copyright (c) 2019-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/NEScheduler.h"
25
26 #include "arm_compute/runtime/NEON/functions/NECropResize.h"
27 #include "src/core/NEON/kernels/NECropKernel.h"
28
29 #include "support/MemorySupport.h"
30
31 #include <cstddef>
32
33 namespace arm_compute
34 {
35 NECropResize::~NECropResize() = default;
36
NECropResize()37 NECropResize::NECropResize()
38 : _output(nullptr), _num_boxes(0), _method(), _extrapolation_value(0), _crop(), _scale(), _crop_results(), _scaled_results()
39 {
40 }
41
validate(const ITensorInfo * input,const ITensorInfo * boxes,const ITensorInfo * box_ind,const ITensorInfo * output,Coordinates2D crop_size,InterpolationPolicy method,float extrapolation_value)42 Status NECropResize::validate(const ITensorInfo *input, const ITensorInfo *boxes, const ITensorInfo *box_ind, const ITensorInfo *output,
43 Coordinates2D crop_size, InterpolationPolicy method, float extrapolation_value)
44 {
45 ARM_COMPUTE_RETURN_ERROR_ON(crop_size.x <= 0 || crop_size.y <= 0);
46 ARM_COMPUTE_RETURN_ERROR_ON(method == InterpolationPolicy::AREA);
47 TensorInfo temp_info;
48 ARM_COMPUTE_RETURN_ON_ERROR(NECropKernel::validate(input->clone().get(), boxes->clone().get(), box_ind->clone().get(), &temp_info, boxes->tensor_shape()[1] - 1, extrapolation_value));
49 if(output->total_size() > 0)
50 {
51 ARM_COMPUTE_RETURN_ERROR_ON_DATA_TYPE_NOT_IN(output, DataType::F32);
52 ARM_COMPUTE_RETURN_ERROR_ON_MISMATCHING_DATA_LAYOUT(input, output);
53 TensorShape out_shape(input->tensor_shape()[0], crop_size.x, crop_size.y, boxes->tensor_shape()[1]);
54 ARM_COMPUTE_RETURN_ERROR_ON_MISMATCHING_DIMENSIONS(output->tensor_shape(), out_shape);
55 }
56 return Status{};
57 }
58
configure(const ITensor * input,const ITensor * boxes,const ITensor * box_ind,ITensor * output,Coordinates2D crop_size,InterpolationPolicy method,float extrapolation_value)59 void NECropResize::configure(const ITensor *input, const ITensor *boxes, const ITensor *box_ind, ITensor *output, Coordinates2D crop_size,
60 InterpolationPolicy method, float extrapolation_value)
61 {
62 ARM_COMPUTE_ERROR_ON_NULLPTR(input, output);
63 ARM_COMPUTE_ERROR_THROW_ON(NECropResize::validate(input->info(), boxes->info(), box_ind->info(), output->info(), crop_size, method, extrapolation_value));
64
65 _num_boxes = boxes->info()->tensor_shape()[1];
66 TensorShape out_shape(input->info()->tensor_shape()[0], crop_size.x, crop_size.y);
67
68 _output = output;
69 _method = method;
70 _extrapolation_value = extrapolation_value;
71
72 // For each crop box:
73 // - A crop kernel is used to extract the initial cropped image as specified by boxes[i] from the 3D image input[box_ind[i]].
74 // - A tensor is required to hold this initial cropped image.
75 // - A scale function is used to resize the cropped image to the size specified by crop_size.
76 // - A tensor is required to hold the final scaled image before it is copied into the 4D output
77 // that will hold all final cropped and scaled 3D images.
78 _crop.reserve(_num_boxes);
79 _crop_results.reserve(_num_boxes);
80 _scaled_results.reserve(_num_boxes);
81 _scale.reserve(_num_boxes);
82
83 for(unsigned int i = 0; i < _num_boxes; ++i)
84 {
85 auto crop_tensor = support::cpp14::make_unique<Tensor>();
86 TensorInfo crop_result_info(1, DataType::F32);
87 crop_result_info.set_data_layout(DataLayout::NHWC);
88 crop_tensor->allocator()->init(crop_result_info);
89
90 auto scale_tensor = support::cpp14::make_unique<Tensor>();
91 TensorInfo scaled_result_info(out_shape, 1, DataType::F32);
92 scaled_result_info.set_data_layout(DataLayout::NHWC);
93 scale_tensor->allocator()->init(scaled_result_info);
94
95 auto crop_kernel = support::cpp14::make_unique<NECropKernel>();
96 auto scale_kernel = support::cpp14::make_unique<NEScale>();
97 crop_kernel->configure(input, boxes, box_ind, crop_tensor.get(), i, _extrapolation_value);
98
99 _crop.emplace_back(std::move(crop_kernel));
100 _scaled_results.emplace_back(std::move(scale_tensor));
101 _crop_results.emplace_back(std::move(crop_tensor));
102 _scale.emplace_back(std::move(scale_kernel));
103 }
104 }
105
run()106 void NECropResize::run()
107 {
108 ARM_COMPUTE_ERROR_ON_MSG(_output == nullptr, "Unconfigured function");
109
110 for(unsigned int i = 0; i < _num_boxes; ++i)
111 {
112 // Size of the crop box in _boxes and thus the shape of _crop_results[i]
113 // may not be known until run-time and so the kernels cannot be configured until then.
114 _crop[i]->configure_output_shape();
115 _crop_results[i]->allocator()->allocate();
116 NEScheduler::get().schedule(_crop[i].get(), Window::DimZ);
117
118 // Scale the cropped image.
119 _scale[i]->configure(_crop_results[i].get(), _scaled_results[i].get(), ScaleKernelInfo{ _method, BorderMode::CONSTANT, PixelValue(_extrapolation_value), SamplingPolicy::TOP_LEFT, false });
120 _scaled_results[i]->allocator()->allocate();
121 _scale[i]->run();
122
123 // Copy scaled image into output.
124 std::copy_n(_scaled_results[i]->buffer(), _scaled_results[i]->info()->total_size(), _output->ptr_to_element(Coordinates(0, 0, 0, i)));
125 }
126 }
127 } // namespace arm_compute