Eigen::VectorwiseOp< ExpressionType, Direction > Class Template Reference

Pseudo expression providing broadcasting and partial reduction operations. More...

#include <ForwardDeclarations.h>

Classes
struct	ExtendedType
struct	LpNormReturnType
struct	OppositeExtendedType
struct	ReduxReturnType
struct	ReturnType

Public Types
enum	{ isVertical = (Direction==Vertical) ? 1 : 0, isHorizontal = (Direction==Horizontal) ? 1 : 0 }
enum	{ HNormalized_Size, HNormalized_SizeMinusOne = HNormalized_Size==Dynamic ? Dynamic : HNormalized_Size-1 }
typedef ReturnType< internal::member_all >::Type	AllReturnType
typedef ReturnType< internal::member_any >::Type	AnyReturnType
typedef ReturnType< internal::member_blueNorm, RealScalar >::Type	BlueNormReturnType
typedef internal::subvector_stl_iterator< const ExpressionType, DirectionType(Direction)>	const_iterator
typedef internal::subvector_stl_reverse_iterator< const ExpressionType, DirectionType(Direction)>	const_reverse_iterator
typedef Reverse< const ExpressionType, Direction >	ConstReverseReturnType
typedef PartialReduxExpr< ExpressionType, internal::member_count< Index, Scalar >, Direction >	CountReturnType
typedef ExpressionType::PlainObject	CrossReturnType
typedef internal::ref_selector< ExpressionType >::non_const_type	ExpressionTypeNested
typedef internal::remove_all< ExpressionTypeNested >::type	ExpressionTypeNestedCleaned
typedef Block< const ExpressionType, Direction==Vertical ? int(HNormalized_SizeMinusOne) :int(internal::traits< ExpressionType >::RowsAtCompileTime), Direction==Horizontal ? int(HNormalized_SizeMinusOne) :int(internal::traits< ExpressionType >::ColsAtCompileTime)>	HNormalized_Block
typedef Block< const ExpressionType, Direction==Vertical ? 1 :int(internal::traits< ExpressionType >::RowsAtCompileTime), Direction==Horizontal ? 1 :int(internal::traits< ExpressionType >::ColsAtCompileTime)>	HNormalized_Factors
typedef CwiseBinaryOp< internal::scalar_quotient_op< typename internal::traits< ExpressionType >::Scalar >, const HNormalized_Block, const Replicate< HNormalized_Factors, Direction==Vertical ? HNormalized_SizeMinusOne :1, Direction==Horizontal ? HNormalized_SizeMinusOne :1 > >	HNormalizedReturnType
typedef Homogeneous< ExpressionType, Direction >	HomogeneousReturnType
typedef ReturnType< internal::member_hypotNorm, RealScalar >::Type	HypotNormReturnType
typedef Eigen::Index	Index
typedef internal::subvector_stl_iterator< ExpressionType, DirectionType(Direction)>	iterator
typedef ReturnType< internal::member_maxCoeff >::Type	MaxCoeffReturnType
typedef ReturnType< internal::member_minCoeff >::Type	MinCoeffReturnType
typedef CwiseUnaryOp< internal::scalar_sqrt_op< RealScalar >, const SquaredNormReturnType >	NormReturnType
typedef ReturnType< internal::member_prod >::Type	ProdReturnType
typedef ExpressionType::RealScalar	RealScalar
typedef Replicate< ExpressionType,(isVertical?Dynamic:1),(isHorizontal?Dynamic:1)>	ReplicateReturnType
typedef internal::subvector_stl_reverse_iterator< ExpressionType, DirectionType(Direction)>	reverse_iterator
typedef Reverse< ExpressionType, Direction >	ReverseReturnType
typedef ExpressionType::Scalar	Scalar
typedef PartialReduxExpr< const CwiseUnaryOp< internal::scalar_abs2_op< Scalar >, const ExpressionTypeNestedCleaned >, internal::member_sum< RealScalar, RealScalar >, Direction >	SquaredNormReturnType
typedef ReturnType< internal::member_stableNorm, RealScalar >::Type	StableNormReturnType
typedef ReturnType< internal::member_sum >::Type	SumReturnType

Public Member Functions
EIGEN_DEVICE_FUNC const ExpressionType &	_expression () const
EIGEN_DEVICE_FUNC const AllReturnType	all () const
EIGEN_DEVICE_FUNC const AnyReturnType	any () const
iterator	begin ()
const_iterator	begin () const
EIGEN_DEVICE_FUNC const BlueNormReturnType	blueNorm () const
const_iterator	cbegin () const
const_iterator	cend () const
EIGEN_DEVICE_FUNC const CountReturnType	count () const
const_reverse_iterator	crbegin () const
const_reverse_iterator	crend () const
template<typename OtherDerived >
EIGEN_DEVICE_FUNC const CrossReturnType	cross (const MatrixBase< OtherDerived > &other) const
typedef	EIGEN_EXPR_BINARYOP_SCALAR_RETURN_TYPE (SumReturnType, Scalar, quotient) MeanReturnType
iterator	end ()
const_iterator	end () const
EIGEN_DEVICE_FUNC const HNormalizedReturnType	hnormalized () const
	column or row-wise homogeneous normalization More...
