Blaze  3.6
Classes | Public Types | Public Member Functions | Static Public Attributes | Private Types | Private Attributes | Static Private Attributes | List of all members
blaze::DMatTSMatSchurExpr< MT1, MT2 > Class Template Reference

Expression object for dense matrix-transpose sparse matrix Schur product.The DMatTSMatSchurExpr class represents the compile time expression for Schur products between a dense matrix and a column-major sparse matrix. More...

#include <DMatTSMatSchurExpr.h>

Inherits blaze::SchurExpr< SparseMatrix< DMatTSMatSchurExpr< MT1, MT2 >, true > >, and blaze::Computation.

Classes

class  ConstIterator
 Iterator over the elements of the dense matrix/sparse matrix Schur product expression. More...
 

Public Types

using This = DMatTSMatSchurExpr< MT1, MT2 >
 Type of this DMatTSMatSchurExpr instance.
 
using BaseType = SparseMatrix< This, true >
 Base type of this DMatTSMatSchurExpr instance.
 
using ResultType = SchurTrait_t< RT1, RT2 >
 Result type for expression template evaluations.
 
using OppositeType = OppositeType_t< ResultType >
 Result type with opposite storage order for expression template evaluations.
 
using TransposeType = TransposeType_t< ResultType >
 Transpose type for expression template evaluations.
 
using ElementType = ElementType_t< ResultType >
 Resulting element type.
 
using ReturnType = const If_t< returnExpr, ExprReturnType, ElementType >
 Return type for expression template evaluations.
 
using CompositeType = If_t< useAssign, const ResultType, const DMatTSMatSchurExpr & >
 Data type for composite expression templates.
 
using LeftOperand = If_t< IsExpression_v< MT1 >, const MT1, const MT1 & >
 Composite type of the left-hand side dense matrix expression.
 
using RightOperand = If_t< IsExpression_v< MT2 >, const MT2, const MT2 & >
 Composite type of the right-hand side sparse matrix expression.
 
using MatrixType = DMatTSMatSchurExpr< MT1, MT2 >
 Type of the matrix.
 

Public Member Functions

 DMatTSMatSchurExpr (const MT1 &lhs, const MT2 &rhs) noexcept
 Constructor for the DMatTSMatSchurExpr class. More...
 
ReturnType operator() (size_t i, size_t j) const
 2D-access to the matrix elements. More...
 
ReturnType at (size_t i, size_t j) const
 Checked access to the matrix elements. More...
 
ConstIterator begin (size_t j) const
 Returns an iterator to the first non-zero element of column j. More...
 
ConstIterator end (size_t j) const
 Returns an iterator just past the last non-zero element of column j. More...
 
size_t rows () const noexcept
 Returns the current number of rows of the matrix. More...
 
size_t columns () const noexcept
 Returns the current number of columns of the matrix. More...
 
size_t nonZeros () const
 Returns the number of non-zero elements in the sparse matrix. More...
 
size_t nonZeros (size_t j) const
 Returns the number of non-zero elements in the specified column. More...
 
ConstIterator find (size_t i, size_t j) const
 Searches for a specific matrix element. More...
 
ConstIterator lowerBound (size_t i, size_t j) const
 Returns an iterator to the first index not less then the given index. More...
 
ConstIterator upperBound (size_t i, size_t j) const
 Returns an iterator to the first index greater then the given index. More...
 
LeftOperand leftOperand () const noexcept
 Returns the left-hand side dense matrix operand. More...
 
RightOperand rightOperand () const noexcept
 Returns the right-hand side transpose sparse matrix operand. More...
 
template<typename T >
bool canAlias (const T *alias) const noexcept
 Returns whether the expression can alias with the given address alias. More...
 
template<typename T >
bool isAliased (const T *alias) const noexcept
 Returns whether the expression is aliased with the given address alias. More...
 
BLAZE_ALWAYS_INLINE constexpr MatrixTypeoperator~ () noexcept
 Conversion operator for non-constant matrices. More...
 
BLAZE_ALWAYS_INLINE constexpr const MatrixTypeoperator~ () const noexcept
 Conversion operator for constant matrices. More...
 

Static Public Attributes

static constexpr bool smpAssignable = false
 Compilation switch for the expression template assignment strategy.
 
static constexpr bool storageOrder
 Storage order of the matrix.
 

Private Types

using RT1 = ResultType_t< MT1 >
 Result type of the left-hand side dense matrix expression.
 
using RT2 = ResultType_t< MT2 >
 Result type of the right-hand side sparse matrix expression.
 
using RN1 = ReturnType_t< MT1 >
 Return type of the left-hand side dense matrix expression.
 
