Expression Templates Library (ETL)
pool_2d_expr.hpp
1 //=======================================================================
2 // Copyright (c) 2014-2023 Baptiste Wicht
3 // Distributed under the terms of the MIT License.
4 // (See accompanying file LICENSE or copy at
5 // http://opensource.org/licenses/MIT)
6 //=======================================================================
7 
8 #pragma once
9 
10 #include "etl/expr/base_temporary_expr.hpp"
11 
12 //Get the implementations
13 #include "etl/impl/pooling.hpp"
14 #include "etl/impl/prob_pooling.hpp"
15 
16 namespace etl {
17 
22 template <etl_expr A, size_t C1, size_t C2, size_t S1, size_t S2, size_t P1, size_t P2, typename Impl>
23 struct pool_2d_expr : base_temporary_expr_un<pool_2d_expr<A, C1, C2, S1, S2, P1, P2, Impl>, A> {
28 
29  static constexpr auto storage_order = sub_traits::storage_order;
30 
35  static constexpr bool gpu_computable = Impl::template gpu_computable<A>;
36 
41  explicit pool_2d_expr(A a) : base_type(a) {
42  //Nothing else to init
43  }
44 
45  // Assignment functions
46 
51  template <same_dimensions<A> C>
52  void assign_to(C&& c) const {
53  inc_counter("temp:assign");
54 
55  auto& a = this->a();
56 
57  Impl::template apply<C1, C2, S1, S2, P1, P2>(a, c);
58  }
59 
64  template <etl_expr L>
65  void assign_add_to(L&& lhs) const {
66  std_add_evaluate(*this, lhs);
67  }
68 
73  template <etl_expr L>
74  void assign_sub_to(L&& lhs) const {
75  std_sub_evaluate(*this, lhs);
76  }
77 
82  template <etl_expr L>
83  void assign_mul_to(L&& lhs) const {
84  std_mul_evaluate(*this, lhs);
85  }
86 
91  template <etl_expr L>
92  void assign_div_to(L&& lhs) const {
93  std_div_evaluate(*this, lhs);
94  }
95 
100  template <etl_expr L>
101  void assign_mod_to(L&& lhs) const {
102  std_mod_evaluate(*this, lhs);
103  }
104 
111  friend std::ostream& operator<<(std::ostream& os, const pool_2d_expr& expr) {
112  return os << "pool2(" << expr._a << ")";
113  }
114 };
115 
120 template <etl_expr A, size_t C1, size_t C2, size_t S1, size_t S2, size_t P1, size_t P2, typename Impl>
121 struct etl_traits<etl::pool_2d_expr<A, C1, C2, S1, S2, P1, P2, Impl>> {
123  using sub_expr_t = std::decay_t<A>;
126 
127  static constexpr size_t D = sub_traits::dimensions();
128 
129  static constexpr bool is_etl = true;
130  static constexpr bool is_transformer = false;
131  static constexpr bool is_view = false;
132  static constexpr bool is_magic_view = false;
133  static constexpr bool is_fast = sub_traits::is_fast;
134  static constexpr bool is_linear = false;
135  static constexpr bool is_thread_safe = true;
136  static constexpr bool is_value = false;
137  static constexpr bool is_direct = true;
138  static constexpr bool is_generator = false;
139  static constexpr bool is_padded = false;
140  static constexpr bool is_aligned = true;
141  static constexpr bool is_temporary = true;
142  static constexpr bool gpu_computable = is_gpu_t<value_type> && cuda_enabled;
143  static constexpr order storage_order = sub_traits::storage_order;
144 
150  template <vector_mode_t V>
151  static constexpr bool vectorizable = true;
152 
157  template <size_t DD>
158  static constexpr size_t dim() {
159  return DD == D - 2 ? (decay_traits<A>::template dim<DD>() - C1 + 2 * P1) / S1 + 1
160  : DD == D - 1 ? (decay_traits<A>::template dim<DD>() - C2 + 2 * P2) / S2 + 1 : decay_traits<A>::template dim<DD>();
161  }
162 
169  static size_t dim(const expr_t& e, size_t d) {
170  if (d == D - 2) {
171  return (etl::dim(e._a, d) - C1 + 2 * P1) / S1 + 1;
172  } else if (d == D - 1) {
173  return (etl::dim(e._a, d) - C2 + 2 * P2) / S2 + 1;
174  } else {
175  return etl::dim(e._a, d);
176  }
177  }
178 
184  static size_t size(const expr_t& e) {
185  size_t acc = 1;
186  for (size_t i = 0; i < D; ++i) {
187  acc *= dim(e, i);
188  }
189  return acc;
190  }
191 
196  template <size_t... I>
197  static constexpr size_t size_mul(const std::index_sequence<I...>& /*seq*/) {
198  return (dim<I>() * ...);
199  }
200 
205  static constexpr size_t size() {
206  return size_mul(std::make_index_sequence<D>());
207  }
208 
213  static constexpr size_t dimensions() {
214  return D;
215  }
216 
221  static constexpr int complexity() noexcept {
222  return -1;
223  }
224 };
225 
233 template <size_t C1, size_t C2, size_t S1 = C1, size_t S2 = C2, size_t P1 = 0, size_t P2 = 0, etl_expr E>
235  return pool_2d_expr<detail::build_type<E>, C1, C2, S1, S2, P1, P2, impl::max_pool_2d>{value};
236 }
237 
245 template <size_t C1, size_t C2, size_t S1 = C1, size_t S2 = C2, size_t P1 = 0, size_t P2 = 0, etl_expr E>
247  return pool_2d_expr<detail::build_type<E>, C1, C2, S1, S2, P1, P2, impl::avg_pool_2d>{value};
248 }
249 
257 template <size_t C1, size_t C2, etl_expr E>
259  validate_pmax_pooling<C1, C2>(value);
260  return pool_2d_expr<detail::build_type<E>, C1, C2, C1, C2, 0, 0, impl::standard::pmp_p_impl>{value};
261 }
262 
263 } //end of namespace etl
void assign_div_to(L &&lhs) const
Divide the given left-hand-side expression.
Definition: pool_2d_expr.hpp:92
std::add_lvalue_reference_t< A > a()
Returns the sub expression.
Definition: base_temporary_expr.hpp:489
static constexpr size_t dim()
Returns the DDth dimension of the expression.
Definition: pool_2d_expr.hpp:158
value_t< A > value_type
The type of value of the expression.
Definition: pool_2d_expr.hpp:24
void assign_add_to(L &&lhs) const
Add to the given left-hand-side expression.
Definition: pool_2d_expr.hpp:65
constexpr bool is_magic_view
Traits indicating if the given ETL type is a magic view expression.
Definition: traits.hpp:311
Functor for 2D Average Pooling.
Definition: pooling.hpp:174
A transposition expression.
Definition: pool_2d_expr.hpp:23
D D
The number of dimensions.
Definition: dyn_matrix_view.hpp:24
static size_t dim(const expr_t &e, size_t d)
Returns the dth dimension of the expression.
Definition: pool_2d_expr.hpp:169
order
Storage order of a matrix.
Definition: order.hpp:15
constexpr bool cuda_enabled
Indicates if CUDA is available.
Definition: config.hpp:94
static constexpr auto storage_order
The sub storage order.
Definition: pool_2d_expr.hpp:29
A _a
The sub expression reference.
Definition: base_temporary_expr.hpp:447
constexpr bool is_fast
Traits to test if the given ETL expresion type is fast (sizes known at compile-time) ...
Definition: traits.hpp:588
Traits to get information about ETL types.
Definition: tmp.hpp:68
Root namespace for the ETL library.
Definition: adapter.hpp:15
value_t< A > value_type
The value type of the expression.
Definition: pool_2d_expr.hpp:125
dyn_pool_2d_expr< detail::build_type< E >, impl::max_pool_2d > max_pool_2d(E &&value, size_t c1, size_t c2)
2D Max Pooling of the given matrix expression
Definition: dyn_pool_2d_expr.hpp:211
pool_2d_expr(A a)
Construct a new expression.
Definition: pool_2d_expr.hpp:41
static constexpr size_t dimensions()
Return the number of dimensions of the expression.
Definition: traits_base.hpp:31
Functor for 2D Max Pooling.
Definition: pooling.hpp:94
auto dim(E &&value, size_t i) -> detail::identity_helper< E, dim_view< detail::build_identity_type< E >, D >>
Return a view representing the ith Dth dimension.
Definition: view_expression_builder.hpp:25
void assign_mod_to(L &&lhs) const
Modulo the given left-hand-side expression.
Definition: pool_2d_expr.hpp:101
void std_mod_evaluate(Expr &&expr, Result &&result)
Compound modulo evaluation of the expr into result.
Definition: evaluator.hpp:1271
void std_mul_evaluate(Expr &&expr, Result &&result)
Compound multiply evaluation of the expr into result.
Definition: evaluator.hpp:1233
void assign_mul_to(L &&lhs) const
Multiply the given left-hand-side expression.
Definition: pool_2d_expr.hpp:83
constexpr bool is_transformer
Traits indicating if the given ETL type is a transformer expression.
Definition: traits.hpp:297
static constexpr size_t size()
Returns the size of the expression.
Definition: pool_2d_expr.hpp:205
constexpr bool is_view
Traits indicating if the given ETL type is a view expression.
Definition: traits.hpp:304
static constexpr bool is_fast
Indicates if T is a fast structure.
Definition: traits_base.hpp:25
void assign_sub_to(L &&lhs) const
Sub from the given left-hand-side expression.
Definition: pool_2d_expr.hpp:74
void std_sub_evaluate(Expr &&expr, Result &&result)
Compound subtract evaluation of the expr into result.
Definition: evaluator.hpp:1214
static constexpr int complexity() noexcept
Estimate the complexity of computation.
Definition: pool_2d_expr.hpp:221
Abstract base class for temporary unary expression.
Definition: base_temporary_expr.hpp:443
dyn_pool_2d_expr< detail::build_type< E >, impl::standard::dyn_pmp_p_impl > p_max_pool_p(E &&value, size_t c1, size_t c2)
Probabilistic Max Pooling for pooling units.
Definition: dyn_pool_2d_expr.hpp:259
std::decay_t< A > sub_expr_t
The sub expression type.
Definition: pool_2d_expr.hpp:123
constexpr bool is_thread_safe
Traits to test if the given ETL expresion type is thread safe.
Definition: traits.hpp:687
friend std::ostream & operator<<(std::ostream &os, const pool_2d_expr &expr)
Print a representation of the expression on the given stream.
Definition: pool_2d_expr.hpp:111
static constexpr size_t size_mul(const std::index_sequence< I... > &)
Returns the multiplicative sum of the dimensions at the given indices.
Definition: pool_2d_expr.hpp:197
typename decay_traits< E >::value_type value_t
Traits to extract the value type out of an ETL type.
Definition: tmp.hpp:81
void assign_to(C &&c) const
Assign to a matrix of the same storage order.
Definition: pool_2d_expr.hpp:52
void std_div_evaluate(Expr &&expr, Result &&result)
Compound divide evaluation of the expr into result.
Definition: evaluator.hpp:1252
static constexpr size_t dimensions()
Returns the number of dimensions of the expression.
Definition: pool_2d_expr.hpp:213
void inc_counter([[maybe_unused]] const char *name)
Increase the given counter.
Definition: counters.hpp:25
Implemenetation of Probabilistic Max Pooling for pooling units.
Definition: prob_pooling.hpp:461
static constexpr bool gpu_computable
Indicates if the temporary expression can be directly evaluated using only GPU.
Definition: pool_2d_expr.hpp:35
dyn_pool_2d_expr< detail::build_type< E >, impl::avg_pool_2d > avg_pool_2d(E &&value, size_t c1, size_t c2)
2D Average Pooling of the given matrix expression
Definition: dyn_pool_2d_expr.hpp:235
void std_add_evaluate(Expr &&expr, Result &&result)
Compound add evaluation of the expr into result.
Definition: evaluator.hpp:1195
static size_t size(const expr_t &e)
Returns the size of the expression.
Definition: pool_2d_expr.hpp:184