EIGEN_DEVICE_FUNC HomogeneousReturnType	homogeneous () const
EIGEN_DEVICE_FUNC const HypotNormReturnType	hypotNorm () const
template<int p>
EIGEN_DEVICE_FUNC const LpNormReturnType< p >::Type	lpNorm () const
EIGEN_DEVICE_FUNC const MaxCoeffReturnType	maxCoeff () const
EIGEN_DEVICE_FUNC const MeanReturnType	mean () const
EIGEN_DEVICE_FUNC const MinCoeffReturnType	minCoeff () const
EIGEN_DEVICE_FUNC const NormReturnType	norm () const
EIGEN_DEVICE_FUNC void	normalize ()
EIGEN_DEVICE_FUNC CwiseBinaryOp< internal::scalar_quotient_op< Scalar >, const ExpressionTypeNestedCleaned, const typename OppositeExtendedType< NormReturnType >::Type >	normalized () const
template<typename OtherDerived >
EIGEN_STRONG_INLINE EIGEN_DEVICE_FUNC CwiseBinaryOp< internal::scalar_product_op< Scalar >, const ExpressionTypeNestedCleaned, const typename ExtendedType< OtherDerived >::Type > EIGEN_DEVICE_FUNC	operator* (const DenseBase< OtherDerived > &other) const
template<typename OtherDerived >
EIGEN_DEVICE_FUNC ExpressionType &	operator*= (const DenseBase< OtherDerived > &other)
template<typename OtherDerived >
EIGEN_STRONG_INLINE EIGEN_DEVICE_FUNC CwiseBinaryOp< internal::scalar_sum_op< Scalar, typename OtherDerived::Scalar >, const ExpressionTypeNestedCleaned, const typename ExtendedType< OtherDerived >::Type >	operator+ (const DenseBase< OtherDerived > &other) const
template<typename OtherDerived >
EIGEN_DEVICE_FUNC ExpressionType &	operator+= (const DenseBase< OtherDerived > &other)
template<typename OtherDerived >
EIGEN_DEVICE_FUNC CwiseBinaryOp< internal::scalar_difference_op< Scalar, typename OtherDerived::Scalar >, const ExpressionTypeNestedCleaned, const typename ExtendedType< OtherDerived >::Type >	operator- (const DenseBase< OtherDerived > &other) const
template<typename OtherDerived >
EIGEN_DEVICE_FUNC ExpressionType &	operator-= (const DenseBase< OtherDerived > &other)
template<typename OtherDerived >
EIGEN_DEVICE_FUNC CwiseBinaryOp< internal::scalar_quotient_op< Scalar >, const ExpressionTypeNestedCleaned, const typename ExtendedType< OtherDerived >::Type >	operator/ (const DenseBase< OtherDerived > &other) const
template<typename OtherDerived >
EIGEN_DEVICE_FUNC ExpressionType &	operator/= (const DenseBase< OtherDerived > &other)
template<typename OtherDerived >
EIGEN_DEVICE_FUNC ExpressionType &	operator= (const DenseBase< OtherDerived > &other)
EIGEN_DEVICE_FUNC const ProdReturnType	prod () const
reverse_iterator	rbegin ()
const_reverse_iterator	rbegin () const
template<typename BinaryOp >
EIGEN_DEVICE_FUNC const ReduxReturnType< BinaryOp >::Type	redux (const BinaryOp &func=BinaryOp()) const
reverse_iterator	rend ()
const_reverse_iterator	rend () const
EIGEN_DEVICE_FUNC const ReplicateReturnType	replicate (Index factor) const
template<int Factor>
const Replicate< ExpressionType, isVertical *Factor+isHorizontal, isHorizontal *Factor+isVertical > EIGEN_DEVICE_FUNC	replicate (Index factor=Factor) const
EIGEN_DEVICE_FUNC const ConstReverseReturnType	reverse () const
EIGEN_DEVICE_FUNC ReverseReturnType	reverse ()
EIGEN_DEVICE_FUNC void	reverseInPlace ()
EIGEN_DEVICE_FUNC const SquaredNormReturnType	squaredNorm () const
EIGEN_DEVICE_FUNC const StableNormReturnType	stableNorm () const
EIGEN_DEVICE_FUNC const SumReturnType	sum () const
EIGEN_DEVICE_FUNC	VectorwiseOp (ExpressionType &matrix)

Protected Member Functions
template<typename OtherDerived >
EIGEN_DEVICE_FUNC ExtendedType< OtherDerived >::Type	extendedTo (const DenseBase< OtherDerived > &other) const
template<typename OtherDerived >
EIGEN_DEVICE_FUNC OppositeExtendedType< OtherDerived >::Type	extendedToOpposite (const DenseBase< OtherDerived > &other) const
Index	redux_length () const

Protected Attributes
ExpressionTypeNested	m_matrix

Detailed Description

template<typename ExpressionType, int Direction>
class Eigen::VectorwiseOp< ExpressionType, Direction >

Pseudo expression providing broadcasting and partial reduction operations.

Template Parameters

ExpressionType	the type of the object on which to do partial reductions
Direction	indicates whether to operate on columns (Vertical) or rows (Horizontal)

This class represents a pseudo expression with broadcasting and partial reduction features. It is the return type of DenseBase::colwise() and DenseBase::rowwise() and most of the time this is the only way it is explicitly used.

To understand the logic of rowwise/colwise expression, let's consider a generic case A.colwise().foo() where foo is any method of VectorwiseOp. This expression is equivalent to applying foo() to each column of A and then re-assemble the outputs in a matrix expression:

[A.col(0).foo(), A.col(1).foo(), ..., A.col(A.cols()-1).foo()] 

Example:

Matrix3d m = Matrix3d::Random();
cout << "Here is the matrix m:" << endl << m << endl;
cout << "Here is the sum of each column:" << endl << m.colwise().sum() << endl;
cout << "Here is the maximum absolute value of each column:"
     << endl << m.cwiseAbs().colwise().maxCoeff() << endl;

Output:

The begin() and end() methods are obviously exceptions to the previous rule as they return STL-compatible begin/end iterators to the rows or columns of the nested expression. Typical use cases include for-range-loop and calls to STL algorithms:

