1 //---------------------------------------------------------------------------//
2 // Copyright (c) 2013 Kyle Lutz <kyle.r.lutz@gmail.com>
4 // Distributed under the Boost Software License, Version 1.0
5 // See accompanying file LICENSE_1_0.txt or copy at
6 // http://www.boost.org/LICENSE_1_0.txt
8 // See http://boostorg.github.com/compute for more information.
9 //---------------------------------------------------------------------------//
11 #ifndef BOOST_COMPUTE_CONTAINER_VALARRAY_HPP
12 #define BOOST_COMPUTE_CONTAINER_VALARRAY_HPP
17 #include <boost/static_assert.hpp>
18 #include <boost/type_traits.hpp>
20 #include <boost/compute/buffer.hpp>
21 #include <boost/compute/algorithm/copy.hpp>
22 #include <boost/compute/algorithm/fill.hpp>
23 #include <boost/compute/algorithm/max_element.hpp>
24 #include <boost/compute/algorithm/min_element.hpp>
25 #include <boost/compute/algorithm/transform.hpp>
26 #include <boost/compute/algorithm/accumulate.hpp>
27 #include <boost/compute/detail/buffer_value.hpp>
28 #include <boost/compute/functional.hpp>
29 #include <boost/compute/functional/bind.hpp>
30 #include <boost/compute/iterator/buffer_iterator.hpp>
31 #include <boost/compute/type_traits.hpp>
40 explicit valarray(const context &context = system::default_context())
41 : m_buffer(context, 0)
45 explicit valarray(size_t size,
46 const context &context = system::default_context())
47 : m_buffer(context, size * sizeof(T))
51 valarray(const T &value,
53 const context &context = system::default_context())
54 : m_buffer(context, size * sizeof(T))
56 fill(begin(), end(), value);
59 valarray(const T *values,
61 const context &context = system::default_context())
62 : m_buffer(context, size * sizeof(T))
64 copy(values, values + size, begin());
67 valarray(const valarray<T> &other)
68 : m_buffer(other.m_buffer.get_context(), other.size() * sizeof(T))
72 valarray(const std::valarray<T> &valarray,
73 const context &context = system::default_context())
74 : m_buffer(context, valarray.size() * sizeof(T))
76 copy(&valarray[0], &valarray[valarray.size()], begin());
79 valarray<T>& operator=(const valarray<T> &other)
82 // change to other's OpenCL context
83 m_buffer = buffer(other.m_buffer.get_context(), other.size() * sizeof(T));
84 copy(other.begin(), other.end(), begin());
90 valarray<T>& operator=(const std::valarray<T> &valarray)
92 m_buffer = buffer(m_buffer.get_context(), valarray.size() * sizeof(T));
93 copy(&valarray[0], &valarray[valarray.size()], begin());
98 valarray<T>& operator*=(const T&);
100 valarray<T>& operator/=(const T&);
102 valarray<T>& operator%=(const T& val);
104 valarray<T> operator+() const
106 // This operator can be used with any type.
107 valarray<T> result(size());
108 copy(begin(), end(), result.begin());
112 valarray<T> operator-() const
114 BOOST_STATIC_ASSERT_MSG(
115 is_fundamental<T>::value,
116 "This operator can be used with all OpenCL built-in scalar"
119 valarray<T> result(size());
120 BOOST_COMPUTE_FUNCTION(T, unary_minus, (T x),
124 transform(begin(), end(), result.begin(), unary_minus);
128 valarray<T> operator~() const
130 BOOST_STATIC_ASSERT_MSG(
131 is_fundamental<T>::value &&
132 !is_floating_point<typename scalar_type<T>::type>::value,
133 "This operator can be used with all OpenCL built-in scalar"
134 " and vector types except the built-in scalar and vector float types"
136 valarray<T> result(size());
137 BOOST_COMPUTE_FUNCTION(T, bitwise_not, (T x),
141 transform(begin(), end(), result.begin(), bitwise_not);
145 /// In OpenCL there cannot be memory buffer with bool type, for
146 /// this reason return type is valarray<char> instead of valarray<bool>.
147 /// 1 means true, 0 means false.
148 valarray<char> operator!() const
150 BOOST_STATIC_ASSERT_MSG(
151 is_fundamental<T>::value,
152 "This operator can be used with all OpenCL built-in scalar"
155 valarray<char> result(size());
156 BOOST_COMPUTE_FUNCTION(char, logical_not, (T x),
160 transform(begin(), end(), &result[0], logical_not);
164 valarray<T>& operator+=(const T&);
166 valarray<T>& operator-=(const T&);
168 valarray<T>& operator^=(const T&);
170 valarray<T>& operator&=(const T&);
172 valarray<T>& operator|=(const T&);
174 valarray<T>& operator<<=(const T&);
176 valarray<T>& operator>>=(const T&);
178 valarray<T>& operator*=(const valarray<T>&);
180 valarray<T>& operator/=(const valarray<T>&);
182 valarray<T>& operator%=(const valarray<T>&);
184 valarray<T>& operator+=(const valarray<T>&);
186 valarray<T>& operator-=(const valarray<T>&);
188 valarray<T>& operator^=(const valarray<T>&);
190 valarray<T>& operator&=(const valarray<T>&);
192 valarray<T>& operator|=(const valarray<T>&);
194 valarray<T>& operator<<=(const valarray<T>&);
196 valarray<T>& operator>>=(const valarray<T>&);
205 return m_buffer.size() / sizeof(T);
208 void resize(size_t size, T value = T())
210 m_buffer = buffer(m_buffer.get_context(), size * sizeof(T));
211 fill(begin(), end(), value);
214 detail::buffer_value<T> operator[](size_t index)
216 return *(begin() + static_cast<ptrdiff_t>(index));
219 const detail::buffer_value<T> operator[](size_t index) const
221 return *(begin() + static_cast<ptrdiff_t>(index));
226 return *(boost::compute::min_element(begin(), end()));
231 return *(boost::compute::max_element(begin(), end()));
236 return boost::compute::accumulate(begin(), end(), T(0));
239 template<class UnaryFunction>
240 valarray<T> apply(UnaryFunction function) const
242 valarray<T> result(size());
243 transform(begin(), end(), result.begin(), function);
247 const buffer& get_buffer() const
254 buffer_iterator<T> begin() const
256 return buffer_iterator<T>(m_buffer, 0);
259 buffer_iterator<T> end() const
261 return buffer_iterator<T>(m_buffer, size());
269 #define BOOST_COMPUTE_DEFINE_VALARRAY_COMPOUND_ASSIGNMENT(op, op_name, assert) \
271 inline valarray<T>& \
272 valarray<T>::operator op##=(const T& val) \
275 transform(begin(), end(), begin(), \
276 ::boost::compute::bind(op_name<T>(), placeholders::_1, val)); \
281 inline valarray<T>& \
282 valarray<T>::operator op##=(const valarray<T> &rhs) \
285 transform(begin(), end(), rhs.begin(), begin(), op_name<T>()); \
290 #define BOOST_COMPUTE_DEFINE_VALARRAY_COMPOUND_ASSIGNMENT_ANY(op, op_name) \
291 BOOST_COMPUTE_DEFINE_VALARRAY_COMPOUND_ASSIGNMENT(op, op_name, \
292 BOOST_STATIC_ASSERT_MSG( \
293 is_fundamental<T>::value, \
294 "This operator can be used with all OpenCL built-in scalar" \
295 " and vector types" \
300 /// For some operators class T can't be floating point type.
301 /// See OpenCL specification, operators chapter.
302 #define BOOST_COMPUTE_DEFINE_VALARRAY_COMPOUND_ASSIGNMENT_NO_FP(op, op_name) \
303 BOOST_COMPUTE_DEFINE_VALARRAY_COMPOUND_ASSIGNMENT(op, op_name, \
304 BOOST_STATIC_ASSERT_MSG( \
305 is_fundamental<T>::value && \
306 !is_floating_point<typename scalar_type<T>::type>::value, \
307 "This operator can be used with all OpenCL built-in scalar" \
308 " and vector types except the built-in scalar and vector float types" \
312 // defining operators
313 BOOST_COMPUTE_DEFINE_VALARRAY_COMPOUND_ASSIGNMENT_ANY(+, plus)
314 BOOST_COMPUTE_DEFINE_VALARRAY_COMPOUND_ASSIGNMENT_ANY(-, minus)
315 BOOST_COMPUTE_DEFINE_VALARRAY_COMPOUND_ASSIGNMENT_ANY(*, multiplies)
316 BOOST_COMPUTE_DEFINE_VALARRAY_COMPOUND_ASSIGNMENT_ANY(/, divides)
317 BOOST_COMPUTE_DEFINE_VALARRAY_COMPOUND_ASSIGNMENT_NO_FP(^, bit_xor)
318 BOOST_COMPUTE_DEFINE_VALARRAY_COMPOUND_ASSIGNMENT_NO_FP(&, bit_and)
319 BOOST_COMPUTE_DEFINE_VALARRAY_COMPOUND_ASSIGNMENT_NO_FP(|, bit_or)
320 BOOST_COMPUTE_DEFINE_VALARRAY_COMPOUND_ASSIGNMENT_NO_FP(<<, shift_left)
321 BOOST_COMPUTE_DEFINE_VALARRAY_COMPOUND_ASSIGNMENT_NO_FP(>>, shift_right)
323 // The remainder (%) operates on
324 // integer scalar and integer vector data types only.
325 // See OpenCL specification.
326 BOOST_COMPUTE_DEFINE_VALARRAY_COMPOUND_ASSIGNMENT(%, modulus,
327 BOOST_STATIC_ASSERT_MSG(
328 is_integral<typename scalar_type<T>::type>::value,
329 "This operator can be used only with OpenCL built-in integer types"
333 #undef BOOST_COMPUTE_DEFINE_VALARRAY_COMPOUND_ASSIGNMENT_ANY
334 #undef BOOST_COMPUTE_DEFINE_VALARRAY_COMPOUND_ASSIGNMENT_NO_FP
336 #undef BOOST_COMPUTE_DEFINE_VALARRAY_COMPOUND_ASSIGNMENT
339 /// Macro for defining binary operators for valarray
340 #define BOOST_COMPUTE_DEFINE_VALARRAY_BINARY_OPERATOR(op, op_name, assert) \
342 valarray<T> operator op (const valarray<T>& lhs, const valarray<T>& rhs) \
345 valarray<T> result(lhs.size()); \
346 transform(buffer_iterator<T>(lhs.get_buffer(), 0), \
347 buffer_iterator<T>(lhs.get_buffer(), lhs.size()), \
348 buffer_iterator<T>(rhs.get_buffer(), 0), \
349 buffer_iterator<T>(result.get_buffer(), 0), \
355 valarray<T> operator op (const T& val, const valarray<T>& rhs) \
358 valarray<T> result(rhs.size()); \
359 transform(buffer_iterator<T>(rhs.get_buffer(), 0), \
360 buffer_iterator<T>(rhs.get_buffer(), rhs.size()), \
361 buffer_iterator<T>(result.get_buffer(), 0), \
362 ::boost::compute::bind(op_name<T>(), val, placeholders::_1)); \
367 valarray<T> operator op (const valarray<T>& lhs, const T& val) \
370 valarray<T> result(lhs.size()); \
371 transform(buffer_iterator<T>(lhs.get_buffer(), 0), \
372 buffer_iterator<T>(lhs.get_buffer(), lhs.size()), \
373 buffer_iterator<T>(result.get_buffer(), 0), \
374 ::boost::compute::bind(op_name<T>(), placeholders::_1, val)); \
379 #define BOOST_COMPUTE_DEFINE_VALARRAY_BINARY_OPERATOR_ANY(op, op_name) \
380 BOOST_COMPUTE_DEFINE_VALARRAY_BINARY_OPERATOR(op, op_name, \
381 BOOST_STATIC_ASSERT_MSG( \
382 is_fundamental<T>::value, \
383 "This operator can be used with all OpenCL built-in scalar" \
384 " and vector types" \
389 /// For some operators class T can't be floating point type.
390 /// See OpenCL specification, operators chapter.
391 #define BOOST_COMPUTE_DEFINE_VALARRAY_BINARY_OPERATOR_NO_FP(op, op_name) \
392 BOOST_COMPUTE_DEFINE_VALARRAY_BINARY_OPERATOR(op, op_name, \
393 BOOST_STATIC_ASSERT_MSG( \
394 is_fundamental<T>::value && \
395 !is_floating_point<typename scalar_type<T>::type>::value, \
396 "This operator can be used with all OpenCL built-in scalar" \
397 " and vector types except the built-in scalar and vector float types" \
401 // defining binary operators for valarray
402 BOOST_COMPUTE_DEFINE_VALARRAY_BINARY_OPERATOR_ANY(+, plus)
403 BOOST_COMPUTE_DEFINE_VALARRAY_BINARY_OPERATOR_ANY(-, minus)
404 BOOST_COMPUTE_DEFINE_VALARRAY_BINARY_OPERATOR_ANY(*, multiplies)
405 BOOST_COMPUTE_DEFINE_VALARRAY_BINARY_OPERATOR_ANY(/, divides)
406 BOOST_COMPUTE_DEFINE_VALARRAY_BINARY_OPERATOR_NO_FP(^, bit_xor)
407 BOOST_COMPUTE_DEFINE_VALARRAY_BINARY_OPERATOR_NO_FP(&, bit_and)
408 BOOST_COMPUTE_DEFINE_VALARRAY_BINARY_OPERATOR_NO_FP(|, bit_or)
409 BOOST_COMPUTE_DEFINE_VALARRAY_BINARY_OPERATOR_NO_FP(<<, shift_left)
410 BOOST_COMPUTE_DEFINE_VALARRAY_BINARY_OPERATOR_NO_FP(>>, shift_right)
412 #undef BOOST_COMPUTE_DEFINE_VALARRAY_BINARY_OPERATOR_ANY
413 #undef BOOST_COMPUTE_DEFINE_VALARRAY_BINARY_OPERATOR_NO_FP
415 #undef BOOST_COMPUTE_DEFINE_VALARRAY_BINARY_OPERATOR
418 /// Macro for defining valarray comparison operators.
419 /// For return type valarray<char> is used instead of valarray<bool> because
420 /// in OpenCL there cannot be memory buffer with bool type.
422 /// Note it's also used for defining binary logical operators (==, &&)
423 #define BOOST_COMPUTE_DEFINE_VALARRAY_COMPARISON_OPERATOR(op, op_name) \
425 valarray<char> operator op (const valarray<T>& lhs, const valarray<T>& rhs) \
427 BOOST_STATIC_ASSERT_MSG( \
428 is_fundamental<T>::value, \
429 "This operator can be used with all OpenCL built-in scalar" \
430 " and vector types" \
432 valarray<char> result(lhs.size()); \
433 transform(buffer_iterator<T>(lhs.get_buffer(), 0), \
434 buffer_iterator<T>(lhs.get_buffer(), lhs.size()), \
435 buffer_iterator<T>(rhs.get_buffer(), 0), \
436 buffer_iterator<char>(result.get_buffer(), 0), \
442 valarray<char> operator op (const T& val, const valarray<T>& rhs) \
444 BOOST_STATIC_ASSERT_MSG( \
445 is_fundamental<T>::value, \
446 "This operator can be used with all OpenCL built-in scalar" \
447 " and vector types" \
449 valarray<char> result(rhs.size()); \
450 transform(buffer_iterator<T>(rhs.get_buffer(), 0), \
451 buffer_iterator<T>(rhs.get_buffer(), rhs.size()), \
452 buffer_iterator<char>(result.get_buffer(), 0), \
453 ::boost::compute::bind(op_name<T>(), val, placeholders::_1)); \
458 valarray<char> operator op (const valarray<T>& lhs, const T& val) \
460 BOOST_STATIC_ASSERT_MSG( \
461 is_fundamental<T>::value, \
462 "This operator can be used with all OpenCL built-in scalar" \
463 " and vector types" \
465 valarray<char> result(lhs.size()); \
466 transform(buffer_iterator<T>(lhs.get_buffer(), 0), \
467 buffer_iterator<T>(lhs.get_buffer(), lhs.size()), \
468 buffer_iterator<char>(result.get_buffer(), 0), \
469 ::boost::compute::bind(op_name<T>(), placeholders::_1, val)); \
473 BOOST_COMPUTE_DEFINE_VALARRAY_COMPARISON_OPERATOR(==, equal_to)
474 BOOST_COMPUTE_DEFINE_VALARRAY_COMPARISON_OPERATOR(!=, not_equal_to)
475 BOOST_COMPUTE_DEFINE_VALARRAY_COMPARISON_OPERATOR(>, greater)
476 BOOST_COMPUTE_DEFINE_VALARRAY_COMPARISON_OPERATOR(<, less)
477 BOOST_COMPUTE_DEFINE_VALARRAY_COMPARISON_OPERATOR(>=, greater_equal)
478 BOOST_COMPUTE_DEFINE_VALARRAY_COMPARISON_OPERATOR(<=, less_equal)
481 /// Macro for defining binary logical operators for valarray.
483 /// For return type valarray<char> is used instead of valarray<bool> because
484 /// in OpenCL there cannot be memory buffer with bool type.
485 /// 1 means true, 0 means false.
486 #define BOOST_COMPUTE_DEFINE_VALARRAY_LOGICAL_OPERATOR(op, op_name) \
487 BOOST_COMPUTE_DEFINE_VALARRAY_COMPARISON_OPERATOR(op, op_name)
489 BOOST_COMPUTE_DEFINE_VALARRAY_LOGICAL_OPERATOR(&&, logical_and)
490 BOOST_COMPUTE_DEFINE_VALARRAY_LOGICAL_OPERATOR(||, logical_or)
492 #undef BOOST_COMPUTE_DEFINE_VALARRAY_LOGICAL_OPERATOR
494 #undef BOOST_COMPUTE_DEFINE_VALARRAY_COMPARISON_OPERATOR
496 } // end compute namespace
497 } // end boost namespace
499 #endif // BOOST_COMPUTE_CONTAINER_VALARRAY_HPP