dune-common  2.11
Public Types | Public Member Functions | Static Public Attributes | Protected Member Functions | Related Functions | List of all members
Dune::DenseVector< V > Class Template Reference

Interface for a class of dense vectors over a given field. More...

#include <dune/common/densevector.hh>

Inheritance diagram for Dune::DenseVector< V >:
Inheritance graph

Public Types

typedef Traits::derived_type derived_type
 type of derived vector class More...
 
typedef Traits::value_type value_type
 export the type representing the field More...
 
typedef FieldTraits< value_type >::field_type field_type
 export the type representing the field More...
 
typedef Traits::value_type block_type
 export the type representing the components More...
 
typedef Traits::size_type size_type
 The type used for the index access and size operation. More...
 
typedef DenseIterator< DenseVector, value_typeIterator
 Iterator class for sequential access. More...
 
typedef Iterator iterator
 typedef for stl compliant access More...
 
typedef DenseIterator< const DenseVector, const value_typeConstIterator
 ConstIterator class for sequential access. More...
 
typedef ConstIterator const_iterator
 typedef for stl compliant access More...
 

Public Member Functions

constexpr derived_typeoperator= (const value_type &k)
 Assignment operator for scalar. More...
 
template<typename W , std::enable_if_t< std::is_assignable< value_type &, typename DenseVector< W >::value_type >::value, int > = 0>
constexpr derived_typeoperator= (const DenseVector< W > &other)
 Assignment operator for other DenseVector of different type. More...
 
constexpr value_typeoperator[] (size_type i)
 random access More...
 
constexpr const value_typeoperator[] (size_type i) const
 
constexpr value_typefront ()
 return reference to first element More...
 
constexpr const value_typefront () const
 return reference to first element More...
 
constexpr value_typeback ()
 return reference to last element More...
 
constexpr const value_typeback () const
 return reference to last element More...
 
constexpr bool empty () const
 checks whether the container is empty More...
 
constexpr size_type size () const
 size method More...
 
constexpr Iterator begin ()
 begin iterator More...
 
constexpr Iterator end ()
 end iterator More...
 
constexpr Iterator beforeEnd ()
 
constexpr Iterator beforeBegin ()
 
constexpr Iterator find (size_type i)
 return iterator to given element or end() More...
 
constexpr ConstIterator begin () const
 begin ConstIterator More...
 
constexpr ConstIterator end () const
 end ConstIterator More...
 
constexpr ConstIterator beforeEnd () const
 
constexpr ConstIterator beforeBegin () const
 
constexpr ConstIterator find (size_type i) const
 return iterator to given element or end() More...
 
template<class Other >
constexpr derived_typeoperator+= (const DenseVector< Other > &x)
 vector space addition More...
 
template<class Other >
constexpr derived_typeoperator-= (const DenseVector< Other > &x)
 vector space subtraction More...
 
template<class Other >
constexpr derived_type operator+ (const DenseVector< Other > &b) const
 Binary vector addition. More...
 
template<class Other >
constexpr derived_type operator- (const DenseVector< Other > &b) const
 Binary vector subtraction. More...
 
constexpr derived_type operator- () const
 Vector negation. More...
 
template<typename ValueType >
constexpr std::enable_if< std::is_convertible< ValueType, value_type >::value, derived_type >::type & operator+= (const ValueType &kk)
 vector space add scalar to all comps More...
 
template<typename ValueType >
constexpr std::enable_if< std::is_convertible< ValueType, value_type >::value, derived_type >::type & operator-= (const ValueType &kk)
 vector space subtract scalar from all comps More...
 
template<typename FieldType >
constexpr std::enable_if< std::is_convertible< FieldType, field_type >::value, derived_type >::type & operator*= (const FieldType &kk)
 vector space multiplication with scalar More...
 
template<typename FieldType >
constexpr std::enable_if< std::is_convertible< FieldType, field_type >::value, derived_type >::type & operator/= (const FieldType &kk)
 vector space division by scalar More...
 