Example:

Matrix3i m = Matrix3i::Random();
cout << "Here is the initial matrix m:" << endl << m << endl;
int i = -1;
for(auto c: m.colwise()) {
  c *= i;
  ++i;
}
cout << "Here is the matrix m after the for-range-loop:" << endl << m << endl;
auto cols = m.colwise();
auto it = std::find_if(cols.cbegin(), cols.cend(),
                       [](Matrix3i::ConstColXpr x) { return x.squaredNorm() == 0; });
cout << "The first empty column is: " << distance(cols.cbegin(),it) << endl;

Output:

For a partial reduction on an empty input, some rules apply. For the sake of clarity, let's consider a vertical reduction:

• If the number of columns is zero, then a 1x0 row-major vector expression is returned.
• Otherwise, if the number of rows is zero, then
  • a row vector of zeros is returned for sum-like reductions (sum, squaredNorm, norm, etc.)
  • a row vector of ones is returned for a product reduction (e.g., MatrixXd(n,0).colwise().prod())
  • an assert is triggered for all other reductions (minCoeff,maxCoeff,redux(bin_op))

See also

DenseBase::colwise(), DenseBase::rowwise(), class PartialReduxExpr

Definition at line 264 of file ForwardDeclarations.h.

Member Typedef Documentation

AllReturnType

template<typename ExpressionType, int Direction>

typedef ReturnType<internal::member_all>::Type Eigen::VectorwiseOp< ExpressionType, Direction >::AllReturnType

Definition at line 352 of file VectorwiseOp.h.

AnyReturnType

template<typename ExpressionType, int Direction>

typedef ReturnType<internal::member_any>::Type Eigen::VectorwiseOp< ExpressionType, Direction >::AnyReturnType

Definition at line 353 of file VectorwiseOp.h.

BlueNormReturnType

template<typename ExpressionType, int Direction>

typedef ReturnType<internal::member_blueNorm,RealScalar>::Type Eigen::VectorwiseOp< ExpressionType, Direction >::BlueNormReturnType

Definition at line 347 of file VectorwiseOp.h.

const_iterator

template<typename ExpressionType, int Direction>

typedef internal::subvector_stl_iterator<const ExpressionType, DirectionType(Direction)> Eigen::VectorwiseOp< ExpressionType, Direction >::const_iterator

Definition at line 283 of file VectorwiseOp.h.

const_reverse_iterator

template<typename ExpressionType, int Direction>

typedef internal::subvector_stl_reverse_iterator<const ExpressionType, DirectionType(Direction)> Eigen::VectorwiseOp< ExpressionType, Direction >::const_reverse_iterator

Definition at line 285 of file VectorwiseOp.h.

ConstReverseReturnType

template<typename ExpressionType, int Direction>

typedef Reverse<const ExpressionType, Direction> Eigen::VectorwiseOp< ExpressionType, Direction >::ConstReverseReturnType

Definition at line 356 of file VectorwiseOp.h.

CountReturnType

template<typename ExpressionType, int Direction>

typedef PartialReduxExpr<ExpressionType, internal::member_count<Index,Scalar>, Direction> Eigen::VectorwiseOp< ExpressionType, Direction >::CountReturnType

Definition at line 354 of file VectorwiseOp.h.

CrossReturnType

template<typename ExpressionType, int Direction>

typedef ExpressionType::PlainObject Eigen::VectorwiseOp< ExpressionType, Direction >::CrossReturnType

Definition at line 712 of file VectorwiseOp.h.

ExpressionTypeNested

template<typename ExpressionType, int Direction>

typedef internal::ref_selector<ExpressionType>::non_const_type Eigen::VectorwiseOp< ExpressionType, Direction >::ExpressionTypeNested

Definition at line 193 of file VectorwiseOp.h.

ExpressionTypeNestedCleaned

template<typename ExpressionType, int Direction>

typedef internal::remove_all<ExpressionTypeNested>::type Eigen::VectorwiseOp< ExpressionType, Direction >::ExpressionTypeNestedCleaned

Definition at line 194 of file VectorwiseOp.h.

HNormalized_Block

template<typename ExpressionType, int Direction>

typedef Block<const ExpressionType, Direction==Vertical ? int(HNormalized_SizeMinusOne) : int(internal::traits<ExpressionType>::RowsAtCompileTime), Direction==Horizontal ? int(HNormalized_SizeMinusOne) : int(internal::traits<ExpressionType>::ColsAtCompileTime)> Eigen::VectorwiseOp< ExpressionType, Direction >::HNormalized_Block

Definition at line 727 of file VectorwiseOp.h.

HNormalized_Factors

template<typename ExpressionType, int Direction>

typedef Block<const ExpressionType, Direction==Vertical ? 1 : int(internal::traits<ExpressionType>::RowsAtCompileTime), Direction==Horizontal ? 1 : int(internal::traits<ExpressionType>::ColsAtCompileTime)> Eigen::VectorwiseOp< ExpressionType, Direction >::HNormalized_Factors

Definition at line 731 of file VectorwiseOp.h.

HNormalizedReturnType

template<typename ExpressionType, int Direction>

typedef CwiseBinaryOp<internal::scalar_quotient_op<typename internal::traits<ExpressionType>::Scalar>, const HNormalized_Block, const Replicate<HNormalized_Factors, Direction==Vertical ? HNormalized_SizeMinusOne : 1, Direction==Horizontal ? HNormalized_SizeMinusOne : 1> > Eigen::VectorwiseOp< ExpressionType, Direction >::HNormalizedReturnType

Definition at line 737 of file VectorwiseOp.h.

HomogeneousReturnType

template<typename ExpressionType, int Direction>

