Eigen::Reshaped< XprType, Rows, Cols, Order > Class Template Reference

Expression of a fixed-size or dynamic-size reshape. More...

#include <Reshaped.h>

Inheritance diagram for Eigen::Reshaped< XprType, Rows, Cols, Order >:

Public Types
typedef Impl	Base

Public Member Functions
EIGEN_DEVICE_FUNC	Reshaped (XprType &xpr)
EIGEN_DEVICE_FUNC	Reshaped (XprType &xpr, Index reshapeRows, Index reshapeCols)

Private Types
typedef ReshapedImpl< XprType, Rows, Cols, Order, typename internal::traits< XprType >::StorageKind >	Impl

Detailed Description

template<typename XprType, int Rows, int Cols, int Order>
class Eigen::Reshaped< XprType, Rows, Cols, Order >

Expression of a fixed-size or dynamic-size reshape.

Template Parameters

XprType	the type of the expression in which we are taking a reshape
Rows	the number of rows of the reshape we are taking at compile time (optional)
Cols	the number of columns of the reshape we are taking at compile time (optional)
Order	can be ColMajor or RowMajor, default is ColMajor.

This class represents an expression of either a fixed-size or dynamic-size reshape. It is the return type of DenseBase::reshaped(NRowsType,NColsType) and most of the time this is the only way it is used.

However, in C++98, if you want to directly maniputate reshaped expressions, for instance if you want to write a function returning such an expression, you will need to use this class. In C++11, it is advised to use the auto keyword for such use cases.

Here is an example illustrating the dynamic case:

#include <Eigen/Core>
#include <iostream>
using namespace std;
using namespace Eigen;
 
template<typename Derived>
const Reshaped<const Derived>
reshape_helper(const MatrixBase<Derived>& m, int rows, int cols)
{
  return Reshaped<const Derived>(m.derived(), rows, cols);
}
 
int main(int, char**)
{
  MatrixXd m(3, 4);
  m << 1, 4, 7, 10,
       2, 5, 8, 11,
       3, 6, 9, 12;
  cout << m << endl;
  Ref<const MatrixXd> n = reshape_helper(m, 2, 6);
  cout << "Matrix m is:" << endl << m << endl;
  cout << "Matrix n is:" << endl << n << endl;
}

Output:

Here is an example illustrating the fixed-size case:

#include <Eigen/Core>
#include <iostream>
using namespace Eigen;
using namespace std;
 
template<typename Derived>
Eigen::Reshaped<Derived, 4, 2>
reshape_helper(MatrixBase<Derived>& m)
{
  return Eigen::Reshaped<Derived, 4, 2>(m.derived());
}
 
int main(int, char**)
{
  MatrixXd m(2, 4);
  m << 1, 2, 3, 4,
       5, 6, 7, 8;
  MatrixXd n = reshape_helper(m);
  cout << "matrix m is:" << endl << m << endl;
  cout << "matrix n is:" << endl << n << endl;
  return 0;
}

Output:

See also

DenseBase::reshaped(NRowsType,NColsType)

Definition at line 96 of file Reshaped.h.

Member Typedef Documentation

Base

template<typename XprType , int Rows, int Cols, int Order>

typedef Impl Eigen::Reshaped< XprType, Rows, Cols, Order >::Base

Definition at line 102 of file Reshaped.h.

Impl

template<typename XprType , int Rows, int Cols, int Order>

typedef ReshapedImpl<XprType, Rows, Cols, Order, typename internal::traits<XprType>::StorageKind> Eigen::Reshaped< XprType, Rows, Cols, Order >::Impl

private

Definition at line 99 of file Reshaped.h.

Constructor & Destructor Documentation

Reshaped() [1/2]

template<typename XprType , int Rows, int Cols, int Order>

EIGEN_DEVICE_FUNC Eigen::Reshaped< XprType, Rows, Cols, Order >::Reshaped ( XprType &  xpr )

inline

Fixed-size constructor

Definition at line 109 of file Reshaped.h.

Reshaped() [2/2]

template<typename XprType , int Rows, int Cols, int Order>

EIGEN_DEVICE_FUNC Eigen::Reshaped< XprType, Rows, Cols, Order >::Reshaped ( XprType &  xpr, Index  reshapeRows, Index  reshapeCols  )

inline

Dynamic-size constructor

Definition at line 119 of file Reshaped.h.

---

The documentation for this class was generated from the following file:

• Reshaped.h