template<class Other >
constexpr bool operator== (const DenseVector< Other > &x) const
 Binary vector comparison. More...
 
template<class Other >
constexpr bool operator!= (const DenseVector< Other > &x) const
 Binary vector incomparison. More...
 
template<class Other >
constexpr derived_typeaxpy (const field_type &a, const DenseVector< Other > &x)
 vector space axpy operation ( *this += a x ) More...
 
template<class Other >
constexpr PromotionTraits< field_type, typename DenseVector< Other >::field_type >::PromotedType operator* (const DenseVector< Other > &x) const
 indefinite vector dot product $\left (x^T \cdot y \right)$ which corresponds to Petsc's VecTDot More...
 
template<class Other >
constexpr PromotionTraits< field_type, typename DenseVector< Other >::field_type >::PromotedType dot (const DenseVector< Other > &x) const
 vector dot product $\left (x^H \cdot y \right)$ which corresponds to Petsc's VecDot More...
 
constexpr FieldTraits< value_type >::real_type one_norm () const
 one norm (sum over absolute values of entries) More...
 
constexpr FieldTraits< value_type >::real_type one_norm_real () const
 simplified one norm (uses Manhattan norm for complex values) More...
 
constexpr FieldTraits< value_type >::real_type two_norm () const
 two norm sqrt(sum over squared values of entries) More...
 
constexpr FieldTraits< value_type >::real_type two_norm2 () const
 square of two norm (sum over squared values of entries), need for block recursion More...
 
template<typename vt = value_type, typename std::enable_if<!HasNaN< vt >::value, int >::type = 0>
constexpr FieldTraits< vt >::real_type infinity_norm () const
 infinity norm (maximum of absolute values of entries) More...
 
template<typename vt = value_type, typename std::enable_if<!HasNaN< vt >::value, int >::type = 0>
constexpr FieldTraits< vt >::real_type infinity_norm_real () const
 simplified infinity norm (uses Manhattan norm for complex values) More...
 
template<typename vt = value_type, typename std::enable_if< HasNaN< vt >::value, int >::type = 0>
constexpr FieldTraits< vt >::real_type infinity_norm () const
 infinity norm (maximum of absolute values of entries) More...
 
template<typename vt = value_type, typename std::enable_if< HasNaN< vt >::value, int >::type = 0>
constexpr FieldTraits< vt >::real_type infinity_norm_real () const
 simplified infinity norm (uses Manhattan norm for complex values) More...
 
constexpr size_type N () const
 number of blocks in the vector (are of size 1 here) More...
 
constexpr size_type dim () const
 dimension of the vector space More...
 

Static Public Attributes

static constexpr int blocklevel = 1
 The number of block levels we contain. This is the leaf, that is, 1. More...
 

Protected Member Functions

constexpr DenseVector ()=default
 
constexpr DenseVector (const DenseVector &)=default
 
constexpr DenseVectoroperator= (const DenseVector &)=default
 Assignment operator for other DenseVector of same type. More...
 

Related Functions

(Note that these are not member functions.)

template<typename V >
std::ostream & operator<< (std::ostream &s, const DenseVector< V > &v)
 Write a DenseVector to an output stream. More...
 

Detailed Description

template<typename V>
class Dune::DenseVector< V >

Interface for a class of dense vectors over a given field.

Template Parameters
Vimplementation class of the vector

Member Typedef Documentation

◆ block_type

template<typename V>
typedef Traits::value_type Dune::DenseVector< V >::block_type

export the type representing the components

◆ const_iterator

template<typename V>
typedef ConstIterator Dune::DenseVector< V >::const_iterator

typedef for stl compliant access

◆ ConstIterator

template<typename V>
typedef DenseIterator<const DenseVector,const value_type> Dune::DenseVector< V >::ConstIterator

ConstIterator class for sequential access.

◆ derived_type

template<typename V>
typedef Traits::derived_type Dune::DenseVector< V >::derived_type