typedef Homogeneous<ExpressionType,Direction> Eigen::VectorwiseOp< ExpressionType, Direction >::HomogeneousReturnType

Definition at line 708 of file VectorwiseOp.h.

HypotNormReturnType

template<typename ExpressionType, int Direction>

typedef ReturnType<internal::member_hypotNorm,RealScalar>::Type Eigen::VectorwiseOp< ExpressionType, Direction >::HypotNormReturnType

Definition at line 349 of file VectorwiseOp.h.

Index

template<typename ExpressionType, int Direction>

typedef Eigen::Index Eigen::VectorwiseOp< ExpressionType, Direction >::Index

Deprecated:

since Eigen 3.3

Definition at line 192 of file VectorwiseOp.h.

iterator

template<typename ExpressionType, int Direction>

typedef internal::subvector_stl_iterator<ExpressionType, DirectionType(Direction)> Eigen::VectorwiseOp< ExpressionType, Direction >::iterator

Definition at line 282 of file VectorwiseOp.h.

MaxCoeffReturnType

template<typename ExpressionType, int Direction>

typedef ReturnType<internal::member_maxCoeff>::Type Eigen::VectorwiseOp< ExpressionType, Direction >::MaxCoeffReturnType

Definition at line 344 of file VectorwiseOp.h.

MinCoeffReturnType

template<typename ExpressionType, int Direction>

typedef ReturnType<internal::member_minCoeff>::Type Eigen::VectorwiseOp< ExpressionType, Direction >::MinCoeffReturnType

Definition at line 343 of file VectorwiseOp.h.

NormReturnType

template<typename ExpressionType, int Direction>

typedef CwiseUnaryOp<internal::scalar_sqrt_op<RealScalar>, const SquaredNormReturnType> Eigen::VectorwiseOp< ExpressionType, Direction >::NormReturnType

Definition at line 346 of file VectorwiseOp.h.

ProdReturnType

template<typename ExpressionType, int Direction>

typedef ReturnType<internal::member_prod>::Type Eigen::VectorwiseOp< ExpressionType, Direction >::ProdReturnType

Definition at line 355 of file VectorwiseOp.h.

RealScalar

template<typename ExpressionType, int Direction>

typedef ExpressionType::RealScalar Eigen::VectorwiseOp< ExpressionType, Direction >::RealScalar

Definition at line 191 of file VectorwiseOp.h.

ReplicateReturnType

template<typename ExpressionType, int Direction>

typedef Replicate<ExpressionType,(isVertical?Dynamic:1),(isHorizontal?Dynamic:1)> Eigen::VectorwiseOp< ExpressionType, Direction >::ReplicateReturnType

Definition at line 552 of file VectorwiseOp.h.

reverse_iterator

template<typename ExpressionType, int Direction>

typedef internal::subvector_stl_reverse_iterator<ExpressionType, DirectionType(Direction)> Eigen::VectorwiseOp< ExpressionType, Direction >::reverse_iterator

Definition at line 284 of file VectorwiseOp.h.

ReverseReturnType

template<typename ExpressionType, int Direction>

typedef Reverse<ExpressionType, Direction> Eigen::VectorwiseOp< ExpressionType, Direction >::ReverseReturnType

Definition at line 357 of file VectorwiseOp.h.

Scalar

template<typename ExpressionType, int Direction>

typedef ExpressionType::Scalar Eigen::VectorwiseOp< ExpressionType, Direction >::Scalar

Definition at line 190 of file VectorwiseOp.h.

SquaredNormReturnType

template<typename ExpressionType, int Direction>

typedef PartialReduxExpr<const CwiseUnaryOp<internal::scalar_abs2_op<Scalar>, const ExpressionTypeNestedCleaned>,internal::member_sum<RealScalar,RealScalar>,Direction> Eigen::VectorwiseOp< ExpressionType, Direction >::SquaredNormReturnType

Definition at line 345 of file VectorwiseOp.h.

StableNormReturnType

template<typename ExpressionType, int Direction>

typedef ReturnType<internal::member_stableNorm,RealScalar>::Type Eigen::VectorwiseOp< ExpressionType, Direction >::StableNormReturnType

Definition at line 348 of file VectorwiseOp.h.

SumReturnType

template<typename ExpressionType, int Direction>

typedef ReturnType<internal::member_sum>::Type Eigen::VectorwiseOp< ExpressionType, Direction >::SumReturnType

Definition at line 350 of file VectorwiseOp.h.

Member Enumeration Documentation

anonymous enum

template<typename ExpressionType, int Direction>

anonymous enum

Enumerator
isVertical
isHorizontal

Definition at line 213 of file VectorwiseOp.h.

anonymous enum

template<typename ExpressionType, int Direction>

anonymous enum

Enumerator
HNormalized_Size
HNormalized_SizeMinusOne

Definition at line 717 of file VectorwiseOp.h.

Constructor & Destructor Documentation

VectorwiseOp()

template<typename ExpressionType, int Direction>

EIGEN_DEVICE_FUNC Eigen::VectorwiseOp< ExpressionType, Direction >::VectorwiseOp ( ExpressionType &  matrix )

inlineexplicit

Definition at line 268 of file VectorwiseOp.h.

Member Function Documentation

_expression()

template<typename ExpressionType, int Direction>

EIGEN_DEVICE_FUNC const ExpressionType& Eigen::VectorwiseOp< ExpressionType, Direction >::_expression ( ) const

inline

Definition at line 272 of file VectorwiseOp.h.

all()

template<typename ExpressionType, int Direction>

EIGEN_DEVICE_FUNC const AllReturnType Eigen::VectorwiseOp< ExpressionType, Direction >::all ( ) const

inline

Returns

