Anthony Barbier | 6ff3b19 | 2017-09-04 18:44:23 +0100 | [diff] [blame] | 1 | /* |
SiCong Li | b63b119 | 2022-01-28 18:24:39 +0000 | [diff] [blame] | 2 | * Copyright (c) 2016-2020, 2022 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 | */ |
| 24 | namespace arm_compute |
| 25 | { |
| 26 | inline Window::Window(const Window &src) |
Sang-Hoon Park | cecb0a7 | 2019-09-17 08:59:09 +0100 | [diff] [blame] | 27 | : _dims(), _is_broadcasted(utility::generate_array<bool, Coordinates::num_max_dimensions, false>::value) |
Anthony Barbier | 6ff3b19 | 2017-09-04 18:44:23 +0100 | [diff] [blame] | 28 | { |
| 29 | for(size_t i = 0; i < Coordinates::num_max_dimensions; ++i) |
| 30 | { |
| 31 | set(i, src[i]); |
Sang-Hoon Park | cecb0a7 | 2019-09-17 08:59:09 +0100 | [diff] [blame] | 32 | _is_broadcasted[i] = src.is_broadcasted(i); |
Anthony Barbier | 6ff3b19 | 2017-09-04 18:44:23 +0100 | [diff] [blame] | 33 | } |
| 34 | } |
| 35 | |
Georgios Pinitas | f52cd78 | 2019-03-25 14:06:14 +0000 | [diff] [blame] | 36 | inline Window &Window::operator=(const arm_compute::Window &rhs) |
| 37 | { |
| 38 | Window tmp(rhs); |
| 39 | swap(*this, tmp); |
| 40 | return *this; |
| 41 | } |
| 42 | |
Moritz Pflanzer | c186b57 | 2017-09-07 09:48:04 +0100 | [diff] [blame] | 43 | inline constexpr const Window::Dimension &Window::operator[](size_t dimension) const |
Anthony Barbier | 6ff3b19 | 2017-09-04 18:44:23 +0100 | [diff] [blame] | 44 | { |
| 45 | // Precondition: dimension < Coordinates::num_max_dimensions |
| 46 | return _dims.at(dimension); |
| 47 | } |
Diego Lopez Recas | 0021d75 | 2017-12-18 14:42:56 +0000 | [diff] [blame] | 48 | |
Moritz Pflanzer | c186b57 | 2017-09-07 09:48:04 +0100 | [diff] [blame] | 49 | inline void Window::set(size_t dimension, const Window::Dimension &dim) |
Anthony Barbier | 6ff3b19 | 2017-09-04 18:44:23 +0100 | [diff] [blame] | 50 | { |
| 51 | ARM_COMPUTE_ERROR_ON(dimension >= Coordinates::num_max_dimensions); |
| 52 | _dims[dimension] = dim; |
| 53 | } |
| 54 | |
Sang-Hoon Park | cecb0a7 | 2019-09-17 08:59:09 +0100 | [diff] [blame] | 55 | inline void Window::set_broadcasted(size_t dimension) |
| 56 | { |
| 57 | ARM_COMPUTE_ERROR_ON(dimension >= Coordinates::num_max_dimensions); |
| 58 | set(dimension, Dimension(0, 0, 0)); |
| 59 | _is_broadcasted[dimension] = true; |
| 60 | } |
| 61 | |
| 62 | inline bool Window::is_broadcasted(size_t dimension) const |
| 63 | { |
| 64 | ARM_COMPUTE_ERROR_ON(dimension >= Coordinates::num_max_dimensions); |
| 65 | return _is_broadcasted[dimension]; |
| 66 | } |
| 67 | |
Diego Lopez Recas | 0021d75 | 2017-12-18 14:42:56 +0000 | [diff] [blame] | 68 | inline Window Window::collapse_if_possible(const Window &full_window, const size_t first, |
| 69 | const size_t last, bool *has_collapsed) const |
Anthony Barbier | be35b0e | 2017-07-11 18:13:08 +0100 | [diff] [blame] | 70 | { |
Diego Lopez Recas | 0021d75 | 2017-12-18 14:42:56 +0000 | [diff] [blame] | 71 | Window collapsed(*this); |
Anthony Barbier | be35b0e | 2017-07-11 18:13:08 +0100 | [diff] [blame] | 72 | |
Diego Lopez Recas | 0021d75 | 2017-12-18 14:42:56 +0000 | [diff] [blame] | 73 | bool is_collapsable = true; |
| 74 | int collapsed_end = _dims[first].end(); |
| 75 | |
| 76 | for(size_t d = first + 1; is_collapsable && (d < last); ++d) |
| 77 | { |
| 78 | // The _dims's dimension must match the full _dims dimension to be collapsable: |
| 79 | is_collapsable = (_dims[d].start() == 0) && (full_window[d].start() == 0) && (_dims[d].step() <= 1) |
| 80 | && (full_window[d].end() == _dims[d].end()); |
| 81 | collapsed_end *= _dims[d].end(); |
| 82 | } |
| 83 | |
| 84 | if(is_collapsable) |
| 85 | { |
| 86 | collapsed._dims.at(first).set_end(collapsed_end); |
| 87 | for(size_t d = first + 1; is_collapsable && (d < last); ++d) |
Anthony Barbier | be35b0e | 2017-07-11 18:13:08 +0100 | [diff] [blame] | 88 | { |
Diego Lopez Recas | 0021d75 | 2017-12-18 14:42:56 +0000 | [diff] [blame] | 89 | collapsed.set(d, Dimension()); |
Anthony Barbier | be35b0e | 2017-07-11 18:13:08 +0100 | [diff] [blame] | 90 | } |
| 91 | } |
Diego Lopez Recas | 0021d75 | 2017-12-18 14:42:56 +0000 | [diff] [blame] | 92 | |
| 93 | if(has_collapsed != nullptr) |
| 94 | { |
| 95 | *has_collapsed = is_collapsable; |
| 96 | } |
| 97 | |
Anthony Barbier | be35b0e | 2017-07-11 18:13:08 +0100 | [diff] [blame] | 98 | return collapsed; |
| 99 | } |
| 100 | |
Michalis Spyrou | 995f552 | 2018-01-29 13:43:35 +0000 | [diff] [blame] | 101 | inline Window Window::shift_dimensions(unsigned int shift_value) const |
| 102 | { |
| 103 | Window shifted_window; |
| 104 | for(size_t n = 0; n < (Coordinates::num_max_dimensions - shift_value); n++) |
| 105 | { |
| 106 | shifted_window.set(n, _dims[n + shift_value]); |
| 107 | } |
| 108 | return shifted_window; |
| 109 | } |
| 110 | |
Diego Lopez Recas | 0021d75 | 2017-12-18 14:42:56 +0000 | [diff] [blame] | 111 | inline Window Window::collapse(const Window &full_window, const size_t first, const size_t last) const |
Michalis Spyrou | 5237e01 | 2018-01-17 09:40:27 +0000 | [diff] [blame] | 112 | { |
Diego Lopez Recas | 0021d75 | 2017-12-18 14:42:56 +0000 | [diff] [blame] | 113 | bool has_collapsed = false; |
| 114 | Window collapsed = collapse_if_possible(full_window, first, last, &has_collapsed); |
Michalis Spyrou | 5237e01 | 2018-01-17 09:40:27 +0000 | [diff] [blame] | 115 | // Make sure that the window has collapsed |
Diego Lopez Recas | 0021d75 | 2017-12-18 14:42:56 +0000 | [diff] [blame] | 116 | ARM_COMPUTE_ERROR_ON(!has_collapsed); |
Michalis Spyrou | 5237e01 | 2018-01-17 09:40:27 +0000 | [diff] [blame] | 117 | return collapsed; |
| 118 | } |
| 119 | |
Diego Lopez Recas | 0021d75 | 2017-12-18 14:42:56 +0000 | [diff] [blame] | 120 | inline Window Window::broadcast_if_dimension_le_one(const TensorShape &shape) const |
| 121 | { |
| 122 | Window broadcastWin(*this); |
| 123 | for(size_t d = 0; d < TensorShape::num_max_dimensions; ++d) |
| 124 | { |
| 125 | if(shape[d] <= 1) |
| 126 | { |
Sang-Hoon Park | cecb0a7 | 2019-09-17 08:59:09 +0100 | [diff] [blame] | 127 | broadcastWin.set_broadcasted(d); |
Diego Lopez Recas | 0021d75 | 2017-12-18 14:42:56 +0000 | [diff] [blame] | 128 | } |
| 129 | } |
| 130 | return broadcastWin; |
| 131 | } |
| 132 | |
Moritz Pflanzer | c186b57 | 2017-09-07 09:48:04 +0100 | [diff] [blame] | 133 | inline void Window::shift(size_t dimension, int shift_value) |
Anthony Barbier | 6ff3b19 | 2017-09-04 18:44:23 +0100 | [diff] [blame] | 134 | { |
| 135 | ARM_COMPUTE_ERROR_ON(dimension >= Coordinates::num_max_dimensions); |
| 136 | Window::Dimension &d = _dims[dimension]; |
| 137 | d = Window::Dimension(d.start() + shift_value, d.end() + shift_value, d.step()); |
| 138 | } |
| 139 | |
| 140 | inline void Window::adjust(size_t dimension, int adjust_value, bool is_at_start) |
| 141 | { |
| 142 | ARM_COMPUTE_ERROR_ON(dimension >= Coordinates::num_max_dimensions); |
| 143 | Window::Dimension &d = _dims[dimension]; |
| 144 | |
| 145 | if(is_at_start) |
| 146 | { |
| 147 | d = Window::Dimension(d.start() + adjust_value, d.end(), d.step()); |
| 148 | } |
| 149 | else |
| 150 | { |
| 151 | d = Window::Dimension(d.start(), d.end() + adjust_value, d.step()); |
| 152 | } |
| 153 | } |
| 154 | |
Moritz Pflanzer | c186b57 | 2017-09-07 09:48:04 +0100 | [diff] [blame] | 155 | inline void Window::scale(size_t dimension, float scale_value) |
Anthony Barbier | 6ff3b19 | 2017-09-04 18:44:23 +0100 | [diff] [blame] | 156 | { |
| 157 | ARM_COMPUTE_ERROR_ON(dimension >= Coordinates::num_max_dimensions); |
Anthony Barbier | 7d920f4 | 2018-06-04 14:09:09 +0100 | [diff] [blame] | 158 | Window::Dimension &d = _dims[dimension]; |
| 159 | const int scaled_step = d.step() * scale_value; |
| 160 | const int scaled_start = d.start() * scale_value; |
| 161 | const int scaled_diff = (d.end() - d.start()) * scale_value; |
| 162 | const int scaled_end = scaled_start + ceil_to_multiple(scaled_diff, scaled_step); |
| 163 | |
| 164 | d = Window::Dimension(scaled_start, scaled_end, scaled_step); |
Anthony Barbier | 6ff3b19 | 2017-09-04 18:44:23 +0100 | [diff] [blame] | 165 | } |
| 166 | |
Moritz Pflanzer | c186b57 | 2017-09-07 09:48:04 +0100 | [diff] [blame] | 167 | inline void Window::set_dimension_step(size_t dimension, int step) |
Anthony Barbier | 6ff3b19 | 2017-09-04 18:44:23 +0100 | [diff] [blame] | 168 | { |
| 169 | ARM_COMPUTE_ERROR_ON(dimension >= Coordinates::num_max_dimensions); |
| 170 | _dims[dimension].set_step(step); |
| 171 | } |
| 172 | |
| 173 | inline void Window::validate() const |
| 174 | { |
| 175 | for(size_t i = 0; i < Coordinates::num_max_dimensions; ++i) |
| 176 | { |
Moritz Pflanzer | 6c6597c | 2017-09-24 12:09:41 +0100 | [diff] [blame] | 177 | ARM_COMPUTE_ERROR_ON(_dims[i].end() < _dims[i].start()); |
Diego Lopez Recas | 0021d75 | 2017-12-18 14:42:56 +0000 | [diff] [blame] | 178 | ARM_COMPUTE_ERROR_ON((_dims[i].step() != 0) && (((_dims[i].end() - _dims[i].start()) % _dims[i].step()) != 0)); |
Anthony Barbier | 6ff3b19 | 2017-09-04 18:44:23 +0100 | [diff] [blame] | 179 | } |
| 180 | } |
| 181 | |
| 182 | inline constexpr size_t Window::num_iterations(size_t dimension) const |
| 183 | { |
| 184 | // Precondition: dimension < Coordinates::num_max_dimensions |
| 185 | // Precondition: (end - start) % step == 0 |
| 186 | return (_dims.at(dimension).end() - _dims.at(dimension).start()) / _dims.at(dimension).step(); |
| 187 | } |
| 188 | |
Moritz Pflanzer | c186b57 | 2017-09-07 09:48:04 +0100 | [diff] [blame] | 189 | inline Window Window::split_window(size_t dimension, size_t id, size_t total) const |
Anthony Barbier | 6ff3b19 | 2017-09-04 18:44:23 +0100 | [diff] [blame] | 190 | { |
| 191 | ARM_COMPUTE_ERROR_ON(id >= total); |
| 192 | ARM_COMPUTE_ERROR_ON(dimension >= Coordinates::num_max_dimensions); |
| 193 | |
| 194 | Window out; |
| 195 | |
| 196 | for(size_t d = 0; d < Coordinates::num_max_dimensions; ++d) |
| 197 | { |
| 198 | if(d == dimension) |
| 199 | { |
Sheri Zhang | d80792a | 2020-11-05 10:43:37 +0000 | [diff] [blame] | 200 | int start = _dims[d].start(); |
| 201 | int end = _dims[d].end(); |
| 202 | const int step = _dims[d].step(); |
Anthony Barbier | 6ff3b19 | 2017-09-04 18:44:23 +0100 | [diff] [blame] | 203 | |
Joseph Dobson | 51ca6ae | 2020-02-11 13:10:39 +0000 | [diff] [blame] | 204 | const int num_it = num_iterations(d); |
| 205 | const int rem = num_it % total; |
Sheri Zhang | d80792a | 2020-11-05 10:43:37 +0000 | [diff] [blame] | 206 | int work = num_it / total; |
Anthony Barbier | 6ff3b19 | 2017-09-04 18:44:23 +0100 | [diff] [blame] | 207 | |
Sheri Zhang | d80792a | 2020-11-05 10:43:37 +0000 | [diff] [blame] | 208 | int it_start = work * id; |
Joseph Dobson | 51ca6ae | 2020-02-11 13:10:39 +0000 | [diff] [blame] | 209 | |
| 210 | if(int(id) < rem) |
Anthony Barbier | 6ff3b19 | 2017-09-04 18:44:23 +0100 | [diff] [blame] | 211 | { |
Joseph Dobson | 51ca6ae | 2020-02-11 13:10:39 +0000 | [diff] [blame] | 212 | ++work; |
| 213 | it_start += id; |
| 214 | } |
| 215 | else |
| 216 | { |
| 217 | it_start += rem; |
Anthony Barbier | 6ff3b19 | 2017-09-04 18:44:23 +0100 | [diff] [blame] | 218 | } |
| 219 | |
Joseph Dobson | 51ca6ae | 2020-02-11 13:10:39 +0000 | [diff] [blame] | 220 | start += it_start * step; |
| 221 | end = std::min(end, start + work * step); |
| 222 | |
| 223 | out.set(d, Dimension(start, end, step)); |
Anthony Barbier | 6ff3b19 | 2017-09-04 18:44:23 +0100 | [diff] [blame] | 224 | } |
| 225 | else |
| 226 | { |
| 227 | out.set(d, _dims[d]); |
| 228 | } |
| 229 | } |
| 230 | |
| 231 | return out; |
| 232 | } |
| 233 | |
| 234 | template <unsigned int window_dimension> |
| 235 | inline bool Window::slide_window_slice(Window &slice) const |
| 236 | { |
| 237 | for(unsigned int n = window_dimension; n < Coordinates::num_max_dimensions; ++n) |
| 238 | { |
| 239 | // Did we reach the end of this dimension? |
| 240 | const int v = slice._dims[n].start() + 1; |
| 241 | |
| 242 | if(v < _dims[n].end()) |
| 243 | { |
| 244 | // No: increment |
| 245 | slice._dims[n] = Dimension(v, v + 1, 1); |
| 246 | |
| 247 | // Reset lower dimensions: |
| 248 | for(unsigned int lower = window_dimension; lower < n; ++lower) |
| 249 | { |
| 250 | slice._dims[lower] = Dimension(_dims[lower].start(), _dims[lower].start() + 1, 1); |
| 251 | } |
| 252 | return true; |
| 253 | } |
| 254 | } |
| 255 | |
| 256 | // It was the last slice |
| 257 | return false; // Iteration over |
| 258 | } |
| 259 | |
| 260 | template <unsigned int window_dimension> |
| 261 | inline Window Window::first_slice_window() const |
| 262 | { |
| 263 | Window slice; |
| 264 | |
| 265 | std::copy_n(_dims.begin(), window_dimension, slice._dims.begin()); |
| 266 | |
| 267 | //Initialise higher dimensions to be the first slice. |
| 268 | for(unsigned int n = window_dimension; n < Coordinates::num_max_dimensions; ++n) |
| 269 | { |
| 270 | slice._dims[n] = Dimension(_dims[n].start(), _dims[n].start() + 1, 1); |
| 271 | } |
| 272 | |
| 273 | return slice; |
| 274 | } |
| 275 | |
SiCong Li | 86b5333 | 2017-08-23 11:02:43 +0100 | [diff] [blame] | 276 | inline void Window::use_tensor_dimensions(const TensorShape &shape, size_t first_dimension) |
Anthony Barbier | 6ff3b19 | 2017-09-04 18:44:23 +0100 | [diff] [blame] | 277 | { |
SiCong Li | 86b5333 | 2017-08-23 11:02:43 +0100 | [diff] [blame] | 278 | for(unsigned int n = first_dimension; n < shape.num_dimensions(); ++n) |
Anthony Barbier | 6ff3b19 | 2017-09-04 18:44:23 +0100 | [diff] [blame] | 279 | { |
Sheri Zhang | d80792a | 2020-11-05 10:43:37 +0000 | [diff] [blame] | 280 | set(n, Window::Dimension(0, std::max(shape[n], static_cast<size_t>(1)))); |
Anthony Barbier | 6ff3b19 | 2017-09-04 18:44:23 +0100 | [diff] [blame] | 281 | } |
| 282 | } |
Anthony Barbier | 671a11e | 2018-07-06 15:11:36 +0100 | [diff] [blame] | 283 | |
| 284 | inline TensorShape Window::shape() const |
| 285 | { |
| 286 | TensorShape shape; |
| 287 | for(size_t d = 0; d < TensorShape::num_max_dimensions; ++d) |
| 288 | { |
| 289 | shape.set(d, (_dims[d].end() - _dims[d].start()) / _dims[d].step()); |
| 290 | } |
| 291 | return shape; |
| 292 | } |
| 293 | |
| 294 | inline size_t Window::num_iterations_total() const |
| 295 | { |
| 296 | size_t total = 1; |
| 297 | for(size_t d = 0; d < Coordinates::num_max_dimensions; ++d) |
| 298 | { |
| 299 | total *= num_iterations(d); |
| 300 | } |
| 301 | return total; |
| 302 | } |
Georgios Pinitas | f52cd78 | 2019-03-25 14:06:14 +0000 | [diff] [blame] | 303 | |
| 304 | inline void swap(Window &lhs, Window &rhs) |
| 305 | { |
| 306 | lhs._dims.swap(rhs._dims); |
Anthony Barbier | 6ff3b19 | 2017-09-04 18:44:23 +0100 | [diff] [blame] | 307 | } |
SiCong Li | b63b119 | 2022-01-28 18:24:39 +0000 | [diff] [blame] | 308 | |
| 309 | inline bool operator==(const Window &lhs, const Window &rhs) |
| 310 | { |
| 311 | return (lhs._dims == rhs._dims) && (lhs._is_broadcasted == rhs._is_broadcasted); |
| 312 | } |
Georgios Pinitas | f52cd78 | 2019-03-25 14:06:14 +0000 | [diff] [blame] | 313 | } // namespace arm_compute |