type of derived vector class

◆ field_type

template<typename V>
typedef FieldTraits< value_type >::field_type Dune::DenseVector< V >::field_type

export the type representing the field

◆ Iterator

template<typename V>
typedef DenseIterator<DenseVector,value_type> Dune::DenseVector< V >::Iterator

Iterator class for sequential access.

◆ iterator

template<typename V>
typedef Iterator Dune::DenseVector< V >::iterator

typedef for stl compliant access

◆ size_type

template<typename V>
typedef Traits::size_type Dune::DenseVector< V >::size_type

The type used for the index access and size operation.

◆ value_type

template<typename V>
typedef Traits::value_type Dune::DenseVector< V >::value_type

export the type representing the field

Constructor & Destructor Documentation

◆ DenseVector() [1/2]

template<typename V>
constexpr Dune::DenseVector< V >::DenseVector ( )
protecteddefault

◆ DenseVector() [2/2]

template<typename V>
constexpr Dune::DenseVector< V >::DenseVector ( const DenseVector< V > &  )
protecteddefault

Member Function Documentation

◆ axpy()

template<typename V>
template<class Other >
constexpr derived_type& Dune::DenseVector< V >::axpy ( const field_type a,
const DenseVector< Other > &  x 
)
inline

vector space axpy operation ( *this += a x )

◆ back() [1/2]

template<typename V>
constexpr value_type& Dune::DenseVector< V >::back ( )
inline

return reference to last element

◆ back() [2/2]

template<typename V>
constexpr const value_type& Dune::DenseVector< V >::back ( ) const
inline

return reference to last element

◆ beforeBegin() [1/2]

template<typename V>
constexpr Iterator Dune::DenseVector< V >::beforeBegin ( )
inline
Returns
an iterator that is positioned before the first entry of the vector.

◆ beforeBegin() [2/2]

template<typename V>
constexpr ConstIterator Dune::DenseVector< V >::beforeBegin ( ) const
inline
Returns
an iterator that is positioned before the first entry of the vector.

◆ beforeEnd() [1/2]

template<typename V>
constexpr Iterator Dune::DenseVector< V >::beforeEnd ( )
inline
Returns
an iterator that is positioned before the end iterator of the vector, i.e. at the last entry.

◆ beforeEnd() [2/2]

template<typename V>
constexpr ConstIterator Dune::DenseVector< V >::beforeEnd ( ) const
inline
Returns
an iterator that is positioned before the end iterator of the vector. i.e. at the last element

◆ begin() [1/2]

template<typename V>
constexpr Iterator Dune::DenseVector< V >::begin ( )
inline

begin iterator

◆ begin() [2/2]

template<typename V>
constexpr ConstIterator Dune::DenseVector< V >::begin ( ) const
inline

begin ConstIterator

◆ dim()

template<typename V>
constexpr size_type Dune::DenseVector< V >::dim ( ) const
inline

dimension of the vector space

◆ dot()

template<typename V>
template<class Other >
constexpr PromotionTraits<field_type,typename DenseVector<Other>::field_type>::PromotedType Dune::DenseVector< V >::dot ( const DenseVector< Other > &  x) const
inline

vector dot product $\left (x^H \cdot y \right)$ which corresponds to Petsc's VecDot

http://www.mcs.anl.gov/petsc/petsc-current/docs/manualpages/Vec/VecDot.html

Parameters
xother vector
Returns

◆ empty()

template<typename V>
constexpr bool Dune::DenseVector< V >::empty ( ) const
inline

checks whether the container is empty

◆ end() [1/2]

template<typename V>
constexpr Iterator Dune::DenseVector< V >::end ( )
inline

end iterator

◆ end() [2/2]

template<typename V>
constexpr ConstIterator Dune::DenseVector< V >::end ( ) const
inline

end ConstIterator

◆ find() [1/2]

template<typename V>
constexpr Iterator Dune::DenseVector< V >::find ( size_type  i)
inline