a row (or column) vector expression representing whether all coefficients of each respective column (or row) are true. This expression can be assigned to a vector with entries of type bool.

See also

DenseBase::all()

Definition at line 496 of file VectorwiseOp.h.

any()

template<typename ExpressionType, int Direction>

EIGEN_DEVICE_FUNC const AnyReturnType Eigen::VectorwiseOp< ExpressionType, Direction >::any ( ) const

inline

Returns

a row (or column) vector expression representing whether at least one coefficient of each respective column (or row) is true. This expression can be assigned to a vector with entries of type bool.

See also

DenseBase::any()

Definition at line 505 of file VectorwiseOp.h.

begin() [1/2]

template<typename ExpressionType, int Direction>

iterator Eigen::VectorwiseOp< ExpressionType, Direction >::begin ( )

inline

returns an iterator to the first row (rowwise) or column (colwise) of the nested expression.

See also

end(), cbegin()

Definition at line 291 of file VectorwiseOp.h.

begin() [2/2]

template<typename ExpressionType, int Direction>

const_iterator Eigen::VectorwiseOp< ExpressionType, Direction >::begin ( ) const

inline

const version of begin()

Definition at line 293 of file VectorwiseOp.h.

blueNorm()

template<typename ExpressionType, int Direction>

EIGEN_DEVICE_FUNC const BlueNormReturnType Eigen::VectorwiseOp< ExpressionType, Direction >::blueNorm ( ) const

inline

Returns

a row (or column) vector expression of the norm of each column (or row) of the referenced expression, using Blue's algorithm. This is a vector with real entries, even if the original matrix has complex entries.

See also

DenseBase::blueNorm()

Definition at line 446 of file VectorwiseOp.h.

cbegin()

template<typename ExpressionType, int Direction>

const_iterator Eigen::VectorwiseOp< ExpressionType, Direction >::cbegin ( ) const

inline

const version of begin()

Definition at line 295 of file VectorwiseOp.h.

cend()

template<typename ExpressionType, int Direction>

const_iterator Eigen::VectorwiseOp< ExpressionType, Direction >::cend ( ) const

inline

const version of end()

Definition at line 313 of file VectorwiseOp.h.

count()

template<typename ExpressionType, int Direction>

EIGEN_DEVICE_FUNC const CountReturnType Eigen::VectorwiseOp< ExpressionType, Direction >::count ( ) const

inline

Returns

a row (or column) vector expression representing the number of true coefficients of each respective column (or row). This expression can be assigned to a vector whose entries have the same type as is used to index entries of the original matrix; for dense matrices, this is std::ptrdiff_t .

Example:

Matrix3d m = Matrix3d::Random();
cout << "Here is the matrix m:" << endl << m << endl;
Matrix<ptrdiff_t, 3, 1> res = (m.array() >= 0.5).rowwise().count();
cout << "Here is the count of elements larger or equal than 0.5 of each row:" << endl;
cout << res << endl;

Output:

See also

DenseBase::count()

Definition at line 518 of file VectorwiseOp.h.

crbegin()

template<typename ExpressionType, int Direction>

const_reverse_iterator Eigen::VectorwiseOp< ExpressionType, Direction >::crbegin ( ) const

inline

const version of rbegin()

Definition at line 304 of file VectorwiseOp.h.

crend()

template<typename ExpressionType, int Direction>

const_reverse_iterator Eigen::VectorwiseOp< ExpressionType, Direction >::crend ( ) const

inline

const version of rend()

Definition at line 322 of file VectorwiseOp.h.

EIGEN_EXPR_BINARYOP_SCALAR_RETURN_TYPE()

template<typename ExpressionType, int Direction>

typedef Eigen::VectorwiseOp< ExpressionType, Direction >::EIGEN_EXPR_BINARYOP_SCALAR_RETURN_TYPE	(	SumReturnType	,
		Scalar	,
		quotient
	)

end() [1/2]

template<typename ExpressionType, int Direction>

iterator Eigen::VectorwiseOp< ExpressionType, Direction >::end ( )

inline

returns an iterator to the row (resp. column) following the last row (resp. column) of the nested expression

See also

begin(), cend()

Definition at line 309 of file VectorwiseOp.h.

end() [2/2]

template<typename ExpressionType, int Direction>

const_iterator Eigen::VectorwiseOp< ExpressionType, Direction >::end ( ) const

inline

const version of end()

Definition at line 311 of file VectorwiseOp.h.

extendedTo()

template<typename ExpressionType, int Direction>

template<typename OtherDerived >

EIGEN_DEVICE_FUNC ExtendedType<OtherDerived>::Type Eigen::VectorwiseOp< ExpressionType, Direction >::extendedTo ( const DenseBase< OtherDerived > &  other ) const

inlineprotected

Definition at line 231 of file VectorwiseOp.h.

extendedToOpposite()

template<typename ExpressionType, int Direction>

template<typename OtherDerived >

EIGEN_DEVICE_FUNC OppositeExtendedType<OtherDerived>::Type Eigen::VectorwiseOp< ExpressionType, Direction >::extendedToOpposite ( const DenseBase< OtherDerived > &  other ) const

inlineprotected

Definition at line 254 of file VectorwiseOp.h.

hypotNorm()

template<typename ExpressionType, int Direction>

EIGEN_DEVICE_FUNC const HypotNormReturnType Eigen::VectorwiseOp< ExpressionType, Direction >::hypotNorm ( ) const

inline

Returns

a row (or column) vector expression of the norm of each column (or row) of the referenced expression, avoiding underflow and overflow using a concatenation of hypot() calls. This is a vector with real entries, even if the original matrix has complex entries.

See also

DenseBase::hypotNorm()

