Transpose.h
Go to the documentation of this file.
1 // This file is part of Eigen, a lightweight C++ template library
2 // for linear algebra.
3 //
4 // Copyright (C) 2006-2008 Benoit Jacob <jacob.benoit.1@gmail.com>
5 // Copyright (C) 2009-2014 Gael Guennebaud <gael.guennebaud@inria.fr>
6 //
7 // This Source Code Form is subject to the terms of the Mozilla
8 // Public License v. 2.0. If a copy of the MPL was not distributed
9 // with this file, You can obtain one at http://mozilla.org/MPL/2.0/.
10 
11 #ifndef EIGEN_TRANSPOSE_H
12 #define EIGEN_TRANSPOSE_H
13 
14 namespace Eigen {
15 
16 namespace internal {
17 template<typename MatrixType>
18 struct traits<Transpose<MatrixType> > : public traits<MatrixType>
19 {
22  enum {
23  RowsAtCompileTime = MatrixType::ColsAtCompileTime,
24  ColsAtCompileTime = MatrixType::RowsAtCompileTime,
25  MaxRowsAtCompileTime = MatrixType::MaxColsAtCompileTime,
26  MaxColsAtCompileTime = MatrixType::MaxRowsAtCompileTime,
27  FlagsLvalueBit = is_lvalue<MatrixType>::value ? LvalueBit : 0,
29  Flags1 = Flags0 | FlagsLvalueBit,
30  Flags = Flags1 ^ RowMajorBit,
33  };
34 };
35 }
36 
37 template<typename MatrixType, typename StorageKind> class TransposeImpl;
38 
52 template<typename MatrixType> class Transpose
53  : public TransposeImpl<MatrixType,typename internal::traits<MatrixType>::StorageKind>
54 {
55  public:
56 
58 
61  typedef typename internal::remove_all<MatrixType>::type NestedExpression;
62 
63  EIGEN_DEVICE_FUNC
64  explicit inline Transpose(MatrixType& matrix) : m_matrix(matrix) {}
65 
67 
68  EIGEN_DEVICE_FUNC inline Index rows() const { return m_matrix.cols(); }
69  EIGEN_DEVICE_FUNC inline Index cols() const { return m_matrix.rows(); }
70 
72  EIGEN_DEVICE_FUNC
74  nestedExpression() const { return m_matrix; }
75 
77  EIGEN_DEVICE_FUNC
79  nestedExpression() { return m_matrix; }
80 
82  void resize(Index nrows, Index ncols) {
83  m_matrix.resize(ncols,nrows);
84  }
85 
86  protected:
88 };
89 
90 namespace internal {
91 
94 {
96 };
97 
98 template<typename MatrixType>
100 {
102 };
103 
104 } // end namespace internal
105 
106 // Generic API dispatcher
107 template<typename XprType, typename StorageKind>
108 class TransposeImpl
109  : public internal::generic_xpr_base<Transpose<XprType> >::type
110 {
111 public:
113 };
114 
115 template<typename MatrixType> class TransposeImpl<MatrixType,Dense>
116  : public internal::TransposeImpl_base<MatrixType>::type
117 {
118  public:
119 
121  using Base::coeffRef;
124 
125  EIGEN_DEVICE_FUNC inline Index innerStride() const { return derived().nestedExpression().innerStride(); }
126  EIGEN_DEVICE_FUNC inline Index outerStride() const { return derived().nestedExpression().outerStride(); }
127 
128  typedef typename internal::conditional<
130  Scalar,
131  const Scalar
133 
134  EIGEN_DEVICE_FUNC inline ScalarWithConstIfNotLvalue* data() { return derived().nestedExpression().data(); }
135  EIGEN_DEVICE_FUNC inline const Scalar* data() const { return derived().nestedExpression().data(); }
136 
137  // FIXME: shall we keep the const version of coeffRef?
138  EIGEN_DEVICE_FUNC
139  inline const Scalar& coeffRef(Index rowId, Index colId) const
140  {
141  return derived().nestedExpression().coeffRef(colId, rowId);
142  }
143 
144  EIGEN_DEVICE_FUNC
145  inline const Scalar& coeffRef(Index index) const
146  {
147  return derived().nestedExpression().coeffRef(index);
148  }
149 };
150 
170 template<typename Derived>
171 inline Transpose<Derived>
173 {
174  return TransposeReturnType(derived());
175 }
176 
182 template<typename Derived>
185 {
186  return ConstTransposeReturnType(derived());
187 }
188 
208 template<typename Derived>
209 inline const typename MatrixBase<Derived>::AdjointReturnType
211 {
212  return AdjointReturnType(this->transpose());
213 }
214 
215 /***************************************************************************
216 * "in place" transpose implementation
217 ***************************************************************************/
218 
219 namespace internal {
220 
221 template<typename MatrixType,
222  bool IsSquare = (MatrixType::RowsAtCompileTime == MatrixType::ColsAtCompileTime) && MatrixType::RowsAtCompileTime!=Dynamic,
223  bool MatchPacketSize =
224  (int(MatrixType::RowsAtCompileTime) == int(internal::packet_traits<typename MatrixType::Scalar>::size))
227 
228 template<typename MatrixType>
229 struct inplace_transpose_selector<MatrixType,true,false> { // square matrix
230  static void run(MatrixType& m) {
231  m.matrix().template triangularView<StrictlyUpper>().swap(m.matrix().transpose());
232  }
233 };
234 
235 // TODO: vectorized path is currently limited to LargestPacketSize x LargestPacketSize cases only.
236 template<typename MatrixType>
237 struct inplace_transpose_selector<MatrixType,true,true> { // PacketSize x PacketSize
238  static void run(MatrixType& m) {
239  typedef typename MatrixType::Scalar Scalar;
241  const Index PacketSize = internal::packet_traits<Scalar>::size;
244  for (Index i=0; i<PacketSize; ++i)
245  A.packet[i] = m.template packetByOuterInner<Alignment>(i,0);
247  for (Index i=0; i<PacketSize; ++i)
248  m.template writePacket<Alignment>(m.rowIndexByOuterInner(i,0), m.colIndexByOuterInner(i,0), A.packet[i]);
249  }
250 };
251 
252 template<typename MatrixType,bool MatchPacketSize>
253 struct inplace_transpose_selector<MatrixType,false,MatchPacketSize> { // non square matrix
254  static void run(MatrixType& m) {
255  if (m.rows()==m.cols())
256  m.matrix().template triangularView<StrictlyUpper>().swap(m.matrix().transpose());
257  else
258  m = m.transpose().eval();
259  }
260 };
261 
262 } // end namespace internal
263 
283 template<typename Derived>
285 {
286  eigen_assert((rows() == cols() || (RowsAtCompileTime == Dynamic && ColsAtCompileTime == Dynamic))
287  && "transposeInPlace() called on a non-square non-resizable matrix");
289 }
290 
291 /***************************************************************************
292 * "in place" adjoint implementation
293 ***************************************************************************/
294 
314 template<typename Derived>
316 {
317  derived() = adjoint().eval();
318 }
319 
320 #ifndef EIGEN_NO_DEBUG
321 
322 // The following is to detect aliasing problems in most common cases.
323 
324 namespace internal {
325 
326 template<bool DestIsTransposed, typename OtherDerived>
328 {
329  enum { ret = bool(blas_traits<OtherDerived>::IsTransposed) != DestIsTransposed };
330 };
331 
332 template<bool DestIsTransposed, typename BinOp, typename DerivedA, typename DerivedB>
333 struct check_transpose_aliasing_compile_time_selector<DestIsTransposed,CwiseBinaryOp<BinOp,DerivedA,DerivedB> >
334 {
335  enum { ret = bool(blas_traits<DerivedA>::IsTransposed) != DestIsTransposed
336  || bool(blas_traits<DerivedB>::IsTransposed) != DestIsTransposed
337  };
338 };
339 
340 template<typename Scalar, bool DestIsTransposed, typename OtherDerived>
342 {
343  static bool run(const Scalar* dest, const OtherDerived& src)
344  {
345  return (bool(blas_traits<OtherDerived>::IsTransposed) != DestIsTransposed) && (dest!=0 && dest==(const Scalar*)extract_data(src));
346  }
347 };
348 
349 template<typename Scalar, bool DestIsTransposed, typename BinOp, typename DerivedA, typename DerivedB>
350 struct check_transpose_aliasing_run_time_selector<Scalar,DestIsTransposed,CwiseBinaryOp<BinOp,DerivedA,DerivedB> >
351 {
352  static bool run(const Scalar* dest, const CwiseBinaryOp<BinOp,DerivedA,DerivedB>& src)
353  {
354  return ((blas_traits<DerivedA>::IsTransposed != DestIsTransposed) && (dest!=0 && dest==(const Scalar*)extract_data(src.lhs())))
355  || ((blas_traits<DerivedB>::IsTransposed != DestIsTransposed) && (dest!=0 && dest==(const Scalar*)extract_data(src.rhs())));
356  }
357 };
358 
359 // the following selector, checkTransposeAliasing_impl, based on MightHaveTransposeAliasing,
360 // is because when the condition controlling the assert is known at compile time, ICC emits a warning.
361 // This is actually a good warning: in expressions that don't have any transposing, the condition is
362 // known at compile time to be false, and using that, we can avoid generating the code of the assert again
363 // and again for all these expressions that don't need it.
364 
365 template<typename Derived, typename OtherDerived,
366  bool MightHaveTransposeAliasing
369  >
371 {
372  static void run(const Derived& dst, const OtherDerived& other)
373  {
375  <typename Derived::Scalar,blas_traits<Derived>::IsTransposed,OtherDerived>
376  ::run(extract_data(dst), other))
377  && "aliasing detected during transposition, use transposeInPlace() "
378  "or evaluate the rhs into a temporary using .eval()");
379 
380  }
381 };
382 
383 template<typename Derived, typename OtherDerived>
384 struct checkTransposeAliasing_impl<Derived, OtherDerived, false>
385 {
386  static void run(const Derived&, const OtherDerived&)
387  {
388  }
389 };
390 
391 template<typename Dst, typename Src>
392 void check_for_aliasing(const Dst &dst, const Src &src)
393 {
395 }
396 
397 } // end namespace internal
398 
399 #endif // EIGEN_NO_DEBUG
400 
401 } // end namespace Eigen
402 
403 #endif // EIGEN_TRANSPOSE_H
Matrix3f m
internal::packet_traits< Scalar >::type Packet
SCALAR Scalar
Definition: bench_gemm.cpp:33
#define EIGEN_GENERIC_PUBLIC_INTERFACE(Derived)
Definition: Macros.h:852
void adjoint(const MatrixType &m)
Definition: adjoint.cpp:67
return int(ret)+1
static bool run(const Scalar *dest, const CwiseBinaryOp< BinOp, DerivedA, DerivedB > &src)
Definition: Transpose.h:352
internal::conditional< internal::is_lvalue< MatrixType >::value, Scalar, const Scalar >::type ScalarWithConstIfNotLvalue
Definition: Transpose.h:132
remove_reference< MatrixTypeNested >::type MatrixTypeNestedPlain
Definition: Transpose.h:21
Expression of the transpose of a matrix.
Definition: Transpose.h:52
void check_for_aliasing(const Dst &dst, const Src &src)
Definition: Transpose.h:392
const unsigned int LvalueBit
Definition: Constants.h:139
internal::ref_selector< MatrixType >::non_const_type MatrixTypeNested
Definition: Transpose.h:57
void resize(Index nrows, Index ncols)
Definition: Transpose.h:82
internal::TransposeImpl_base< MatrixType >::type Base
Definition: Transpose.h:120
Namespace containing all symbols from the Eigen library.
Definition: jet.h:637
MatrixXf MatrixType
const unsigned int RowMajorBit
Definition: Constants.h:61
EIGEN_DEVICE_FUNC const _LhsNested & lhs() const
EIGEN_DEVICE_FUNC TransposeReturnType transpose()
Definition: Transpose.h:172
const unsigned int PacketAccessBit
Definition: Constants.h:89
dense_xpr_base< Transpose< MatrixType > >::type type
Definition: Transpose.h:95
dense_xpr_base< Transpose< MatrixType > >::type type
Definition: Transpose.h:101
Generic expression where a coefficient-wise binary operator is applied to two expressions.
Definition: CwiseBinaryOp.h:77
EIGEN_DEVICE_FUNC const Scalar & coeffRef(Index index) const
Definition: Transpose.h:145
EIGEN_STRONG_INLINE void ptranspose(PacketBlock< Packet2cf, 2 > &kernel)
EIGEN_DEFAULT_DENSE_INDEX_TYPE Index
The Index type as used for the API.
Definition: Meta.h:33
#define eigen_assert(x)
Definition: Macros.h:579
#define EIGEN_INHERIT_ASSIGNMENT_OPERATORS(Derived)
Definition: Macros.h:842
static void run(const Derived &, const OtherDerived &)
Definition: Transpose.h:386
EIGEN_DEVICE_FUNC void adjointInPlace()
Definition: Transpose.h:315
EIGEN_DEVICE_FUNC const internal::remove_all< MatrixTypeNested >::type & nestedExpression() const
Definition: Transpose.h:74
const unsigned int NestByRefBit
Definition: Constants.h:164
EIGEN_DEVICE_FUNC internal::remove_reference< MatrixTypeNested >::type & nestedExpression()
Definition: Transpose.h:79
EIGEN_DEVICE_FUNC const Scalar * data() const
Definition: Transpose.h:135
EIGEN_DEVICE_FUNC ScalarWithConstIfNotLvalue * data()
Definition: Transpose.h:134
DenseIndex ret
Definition: level1_impl.h:59
#define EIGEN_DENSE_PUBLIC_INTERFACE(Derived)
Definition: Macros.h:870
internal::generic_xpr_base< Transpose< XprType > >::type Base
Definition: Transpose.h:112
ref_selector< MatrixType >::type MatrixTypeNested
Definition: Transpose.h:20
Expression of a diagonal/subdiagonal/superdiagonal in a matrix.
Definition: Diagonal.h:63
EIGEN_DEVICE_FUNC Index outerStride() const
Definition: Transpose.h:126
const int Dynamic
Definition: Constants.h:21
const T::Scalar * extract_data(const T &m)
Definition: BlasUtil.h:389
EIGEN_DEVICE_FUNC void transposeInPlace()
Definition: Transpose.h:284
Map< Matrix< T, Dynamic, Dynamic, ColMajor >, 0, OuterStride<> > matrix(T *data, int rows, int cols, int stride)
TransposeImpl< MatrixType, typename internal::traits< MatrixType >::StorageKind >::Base Base
Definition: Transpose.h:59
EIGEN_DEVICE_FUNC const AdjointReturnType adjoint() const
Definition: Transpose.h:210
void run(Expr &expr, Dev &dev)
Definition: TensorSyclRun.h:33
static void run(const Derived &dst, const OtherDerived &other)
Definition: Transpose.h:372
EIGEN_DEVICE_FUNC const _RhsNested & rhs() const
EIGEN_DEVICE_FUNC Index cols() const
Definition: Transpose.h:69
internal::ref_selector< MatrixType >::non_const_type m_matrix
Definition: Transpose.h:87
virtual EIGEN_DEVICE_FUNC const Scalar * data() const
Definition: TensorRef.h:59
static bool run(const Scalar *dest, const OtherDerived &src)
Definition: Transpose.h:343
Definition: pytypes.h:897
void swap(scoped_array< T > &a, scoped_array< T > &b)
Definition: Memory.h:602
EIGEN_DEVICE_FUNC const Scalar & coeffRef(Index rowId, Index colId) const
Definition: Transpose.h:139


gtsam
Author(s):
autogenerated on Sat May 8 2021 02:51:10