using RN2 = ReturnType_t< MT2 >
 Return type of the right-hand side sparse matrix expression.
 
using CT1 = CompositeType_t< MT1 >
 Composite type of the left-hand side dense matrix expression.
 
using CT2 = CompositeType_t< MT2 >
 Composite type of the right-hand side sparse matrix expression.
 
using ExprReturnType = decltype(std::declval< RN1 >() *std::declval< RN2 >())
 Expression return type for the subscript operator.
 

Private Attributes

LeftOperand lhs_
 Left-hand side dense matrix of the Schur product expression.
 
RightOperand rhs_
 Right-hand side sparse matrix of the Schur product expression.
 

Static Private Attributes

static constexpr bool returnExpr = ( !IsTemporary_v<RN1> && !IsTemporary_v<RN2> )
 Compilation switch for the selection of the subscript operator return type. More...
 
static constexpr bool useAssign = ( RequiresEvaluation_v<MT1> || RequiresEvaluation_v<MT2> )
 Compilation switch for the evaluation strategy of the Schur product expression. More...
 

Detailed Description

template<typename MT1, typename MT2>
class blaze::DMatTSMatSchurExpr< MT1, MT2 >

Expression object for dense matrix-transpose sparse matrix Schur product.

The DMatTSMatSchurExpr class represents the compile time expression for Schur products between a dense matrix and a column-major sparse matrix.

Constructor & Destructor Documentation

◆ DMatTSMatSchurExpr()

template<typename MT1 , typename MT2 >
blaze::DMatTSMatSchurExpr< MT1, MT2 >::DMatTSMatSchurExpr ( const MT1 &  lhs,
const MT2 &  rhs 
)
inlineexplicitnoexcept

Constructor for the DMatTSMatSchurExpr class.

Parameters
lhsThe left-hand side dense matrix operand of the Schur product expression.
rhsThe right-hand side sparse matrix operand of the Schur product expression.

Member Function Documentation

◆ at()

template<typename MT1 , typename MT2 >
ReturnType blaze::DMatTSMatSchurExpr< MT1, MT2 >::at ( size_t  i,
size_t  j 
) const
inline

Checked access to the matrix elements.

Parameters
iAccess index for the row. The index has to be in the range $[0..M-1]$.
jAccess index for the column. The index has to be in the range $[0..N-1]$.
Returns
The resulting value.
Exceptions
std::out_of_rangeInvalid matrix access index.

◆ begin()

template<typename MT1 , typename MT2 >
ConstIterator blaze::DMatTSMatSchurExpr< MT1, MT2 >::begin ( size_t  j) const
inline

Returns an iterator to the first non-zero element of column j.

Parameters
jThe column index.
Returns
Iterator to the first non-zero element of column j.

◆ canAlias()

template<typename MT1 , typename MT2 >
template<typename T >
bool blaze::DMatTSMatSchurExpr< MT1, MT2 >::canAlias ( const T *  alias) const
inlinenoexcept

Returns whether the expression can alias with the given address alias.

Parameters
aliasThe alias to be checked.
Returns
true in case the expression can alias effect is detected, false otherwise.

◆ columns()

template<typename MT1 , typename MT2 >
size_t blaze::DMatTSMatSchurExpr< MT1, MT2 >::columns ( ) const
inlinenoexcept

Returns the current number of columns of the matrix.

Returns
The number of columns of the matrix.

◆ end()

template<typename MT1 , typename MT2 >
ConstIterator blaze::DMatTSMatSchurExpr< MT1, MT2 >::end ( size_t  j) const
inline

Returns an iterator just past the last non-zero element of column j.

Parameters
jThe column index.
Returns
Iterator just past the last non-zero element of column j.

◆ find()

template<typename MT1 , typename MT2 >
ConstIterator blaze::DMatTSMatSchurExpr< MT1, MT2 >::find ( size_t  i,
size_t  j 
) const
inline

Searches for a specific matrix element.

Parameters
iThe row index of the search element.
jThe column index of the search element.
Returns
Iterator to the element in case the index is found, end() iterator otherwise.

◆ isAliased()

template<typename MT1 , typename MT2 >
template<typename T >
bool blaze::DMatTSMatSchurExpr< MT1, MT2 >::isAliased ( const T *  alias) const
inlinenoexcept

Returns whether the expression is aliased with the given address alias.

Parameters
aliasThe alias to be checked.
Returns
true in case an alias effect is detected, false otherwise.

◆ leftOperand()

