OpenKalman
SelfAdjointView.hpp
Go to the documentation of this file.
1 /* This file is part of OpenKalman, a header-only C++ library for
2  * Kalman filters and other recursive filters.
3  *
4  * Copyright (c) 2019-2023 Christopher Lee Ogden <ogden@gatech.edu>
5  *
6  * This Source Code Form is subject to the terms of the Mozilla Public
7  * License, v. 2.0. If a copy of the MPL was not distributed with this
8  * file, You can obtain one at https://mozilla.org/MPL/2.0/.
9  */
10 
16 #ifndef OPENKALMAN_EIGEN_SELFADJOINTVIEW_HPP
17 #define OPENKALMAN_EIGEN_SELFADJOINTVIEW_HPP
18 
19 #include <type_traits>
20 
21 
22 namespace OpenKalman
23 {
24  namespace interface
25  {
26  template<typename MatrixType, unsigned int UpLo>
27  struct object_traits<Eigen::SelfAdjointView<MatrixType, UpLo>>
28  {
29  private:
30 
31  using Xpr = Eigen::SelfAdjointView<MatrixType, UpLo>;
32  using IndexType = typename MatrixType::Index;
33 
34  public:
35 
36  using scalar_type = scalar_type_of_t<MatrixType>;
37 
38 
39  template<typename Arg>
40  static constexpr auto count_indices(const Arg& arg) { return OpenKalman::count_indices(arg.nestedExpression()); }
41 
42 
43  template<typename Arg, typename N>
44  static constexpr auto get_pattern_collection(const Arg& arg, N n)
45  {
46  return OpenKalman::get_pattern_collection(arg.nestedExpression(), n);
47  }
48 
49 
50  template<typename Arg>
51  static decltype(auto) nested_object(Arg&& arg)
52  {
53  return std::forward<Arg>(arg).nestedExpression();
54  }
55 
56 
57  template<typename Arg>
58  static constexpr auto get_constant(const Arg& arg)
59  {
60  if constexpr (not values::complex<scalar_type_of_t<MatrixType>>)
61  return constant_value{arg.nestedExpression()};
62  else if constexpr (values::fixed<constant_value<MatrixType>>)
63  {
64  if constexpr (values::not_complex<constant_value<MatrixType>>)
65  return constant_value{arg.nestedExpression()};
66  else return std::monostate{};
67  }
68  else return std::monostate{};
69  }
70 
71 
72  template<typename Arg>
73  static constexpr auto get_constant_diagonal(const Arg& arg)
74  {
75  return constant_diagonal_value {arg.nestedExpression()};
76  }
77 
78 
79  template<applicability b>
80  static constexpr bool one_dimensional = OpenKalman::one_dimensional<MatrixType, b>;
81 
82 
83  template<applicability b>
84  static constexpr bool is_square = square_shaped<MatrixType, b>;
85 
86 
87  template<triangle_type t>
88  static constexpr bool triangle_type_value = diagonal_matrix<MatrixType>;
89 
90 
91  static constexpr bool is_triangular_adapter = false;
92 
93 
94  static constexpr bool is_hermitian =
95  (not values::complex<typename Eigen::internal::traits<MatrixType>::Scalar>) or
96  values::not_complex<constant_value<MatrixType>> or
97  values::not_complex<constant_diagonal_value<MatrixType>>;
98 
99 
100  static constexpr HermitianAdapterType hermitian_adapter_type =
101  (UpLo & Eigen::Upper) != 0 ? HermitianAdapterType::upper : HermitianAdapterType::lower;
102 
103  };
104 
105  }
106 
107 
111 #ifdef __cpp_concepts
112  template<Eigen3::eigen_SelfAdjointView M>
113 #else
114  template<typename M, std::enable_if_t<Eigen3::eigen_SelfAdjointView<M>, int> = 0>
115 #endif
116  HermitianAdapter(M&&) -> HermitianAdapter<nested_object_of_t<M>, hermitian_adapter_type_of_v<M>>;
117 
118 }
119 
120 #endif
A hermitian matrix wrapper.
Definition: HermitianAdapter.hpp:33
constexpr bool one_dimensional
Specifies that a type is one-dimensional in every index.
Definition: one_dimensional.hpp:56
A lower-left triangular matrix.
constexpr bool complex
T is a value that reduces to std::complex or a custom complex type.
Definition: complex.hpp:47
constexpr auto count_indices(const T &)
Get the number of indices necessary to address all the components of an indexible object...
Definition: count_indices.hpp:51
Definition: eigen-comma-initializers.hpp:20
decltype(auto) constexpr get_pattern_collection(T &&t)
Get the coordinates::pattern_collection associated with indexible object T.
Definition: get_pattern_collection.hpp:59
HermitianAdapterType
The type of a hermitian adapter, indicating which triangle of the nested matrix is used...
Definition: enumerations.hpp:79
constexpr bool not_complex
T is a value in which either its type is not complex or its imaginary component is 0...
Definition: not_complex.hpp:48
HermitianAdapter(M &&) -> HermitianAdapter< std::conditional_t< hermitian_adapter< M >, nested_object_of_t< M >, M >, hermitian_adapter< M > ? hermitian_adapter_type_of_v< M > :HermitianAdapterType::lower >
Deduction guide for converting Eigen::SelfAdjointView to HermitianAdapter.
The root namespace for OpenKalman.
Definition: basics.hpp:34
Definition: object_traits.hpp:38
An upper-right triangular matrix.
constexpr auto constant_value(T &&t)
The constant value associated with a constant_object or constant_diagonal_object. ...
Definition: constant_value.hpp:37
constexpr bool fixed
T is a value that is determinable at compile time.
Definition: fixed.hpp:66
decltype(auto) constexpr nested_object(Arg &&arg)
Retrieve a nested object of Arg, if it exists.
Definition: nested_object.hpp:35