Definition at line 468 of file VectorwiseOp.h.

lpNorm()

template<typename ExpressionType, int Direction>

template<int p>

EIGEN_DEVICE_FUNC const LpNormReturnType<p>::Type Eigen::VectorwiseOp< ExpressionType, Direction >::lpNorm ( ) const

inline

Returns

a row (or column) vector expression of the norm of each column (or row) of the referenced expression. This is a vector with real entries, even if the original matrix has complex entries.

Example:

Matrix3d m = Matrix3d::Random();
cout << "Here is the matrix m:" << endl << m << endl;
cout << "Here is the norm of each column:" << endl << m.colwise().norm() << endl;

Output:

See also

DenseBase::norm()

Definition at line 435 of file VectorwiseOp.h.

maxCoeff()

template<typename ExpressionType, int Direction>

EIGEN_DEVICE_FUNC const MaxCoeffReturnType Eigen::VectorwiseOp< ExpressionType, Direction >::maxCoeff ( ) const

inline

Returns

a row (or column) vector expression of the largest coefficient of each column (or row) of the referenced expression.

Warning

the size along the reduction direction must be strictly positive, otherwise an assertion is triggered.

the result is undefined if *this contains NaN.

Example:

Matrix3d m = Matrix3d::Random();
cout << "Here is the matrix m:" << endl << m << endl;
cout << "Here is the maximum of each column:" << endl << m.colwise().maxCoeff() << endl;

Output:

See also

DenseBase::maxCoeff()

Definition at line 395 of file VectorwiseOp.h.

mean()

template<typename ExpressionType, int Direction>

EIGEN_DEVICE_FUNC const MeanReturnType Eigen::VectorwiseOp< ExpressionType, Direction >::mean ( ) const

inline

Returns

a row (or column) vector expression of the mean of each column (or row) of the referenced expression.

See also

DenseBase::mean()

Definition at line 487 of file VectorwiseOp.h.

minCoeff()

template<typename ExpressionType, int Direction>

EIGEN_DEVICE_FUNC const MinCoeffReturnType Eigen::VectorwiseOp< ExpressionType, Direction >::minCoeff ( ) const

inline

Returns

a row (or column) vector expression of the smallest coefficient of each column (or row) of the referenced expression.

Warning

the size along the reduction direction must be strictly positive, otherwise an assertion is triggered.

the result is undefined if *this contains NaN.

Example:

Matrix3d m = Matrix3d::Random();
cout << "Here is the matrix m:" << endl << m << endl;
cout << "Here is the minimum of each column:" << endl << m.colwise().minCoeff() << endl;

Output:

See also

DenseBase::minCoeff()

Definition at line 376 of file VectorwiseOp.h.

norm()

template<typename ExpressionType, int Direction>

EIGEN_DEVICE_FUNC const NormReturnType Eigen::VectorwiseOp< ExpressionType, Direction >::norm ( ) const

inline

Returns

a row (or column) vector expression of the norm of each column (or row) of the referenced expression. This is a vector with real entries, even if the original matrix has complex entries.

Example:

Matrix3d m = Matrix3d::Random();
cout << "Here is the matrix m:" << endl << m << endl;
cout << "Here is the norm of each column:" << endl << m.colwise().norm() << endl;

Output:

See also

DenseBase::norm()

Definition at line 422 of file VectorwiseOp.h.

normalize()

template<typename ExpressionType, int Direction>

EIGEN_DEVICE_FUNC void Eigen::VectorwiseOp< ExpressionType, Direction >::normalize ( )

inline

Normalize in-place each row or columns of the referenced matrix.

See also

MatrixBase::normalize(), normalized()

Definition at line 700 of file VectorwiseOp.h.

normalized()

template<typename ExpressionType, int Direction>

EIGEN_DEVICE_FUNC CwiseBinaryOp<internal::scalar_quotient_op<Scalar>, const ExpressionTypeNestedCleaned, const typename OppositeExtendedType<NormReturnType>::Type> Eigen::VectorwiseOp< ExpressionType, Direction >::normalized ( ) const

inline

Returns

an expression where each column (or row) of the referenced matrix are normalized. The referenced matrix is not modified.

See also

MatrixBase::normalized(), normalize()

Definition at line 694 of file VectorwiseOp.h.

operator*()

template<typename ExpressionType, int Direction>

template<typename OtherDerived >

EIGEN_STRONG_INLINE EIGEN_DEVICE_FUNC CwiseBinaryOp<internal::scalar_product_op<Scalar>, const ExpressionTypeNestedCleaned, const typename ExtendedType<OtherDerived>::Type> EIGEN_DEVICE_FUNC Eigen::VectorwiseOp< ExpressionType, Direction >::operator* ( const DenseBase< OtherDerived > &  other ) const

inline

Returns the expression where each subvector is the product of the vector other by the corresponding subvector of *this

Definition at line 663 of file VectorwiseOp.h.

operator*=()

template<typename ExpressionType, int Direction>

template<typename OtherDerived >

EIGEN_DEVICE_FUNC ExpressionType& Eigen::VectorwiseOp< ExpressionType, Direction >::operator*= ( const DenseBase< OtherDerived > &  other )

inline

Multiples each subvector of *this by the vector other

Definition at line 610 of file VectorwiseOp.h.

operator+()

template<typename ExpressionType, int Direction>

template<typename OtherDerived >

EIGEN_STRONG_INLINE EIGEN_DEVICE_FUNC CwiseBinaryOp<internal::scalar_sum_op<Scalar,typename OtherDerived::Scalar>, const ExpressionTypeNestedCleaned, const typename ExtendedType<OtherDerived>::Type> Eigen::VectorwiseOp< ExpressionType, Direction >::operator+ ( const DenseBase< OtherDerived > &  other ) const

