TRIQS/nda 1.3.0
Multi-dimensional array library for C++
Loading...
Searching...
No Matches
traits.hpp
Go to the documentation of this file.
1// Copyright (c) 2019--present, The Simons Foundation
2// This file is part of TRIQS/nda and is licensed under the Apache License, Version 2.0.
3// SPDX-License-Identifier: Apache-2.0
4// See LICENSE in the root of this distribution for details.
5
10
11#pragma once
12
13#include <complex>
14#include <cstdint>
15#include <ranges>
16#include <type_traits>
17#include <utility>
18#include <tuple>
19
20namespace nda {
21
26
40 template <template <typename...> class TMPLT, typename T>
41 struct is_instantiation_of : std::false_type {};
42
43 // Specialization of nda::is_instantiation_of for when it evaluates to true.
44 template <template <typename...> class TMPLT, typename... U>
45 struct is_instantiation_of<TMPLT, TMPLT<U...>> : std::true_type {};
46
48 template <template <typename...> class TMPLT, typename T>
50
52 template <typename T, typename... Ts>
53 static constexpr bool is_any_of = (std::is_same_v<Ts, T> or ... or false);
54
56 template <typename... Ts>
57 static constexpr bool always_true = true;
58
60 template <typename... Ts>
61 static constexpr bool always_false = false;
62
64 template <typename T>
66
68 template <typename S>
69 inline constexpr bool is_scalar_v = std::is_arithmetic_v<std::remove_cvref_t<S>> or is_complex_v<S>;
70
75 template <typename S>
76 inline constexpr bool is_scalar_or_convertible_v = is_scalar_v<S> or std::is_constructible_v<std::complex<double>, S>;
77
82 template <typename S, typename A>
83 inline constexpr bool is_scalar_for_v =
84 (is_scalar_v<typename A::value_type> ? is_scalar_or_convertible_v<S> : std::is_same_v<S, typename A::value_type>);
85
87 template <typename T>
88 inline constexpr bool is_double_or_complex_v = is_complex_v<T> or std::is_same_v<double, std::remove_cvref_t<T>>;
89
91 template <typename T>
93
95
100
115 template <typename A>
116 inline constexpr char get_algebra = 'N';
117
118 // Specialization of nda::get_algebra for cvref types.
119 template <typename A>
120 requires(!std::is_same_v<A, std::remove_cvref_t<A>>)
121 inline constexpr char get_algebra<A> = get_algebra<std::remove_cvref_t<A>>;
122
124 template <typename A>
125 requires(std::ranges::contiguous_range<A> or requires { std::declval<A const>().shape(); })
126 constexpr int get_rank = []() {
127 if constexpr (std::ranges::contiguous_range<A>)
128 return 1;
129 else
130 return std::tuple_size_v<std::remove_cvref_t<decltype(std::declval<A const>().shape())>>;
131 }();
132
134 template <typename A>
135 inline constexpr bool is_regular_v = false;
136
137 // Specialization of nda::is_regular_v for cvref types.
138 template <typename A>
139 requires(!std::is_same_v<A, std::remove_cvref_t<A>>)
140 inline constexpr bool is_regular_v<A> = is_regular_v<std::remove_cvref_t<A>>;
141
143 template <typename A>
144 inline constexpr bool is_view_v = false;
145
146 // Specialization of nda::is_view_v for cvref types.
147 template <typename A>
148 requires(!std::is_same_v<A, std::remove_cvref_t<A>>)
149 inline constexpr bool is_view_v<A> = is_view_v<std::remove_cvref_t<A>>;
150
152 template <typename A>
154
156 template <typename A>
157 inline constexpr bool is_matrix_or_view_v = is_regular_or_view_v<A> and (get_algebra<A> == 'M') and (get_rank<A> == 2);
158
166 template <typename A>
167 decltype(auto) get_first_element(A const &a) {
168 if constexpr (is_scalar_v<A>) {
169 return a;
170 } else {
171 return [&a]<auto... Is>(std::index_sequence<Is...>) -> decltype(auto) {
172 return a((0 * Is)...); // repeat 0 sizeof...(Is) times
173 }(std::make_index_sequence<get_rank<A>>{});
174 }
175 }
176
181 template <typename A>
182 using get_value_t = std::decay_t<decltype(get_first_element(std::declval<A const>()))>;
183
185 template <typename A0, typename... As>
186 inline constexpr bool have_same_value_type_v = (std::is_same_v<get_value_t<A0>, get_value_t<As>> and ... and true);
187
189 template <typename A0, typename... As>
190 inline constexpr bool have_same_rank_v = ((get_rank<A0> == get_rank<As>) and ... and true);
191
193
198
212 enum class layout_prop_e : uint64_t {
213 none = 0x0,
214 strided_1d = 0x1,
215 smallest_stride_is_one = 0x2,
216 contiguous = strided_1d | smallest_stride_is_one
217 };
218
228 if (from == layout_prop_e::contiguous) return true;
229 return ((to == layout_prop_e::none) or (to == from));
230 }
231
239 constexpr layout_prop_e operator|(layout_prop_e lhs, layout_prop_e rhs) { return layout_prop_e(uint64_t(lhs) | uint64_t(rhs)); }
240
248 constexpr layout_prop_e operator&(layout_prop_e lhs, layout_prop_e rhs) { return layout_prop_e{uint64_t(lhs) & uint64_t(rhs)}; }
249
256 inline constexpr bool has_strided_1d(layout_prop_e lp) { return uint64_t(lp) & uint64_t(layout_prop_e::strided_1d); }
257
264 inline constexpr bool has_smallest_stride_is_one(layout_prop_e lp) { return uint64_t(lp) & uint64_t(layout_prop_e::smallest_stride_is_one); }
265
272 inline constexpr bool has_contiguous(layout_prop_e lp) { return has_strided_1d(lp) and has_smallest_stride_is_one(lp); }
273
274 // FIXME : I need a NONE for stride_order. For the scalars ...
287 uint64_t stride_order = 0;
288
290 layout_prop_e prop = layout_prop_e::none;
291 };
292
303 if (lhs.stride_order == rhs.stride_order)
304 return layout_info_t{lhs.stride_order, layout_prop_e(uint64_t(lhs.prop) & uint64_t(rhs.prop))};
305 else
306 return layout_info_t{uint64_t(-1), layout_prop_e::none};
307 }
308
310 template <typename A>
312
313 // Specialization of nda::get_layout_info for cvref types.
314 template <typename A>
315 requires(!std::is_same_v<A, std::remove_cvref_t<A>>)
316 inline constexpr layout_info_t get_layout_info<A> = get_layout_info<std::remove_cvref_t<A>>;
317
319 template <typename A>
321
323 template <typename A>
325
327 template <typename A>
329
335 long value;
336 };
337
339
340} // namespace nda
constexpr bool is_regular_v
Constexpr variable that is true if type A is a regular array, i.e. an nda::basic_array.
Definition traits.hpp:135
constexpr char get_algebra
Constexpr variable that specifies the algebra of a type.
Definition traits.hpp:116
constexpr bool is_matrix_or_view_v
Constexpr variable that is true if type A is a regular matrix or a view of a matrix.
Definition traits.hpp:157
constexpr bool have_same_value_type_v
Constexpr variable that is true if all types in As have the same value type as A0.
Definition traits.hpp:186
constexpr int get_rank
Constexpr variable that specifies the rank of an nda::Array or of a contiguous 1-dimensional range.
Definition traits.hpp:126
std::decay_t< decltype(get_first_element(std::declval< A const >()))> get_value_t
Get the value type of an array/view or a scalar type.
Definition traits.hpp:182
constexpr bool have_same_rank_v
Constexpr variable that is true if all types in As have the same rank as A0.
Definition traits.hpp:190
constexpr bool is_view_v
Constexpr variable that is true if type A is a view, i.e. an nda::basic_array_view.
Definition traits.hpp:144
constexpr bool is_regular_or_view_v
Constexpr variable that is true if type A is either a regular array or a view.
Definition traits.hpp:153
decltype(auto) get_first_element(A const &a)
Get the first element of an array/view or simply return the scalar if a scalar is given.
Definition traits.hpp:167
constexpr bool layout_property_compatible(layout_prop_e from, layout_prop_e to)
Checks if two layout properties are compatible with each other.
Definition traits.hpp:227
constexpr bool has_contiguous(layout_prop_e lp)
Checks if a layout property has the contiguous property.
Definition traits.hpp:272
constexpr bool has_layout_smallest_stride_is_one
Constexpr variable that is true if type A has the smallest_stride_is_one nda::layout_prop_e guarantee...
Definition traits.hpp:328
constexpr bool has_strided_1d(layout_prop_e lp)
Checks if a layout property has the strided_1d property.
Definition traits.hpp:256
constexpr bool has_layout_strided_1d
Constexpr variable that is true if type A has the strided_1d nda::layout_prop_e guarantee.
Definition traits.hpp:324
constexpr layout_prop_e operator&(layout_prop_e lhs, layout_prop_e rhs)
Bitwise AND operator for two layout properties.
Definition traits.hpp:248
constexpr layout_prop_e operator|(layout_prop_e lhs, layout_prop_e rhs)
Bitwise OR operator for two layout properties.
Definition traits.hpp:239
constexpr layout_info_t get_layout_info
Constexpr variable that specifies the nda::layout_info_t of type A.
Definition traits.hpp:311
constexpr bool has_smallest_stride_is_one(layout_prop_e lp)
Checks if a layout property has the smallest_stride_is_one property.
Definition traits.hpp:264
constexpr bool has_contiguous_layout
Constexpr variable that is true if type A has the contiguous nda::layout_prop_e guarantee.
Definition traits.hpp:320
layout_prop_e
Compile-time guarantees of the memory layout of an array/view.
Definition traits.hpp:212
constexpr bool is_instantiation_of_v
Constexpr variable that is true if type T is an instantiation of TMPLT (see nda::is_instantiation_of)...
Definition traits.hpp:49
constexpr bool is_complex_v
Constexpr variable that is true if type T is a std::complex type.
Definition traits.hpp:65
constexpr bool is_blas_lapack_v
Alias for nda::is_double_or_complex_v.
Definition traits.hpp:92
static constexpr bool always_false
Constexpr variable that is always false regardless of the types in Ts (used to trigger static_assert)...
Definition traits.hpp:61
constexpr bool is_scalar_for_v
Constexpr variable used to check requirements when initializing an nda::basic_array or nda::basic_arr...
Definition traits.hpp:83
static constexpr bool is_any_of
Constexpr variable that is true if type T is contained in the parameter pack Ts.
Definition traits.hpp:53
constexpr bool is_double_or_complex_v
Constexpr variable that is true if type T is a std::complex type or a double type.
Definition traits.hpp:88
static constexpr bool always_true
Constexpr variable that is always true regardless of the types in Ts.
Definition traits.hpp:57
constexpr bool is_scalar_v
Constexpr variable that is true if type S is a scalar type, i.e. arithmetic or complex.
Definition traits.hpp:69
constexpr bool is_scalar_or_convertible_v
Constexpr variable that is true if type S is a scalar type (see nda::is_scalar_v) or if a std::comple...
Definition traits.hpp:76
A small wrapper around a single long integer to be used as a linear index.
Definition traits.hpp:333
long value
Linear index.
Definition traits.hpp:335
Check if type T is of type TMPLT<...>.
Definition traits.hpp:41
Stores information about the memory layout and the stride order of an array/view.
Definition traits.hpp:285
uint64_t stride_order
Stride order of the array/view.
Definition traits.hpp:287
layout_prop_e prop
Memory layout properties of the array/view.
Definition traits.hpp:290