return iterator to given element or end()

◆ find() [2/2]

template<typename V>
constexpr ConstIterator Dune::DenseVector< V >::find ( size_type  i) const
inline

return iterator to given element or end()

◆ front() [1/2]

template<typename V>
constexpr value_type& Dune::DenseVector< V >::front ( )
inline

return reference to first element

◆ front() [2/2]

template<typename V>
constexpr const value_type& Dune::DenseVector< V >::front ( ) const
inline

return reference to first element

◆ infinity_norm() [1/2]

template<typename V>
template<typename vt = value_type, typename std::enable_if<!HasNaN< vt >::value, int >::type = 0>
constexpr FieldTraits<vt>::real_type Dune::DenseVector< V >::infinity_norm ( ) const
inline

infinity norm (maximum of absolute values of entries)

◆ infinity_norm() [2/2]

template<typename V>
template<typename vt = value_type, typename std::enable_if< HasNaN< vt >::value, int >::type = 0>
constexpr FieldTraits<vt>::real_type Dune::DenseVector< V >::infinity_norm ( ) const
inline

infinity norm (maximum of absolute values of entries)

◆ infinity_norm_real() [1/2]

template<typename V>
template<typename vt = value_type, typename std::enable_if<!HasNaN< vt >::value, int >::type = 0>
constexpr FieldTraits<vt>::real_type Dune::DenseVector< V >::infinity_norm_real ( ) const
inline

simplified infinity norm (uses Manhattan norm for complex values)

◆ infinity_norm_real() [2/2]

template<typename V>
template<typename vt = value_type, typename std::enable_if< HasNaN< vt >::value, int >::type = 0>
constexpr FieldTraits<vt>::real_type Dune::DenseVector< V >::infinity_norm_real ( ) const
inline

simplified infinity norm (uses Manhattan norm for complex values)

◆ N()

template<typename V>
constexpr size_type Dune::DenseVector< V >::N ( ) const
inline

number of blocks in the vector (are of size 1 here)

◆ one_norm()

template<typename V>
constexpr FieldTraits<value_type>::real_type Dune::DenseVector< V >::one_norm ( ) const
inline

one norm (sum over absolute values of entries)

◆ one_norm_real()

template<typename V>
constexpr FieldTraits<value_type>::real_type Dune::DenseVector< V >::one_norm_real ( ) const
inline

simplified one norm (uses Manhattan norm for complex values)

◆ operator!=()

template<typename V>
template<class Other >
constexpr bool Dune::DenseVector< V >::operator!= ( const DenseVector< Other > &  x) const
inline

Binary vector incomparison.

◆ operator*()

template<typename V>
template<class Other >
constexpr PromotionTraits<field_type,typename DenseVector<Other>::field_type>::PromotedType Dune::DenseVector< V >::operator* ( const DenseVector< Other > &  x) const
inline

indefinite vector dot product $\left (x^T \cdot y \right)$ which corresponds to Petsc's VecTDot

http://www.mcs.anl.gov/petsc/petsc-current/docs/manualpages/Vec/VecTDot.html

Parameters
xother vector
Returns

◆ operator*=()

template<typename V>
template<typename FieldType >
constexpr std::enable_if< std::is_convertible<FieldType, field_type>::value, derived_type >::type& Dune::DenseVector< V >::operator*= ( const FieldType &  kk)
inline

vector space multiplication with scalar