inline

Returns the expression of the sum of the vector other to each subvector of *this

Definition at line 636 of file VectorwiseOp.h.

operator+=()

template<typename ExpressionType, int Direction>

template<typename OtherDerived >

EIGEN_DEVICE_FUNC ExpressionType& Eigen::VectorwiseOp< ExpressionType, Direction >::operator+= ( const DenseBase< OtherDerived > &  other )

inline

Adds the vector other to each subvector of *this

Definition at line 590 of file VectorwiseOp.h.

operator-()

template<typename ExpressionType, int Direction>

template<typename OtherDerived >

EIGEN_DEVICE_FUNC CwiseBinaryOp<internal::scalar_difference_op<Scalar,typename OtherDerived::Scalar>, const ExpressionTypeNestedCleaned, const typename ExtendedType<OtherDerived>::Type> Eigen::VectorwiseOp< ExpressionType, Direction >::operator- ( const DenseBase< OtherDerived > &  other ) const

inline

Returns the expression of the difference between each subvector of *this and the vector other

Definition at line 649 of file VectorwiseOp.h.

operator-=()

template<typename ExpressionType, int Direction>

template<typename OtherDerived >

EIGEN_DEVICE_FUNC ExpressionType& Eigen::VectorwiseOp< ExpressionType, Direction >::operator-= ( const DenseBase< OtherDerived > &  other )

inline

Substracts the vector other to each subvector of *this

Definition at line 600 of file VectorwiseOp.h.

operator/()

template<typename ExpressionType, int Direction>

template<typename OtherDerived >

EIGEN_DEVICE_FUNC CwiseBinaryOp<internal::scalar_quotient_op<Scalar>, const ExpressionTypeNestedCleaned, const typename ExtendedType<OtherDerived>::Type> Eigen::VectorwiseOp< ExpressionType, Direction >::operator/ ( const DenseBase< OtherDerived > &  other ) const

inline

Returns the expression where each subvector is the quotient of the corresponding subvector of *this by the vector other

Definition at line 678 of file VectorwiseOp.h.

operator/=()

template<typename ExpressionType, int Direction>

template<typename OtherDerived >

EIGEN_DEVICE_FUNC ExpressionType& Eigen::VectorwiseOp< ExpressionType, Direction >::operator/= ( const DenseBase< OtherDerived > &  other )

inline

Divides each subvector of *this by the vector other

Definition at line 622 of file VectorwiseOp.h.

operator=()

template<typename ExpressionType, int Direction>

template<typename OtherDerived >

EIGEN_DEVICE_FUNC ExpressionType& Eigen::VectorwiseOp< ExpressionType, Direction >::operator= ( const DenseBase< OtherDerived > &  other )

inline

Copies the vector other to each subvector of *this

Definition at line 579 of file VectorwiseOp.h.

prod()

template<typename ExpressionType, int Direction>

EIGEN_DEVICE_FUNC const ProdReturnType Eigen::VectorwiseOp< ExpressionType, Direction >::prod ( ) const

inline

Returns

a row (or column) vector expression of the product of each column (or row) of the referenced expression.

Example:

Matrix3d m = Matrix3d::Random();
cout << "Here is the matrix m:" << endl << m << endl;
cout << "Here is the product of each row:" << endl << m.rowwise().prod() << endl;

Output:

See also

DenseBase::prod()

Definition at line 529 of file VectorwiseOp.h.

rbegin() [1/2]

template<typename ExpressionType, int Direction>

reverse_iterator Eigen::VectorwiseOp< ExpressionType, Direction >::rbegin ( )

inline

returns a reverse iterator to the last row (rowwise) or column (colwise) of the nested expression.

See also

rend(), crbegin()

Definition at line 300 of file VectorwiseOp.h.

rbegin() [2/2]

template<typename ExpressionType, int Direction>

const_reverse_iterator Eigen::VectorwiseOp< ExpressionType, Direction >::rbegin ( ) const

inline

const version of rbegin()

Definition at line 302 of file VectorwiseOp.h.

redux()

template<typename ExpressionType, int Direction>

template<typename BinaryOp >

EIGEN_DEVICE_FUNC const ReduxReturnType<BinaryOp>::Type Eigen::VectorwiseOp< ExpressionType, Direction >::redux ( const BinaryOp &  func = BinaryOp() ) const

inline

Returns

a row or column vector expression of *this reduxed by func

The template parameter BinaryOp is the type of the functor of the custom redux operator. Note that func must be an associative operator.

Warning

the size along the reduction direction must be strictly positive, otherwise an assertion is triggered.

See also

class VectorwiseOp, DenseBase::colwise(), DenseBase::rowwise()

Definition at line 337 of file VectorwiseOp.h.

redux_length()

template<typename ExpressionType, int Direction>

Index Eigen::VectorwiseOp< ExpressionType, Direction >::redux_length ( ) const

inlineprotected

Definition at line 747 of file VectorwiseOp.h.

rend() [1/2]

template<typename ExpressionType, int Direction>

reverse_iterator Eigen::VectorwiseOp< ExpressionType, Direction >::rend ( )

inline

returns a reverse iterator to the row (resp. column) before the first row (resp. column) of the nested expression

See also

begin(), cend()

Definition at line 318 of file VectorwiseOp.h.

rend() [2/2]

template<typename ExpressionType, int Direction>

const_reverse_iterator Eigen::VectorwiseOp< ExpressionType, Direction >::rend ( ) const

inline

const version of rend()

Definition at line 320 of file VectorwiseOp.h.

replicate() [1/2]

template<typename ExpressionType , int Direction>