template<typename MT1 , typename MT2 >
LeftOperand blaze::DMatTSMatSchurExpr< MT1, MT2 >::leftOperand ( ) const
inlinenoexcept

Returns the left-hand side dense matrix operand.

Returns
The left-hand side dense matrix operand.

◆ lowerBound()

template<typename MT1 , typename MT2 >
ConstIterator blaze::DMatTSMatSchurExpr< MT1, MT2 >::lowerBound ( size_t  i,
size_t  j 
) const
inline

Returns an iterator to the first index not less then the given index.

Parameters
iThe row index of the search element.
jThe column index of the search element.
Returns
Iterator to the first index not less then the given index, end() iterator otherwise.

◆ nonZeros() [1/2]

template<typename MT1 , typename MT2 >
size_t blaze::DMatTSMatSchurExpr< MT1, MT2 >::nonZeros ( ) const
inline

Returns the number of non-zero elements in the sparse matrix.

Returns
The number of non-zero elements in the sparse matrix.

◆ nonZeros() [2/2]

template<typename MT1 , typename MT2 >
size_t blaze::DMatTSMatSchurExpr< MT1, MT2 >::nonZeros ( size_t  j) const
inline

Returns the number of non-zero elements in the specified column.

Parameters
jThe index of the column.
Returns
The number of non-zero elements of column j.

◆ operator()()

template<typename MT1 , typename MT2 >
ReturnType blaze::DMatTSMatSchurExpr< MT1, MT2 >::operator() ( size_t  i,
size_t  j 
) const
inline

2D-access to the matrix elements.

Parameters
iAccess index for the row. The index has to be in the range $[0..M-1]$.
jAccess index for the column. The index has to be in the range $[0..N-1]$.
Returns
The resulting value.

◆ operator~() [1/2]

BLAZE_ALWAYS_INLINE constexpr MatrixType& blaze::Matrix< DMatTSMatSchurExpr< MT1, MT2 > , SO >::operator~ ( )
inlinenoexceptinherited

Conversion operator for non-constant matrices.

Returns
Reference of the actual type of the matrix.

◆ operator~() [2/2]

BLAZE_ALWAYS_INLINE constexpr const MatrixType& blaze::Matrix< DMatTSMatSchurExpr< MT1, MT2 > , SO >::operator~ ( ) const
inlinenoexceptinherited

Conversion operator for constant matrices.

Returns
Constant reference of the actual type of the matrix.

◆ rightOperand()

template<typename MT1 , typename MT2 >
RightOperand blaze::DMatTSMatSchurExpr< MT1, MT2 >::rightOperand ( ) const
inlinenoexcept

Returns the right-hand side transpose sparse matrix operand.

Returns
The right-hand side transpose sparse matrix operand.

◆ rows()

template<typename MT1 , typename MT2 >
size_t blaze::DMatTSMatSchurExpr< MT1, MT2 >::rows ( ) const
inlinenoexcept

Returns the current number of rows of the matrix.

Returns
The number of rows of the matrix.

◆ upperBound()

template<typename MT1 , typename MT2 >
ConstIterator blaze::DMatTSMatSchurExpr< MT1, MT2 >::upperBound ( size_t  i,
size_t  j 
) const
inline

Returns an iterator to the first index greater then the given index.

Parameters
iThe row index of the search element.
jThe column index of the search element.
Returns
Iterator to the first index greater then the given index, end() iterator otherwise.

Member Data Documentation

◆ returnExpr

template<typename MT1 , typename MT2 >
constexpr bool blaze::DMatTSMatSchurExpr< MT1, MT2 >::returnExpr = ( !IsTemporary_v<RN1> && !IsTemporary_v<RN2> )
staticprivate

Compilation switch for the selection of the subscript operator return type.

The returnExpr compile time constant expression is a compilation switch for the selection of the ReturnType. If either matrix operand returns a temporary vector or matrix, returnExpr will be set to false and the subscript operator will return it's result by value. Otherwise returnExpr will be set to true and the subscript operator may return it's result as an expression.

◆ useAssign

template<typename MT1 , typename MT2 >
constexpr bool blaze::DMatTSMatSchurExpr< MT1, MT2 >::useAssign = ( RequiresEvaluation_v<MT1> || RequiresEvaluation_v<MT2> )
staticprivate

Compilation switch for the evaluation strategy of the Schur product expression.

The useAssign compile time constant expression represents a compilation switch for the evaluation strategy of the Schur product expression. In case either the dense or the sparse matrix operand requires an intermediate evaluation, useAssign will be set to true and the Schur product expression will be evaluated via the assign function family. Otherwise useAssign will be set to false and the expression will be evaluated via the function call operator.


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