we use enable_if to avoid an ambiguity, if the function parameter can be converted to field_type implicitly. (see FS#1457)

The function is only enabled, if the parameter is directly convertible to field_type.

◆ operator+()

template<typename V>
template<class Other >
constexpr derived_type Dune::DenseVector< V >::operator+ ( const DenseVector< Other > &  b) const
inline

Binary vector addition.

◆ operator+=() [1/2]

template<typename V>
template<class Other >
constexpr derived_type& Dune::DenseVector< V >::operator+= ( const DenseVector< Other > &  x)
inline

vector space addition

◆ operator+=() [2/2]

template<typename V>
template<typename ValueType >
constexpr std::enable_if< std::is_convertible<ValueType, value_type>::value, derived_type >::type& Dune::DenseVector< V >::operator+= ( const ValueType &  kk)
inline

vector space add scalar to all comps

we use enable_if to avoid an ambiguity, if the function parameter can be converted to value_type implicitly. (see FS#1457)

The function is only enabled, if the parameter is directly convertible to value_type.

◆ operator-() [1/2]

template<typename V>
template<class Other >
constexpr derived_type Dune::DenseVector< V >::operator- ( const DenseVector< Other > &  b) const
inline

Binary vector subtraction.

◆ operator-() [2/2]

template<typename V>
constexpr derived_type Dune::DenseVector< V >::operator- ( ) const
inline

Vector negation.

◆ operator-=() [1/2]

template<typename V>
template<class Other >
constexpr derived_type& Dune::DenseVector< V >::operator-= ( const DenseVector< Other > &  x)
inline

vector space subtraction

◆ operator-=() [2/2]

template<typename V>
template<typename ValueType >
constexpr std::enable_if< std::is_convertible<ValueType, value_type>::value, derived_type >::type& Dune::DenseVector< V >::operator-= ( const ValueType &  kk)
inline

vector space subtract scalar from all comps

we use enable_if to avoid an ambiguity, if the function parameter can be converted to value_type implicitly. (see FS#1457)

The function is only enabled, if the parameter is directly convertible to value_type.

◆ operator/=()

template<typename V>
template<typename FieldType >
constexpr std::enable_if< std::is_convertible<FieldType, field_type>::value, derived_type >::type& Dune::DenseVector< V >::operator/= ( const FieldType &  kk)
inline

vector space division by scalar

we use enable_if to avoid an ambiguity, if the function parameter can be converted to field_type implicitly. (see FS#1457)

The function is only enabled, if the parameter is directly convertible to field_type.

◆ operator=() [1/3]

template<typename V>
constexpr derived_type& Dune::DenseVector< V >::operator= ( const value_type k)
inline

Assignment operator for scalar.

◆ operator=() [2/3]

template<typename V>
constexpr DenseVector& Dune::DenseVector< V >::operator= ( const DenseVector< V > &  )
protecteddefault

Assignment operator for other DenseVector of same type.

◆ operator=() [3/3]

template<typename V>
template<typename W , std::enable_if_t< std::is_assignable< value_type &, typename DenseVector< W >::value_type >::value, int > = 0>
constexpr derived_type& Dune::DenseVector< V >::operator= ( const DenseVector< W > &  other)
inline

Assignment operator for other DenseVector of different type.

◆ operator==()

template<typename V>
template<class Other >
constexpr bool Dune::DenseVector< V >::operator== ( const DenseVector< Other > &  x) const
inline

Binary vector comparison.

◆ operator[]() [1/2]

template<typename V>
constexpr value_type& Dune::DenseVector< V >::operator[] ( size_type  i)
inline

random access

◆ operator[]() [2/2]

template<typename V>
constexpr const value_type& Dune::DenseVector< V >::operator[] ( size_type  i) const
inline

◆ size()

template<typename V>
constexpr size_type Dune::DenseVector< V >::size ( ) const
inline

size method

◆ two_norm()

template<typename V>
constexpr FieldTraits<value_type>::real_type Dune::DenseVector< V >::two_norm ( ) const
inline

two norm sqrt(sum over squared values of entries)

◆ two_norm2()

template<typename V>
constexpr FieldTraits<value_type>::real_type Dune::DenseVector< V >::two_norm2 ( ) const
inline

square of two norm (sum over squared values of entries), need for block recursion

Member Data Documentation

◆ blocklevel

template<typename V>
constexpr int Dune::DenseVector< V >::blocklevel = 1
static

The number of block levels we contain. This is the leaf, that is, 1.


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