EIGEN_DEVICE_FUNC const VectorwiseOp< ExpressionType, Direction >::ReplicateReturnType Eigen::VectorwiseOp< ExpressionType, Direction >::replicate

(

Index

factor

)

const

Returns

an expression of the replication of each column (or row) of *this

Example:

Vector3i v = Vector3i::Random();
cout << "Here is the vector v:" << endl << v << endl;
cout << "v.rowwise().replicate(5) = ..." << endl;
cout << v.rowwise().replicate(5) << endl;

Output:

See also

VectorwiseOp::replicate(), DenseBase::replicate(), class Replicate

Definition at line 134 of file Replicate.h.

replicate() [2/2]

template<typename ExpressionType, int Direction>

template<int Factor>

const Replicate<ExpressionType,isVertical*Factor+isHorizontal,isHorizontal*Factor+isVertical> EIGEN_DEVICE_FUNC Eigen::VectorwiseOp< ExpressionType, Direction >::replicate ( Index  factor = Factor ) const

inline

Returns

an expression of the replication of each column (or row) of *this

Example:

MatrixXi m = MatrixXi::Random(2,3);
cout << "Here is the matrix m:" << endl << m << endl;
cout << "m.colwise().replicate<3>() = ..." << endl;
cout << m.colwise().replicate<3>() << endl;

Output:

See also

VectorwiseOp::replicate(Index), DenseBase::replicate(), class Replicate

Definition at line 568 of file VectorwiseOp.h.

reverse() [1/2]

template<typename ExpressionType, int Direction>

EIGEN_DEVICE_FUNC const ConstReverseReturnType Eigen::VectorwiseOp< ExpressionType, Direction >::reverse ( ) const

inline

Returns

a matrix expression where each column (or row) are reversed.

Example:

MatrixXi m = MatrixXi::Random(3,4);
cout << "Here is the matrix m:" << endl << m << endl;
cout << "Here is the rowwise reverse of m:" << endl << m.rowwise().reverse() << endl;
cout << "Here is the colwise reverse of m:" << endl << m.colwise().reverse() << endl;

cout << "Here is the coefficient (1,0) in the rowise reverse of m:" << endl
<< m.rowwise().reverse()(1,0) << endl;
cout << "Let us overwrite this coefficient with the value 4." << endl;
//m.colwise().reverse()(1,0) = 4;
cout << "Now the matrix m is:" << endl << m << endl;

Output:

See also

DenseBase::reverse()

Definition at line 541 of file VectorwiseOp.h.

reverse() [2/2]

template<typename ExpressionType, int Direction>

EIGEN_DEVICE_FUNC ReverseReturnType Eigen::VectorwiseOp< ExpressionType, Direction >::reverse ( )

inline

Returns

a writable matrix expression where each column (or row) are reversed.

See also

reverse() const

Definition at line 549 of file VectorwiseOp.h.

reverseInPlace()

template<typename ExpressionType , int Direction>

EIGEN_DEVICE_FUNC void Eigen::VectorwiseOp< ExpressionType, Direction >::reverseInPlace ( )

inline

This is the "in place" version of VectorwiseOp::reverse: it reverses each column or row of *this.

In most cases it is probably better to simply use the reversed expression of a matrix. However, when reversing the matrix data itself is really needed, then this "in-place" version is probably the right choice because it provides the following additional benefits:

• less error prone: doing the same operation with .reverse() requires special care:

  m = m.reverse().eval(); 

• this API enables reverse operations without the need for a temporary

See also

DenseBase::reverseInPlace(), reverse()

Definition at line 210 of file Reverse.h.

squaredNorm()

template<typename ExpressionType, int Direction>

EIGEN_DEVICE_FUNC const SquaredNormReturnType Eigen::VectorwiseOp< ExpressionType, Direction >::squaredNorm ( ) const

inline

Returns

a row (or column) vector expression of the squared norm of each column (or row) of the referenced expression. This is a vector with real entries, even if the original matrix has complex entries.

Example:

Matrix3d m = Matrix3d::Random();
cout << "Here is the matrix m:" << endl << m << endl;
cout << "Here is the square norm of each row:" << endl << m.rowwise().squaredNorm() << endl;

Output:

See also

DenseBase::squaredNorm()

Definition at line 410 of file VectorwiseOp.h.

stableNorm()

template<typename ExpressionType, int Direction>

EIGEN_DEVICE_FUNC const StableNormReturnType Eigen::VectorwiseOp< ExpressionType, Direction >::stableNorm ( ) const

inline

Returns

a row (or column) vector expression of the norm of each column (or row) of the referenced expression, avoiding underflow and overflow. This is a vector with real entries, even if the original matrix has complex entries.

See also

DenseBase::stableNorm()

Definition at line 457 of file VectorwiseOp.h.

sum()

template<typename ExpressionType, int Direction>

EIGEN_DEVICE_FUNC const SumReturnType Eigen::VectorwiseOp< ExpressionType, Direction >::sum ( ) const

inline

Returns

a row (or column) vector expression of the sum of each column (or row) of the referenced expression.

Example:

Matrix3d m = Matrix3d::Random();
cout << "Here is the matrix m:" << endl << m << endl;
cout << "Here is the sum of each row:" << endl << m.rowwise().sum() << endl;

Output:

See also

DenseBase::sum()

Definition at line 479 of file VectorwiseOp.h.

Member Data Documentation

m_matrix

template<typename ExpressionType, int Direction>

ExpressionTypeNested Eigen::VectorwiseOp< ExpressionType, Direction >::m_matrix

protected

Definition at line 751 of file VectorwiseOp.h.

---

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

• ForwardDeclarations.h
• VectorwiseOp.h
• Replicate.h
• Reverse.h
• Homogeneous.h
• OrthoMethods.h