dash::SizeSpec< NumDimensions, SizeType > Class Template Reference

Specifies cartesian extents in a specific number of dimensions. More...

#include <Cartesian.h>

Public Types
typedef IndexType	index_type
typedef SizeType	size_type
typedef std::array< SizeType, NumDimensions >	extents_type
typedef std::integral_constant< dim_t, NumDimensions >	ndim
	The number of dimension in the cartesian space. More...

Public Member Functions
constexpr	SizeSpec ()
	Default constructor, creates a space of extent 0 in all dimensions. More...
template<typename... Args>
constexpr	SizeSpec (SizeType arg, Args... args)
	Constructor, creates a cartesian space of given extents. More...
constexpr	SizeSpec (const ::std::array< SizeType, NumDimensions > &extents)
	Constructor, creates a cartesian index space of given extents in all dimensions. More...
bool	operator== (const self_t &other) const
	Equality comparison operator. More...
constexpr bool	operator!= (const self_t &other) const
	Inequality comparison operator. More...
template<typename... Args>
void	resize (SizeType arg, Args... args)
	Change the extent of the cartesian space in every dimension. More...
template<typename SizeType_ >
void	resize (const std::array< SizeType_, NumDimensions > &extents)
	Change the extent of the cartesian space in every dimension. More...
void	resize (dim_t dim, SizeType extent)
	Change the extent of the cartesian space in the given dimension. More...
constexpr dim_t	rank () const noexcept
	The number of dimension in the cartesian space with extent greater than 1. More...
constexpr SizeType	size () const noexcept
	The number of discrete elements within the space spanned by the coordinate. More...
constexpr const extents_type &	extents () const noexcept
	Extents of the cartesian space, by dimension. More...
SizeType	extent (dim_t dim) const
	The extent of the cartesian space in the given dimension. More...

Detailed Description

template<dim_t NumDimensions, typename SizeType = dash::default_size_t>
class dash::SizeSpec< NumDimensions, SizeType >

Specifies cartesian extents in a specific number of dimensions.

(DashCartesianSpaceConcept)

Examples:

ex.06.pattern-block-visualizer/main.cpp, ex.10.radixsort/main.cpp, ex.11.halo-stencil/main.cpp, and ex.11.simple-stencil/main.cpp.

Definition at line 197 of file Cartesian.h.

Member Typedef Documentation

ndim

template<dim_t NumDimensions, typename SizeType = dash::default_size_t>

typedef std::integral_constant<dim_t, NumDimensions> dash::CartesianSpace< NumDimensions, SizeType >::ndim

inherited

The number of dimension in the cartesian space.

Definition at line 57 of file Cartesian.h.

Constructor & Destructor Documentation

SizeSpec() [1/3]

template<dim_t NumDimensions, typename SizeType = dash::default_size_t>

constexpr dash::SizeSpec< NumDimensions, SizeType >::SizeSpec ( )

inline

Default constructor, creates a space of extent 0 in all dimensions.

Definition at line 207 of file Cartesian.h.

                       : parent_t() {
  }

SizeSpec() [2/3]

template<dim_t NumDimensions, typename SizeType = dash::default_size_t>

template<typename... Args>

constexpr dash::SizeSpec< NumDimensions, SizeType >::SizeSpec ( SizeType  arg, Args...  args  )

inline

Constructor, creates a cartesian space of given extents.

Definition at line 214 of file Cartesian.h.

  : parent_t(arg, args...) {
  }

SizeSpec() [3/3]

template<dim_t NumDimensions, typename SizeType = dash::default_size_t>

constexpr dash::SizeSpec< NumDimensions, SizeType >::SizeSpec ( const ::std::array< SizeType, NumDimensions > &  extents )

inline

Constructor, creates a cartesian index space of given extents in all dimensions.

Definition at line 222 of file Cartesian.h.

  : parent_t(extents) {
  }

Member Function Documentation

extent()

template<dim_t NumDimensions, typename SizeType = dash::default_size_t>

SizeType dash::CartesianSpace< NumDimensions, SizeType >::extent ( dim_t  dim ) const

inlineinherited

The extent of the cartesian space in the given dimension.

Parameters

dim	The dimension in the coordinate

Returns

The extent in the given dimension

Definition at line 181 of file Cartesian.h.

Referenced by dash::ShiftTilePattern< NumDimensions, Arrangement, IndexType >::ndim(), dash::SeqTilePattern< NumDimensions, Arrangement, IndexType >::ndim(), dash::CartesianSpace< NumDimensions, SizeType >::resize(), dash::CartesianIndexSpace< NumDimensions, ROW_MAJOR, dash::default_index_t >::resize(), dash::BlockPattern< 1, ROW_MAJOR, dash::default_index_t >::underfilled_blocksize(), and dash::TilePattern< NumDimensions, Arrangement, IndexType >::underfilled_blocksize().

                                   {
    DASH_ASSERT_RANGE(
      0, dim, NumDimensions-1,
      "Dimension for CartesianSpace::extent(dim) is out of bounds");
    return _extents[dim];
  }

extents()

template<dim_t NumDimensions, typename SizeType = dash::default_size_t>

constexpr const extents_type& dash::CartesianSpace< NumDimensions, SizeType >::extents ( ) const

inlinenoexceptinherited

Extents of the cartesian space, by dimension.

Definition at line 171 of file Cartesian.h.

Referenced by dash::LocalMemoryLayout< NumDimensions, Arrangement, IndexType >::coords(), dash::ShiftTilePattern< NumDimensions, Arrangement, IndexType >::ndim(), dash::SeqTilePattern< NumDimensions, Arrangement, IndexType >::ndim(), dash::CartesianSpace< NumDimensions, SizeType >::resize(), dash::CartesianIndexSpace< NumDimensions, ROW_MAJOR, dash::default_index_t >::resize(), dash::LocalMemoryLayout< NumDimensions, Arrangement, IndexType >::resize(), and dash::TilePattern< NumDimensions, Arrangement, IndexType >::underfilled_blocksize().

                                                          {
    return _extents;
  }

operator!=()

template<dim_t NumDimensions, typename SizeType = dash::default_size_t>

constexpr bool dash::CartesianSpace< NumDimensions, SizeType >::operator!= ( const self_t &  other ) const

inlineinherited

Inequality comparison operator.

Definition at line 108 of file Cartesian.h.

                                                        {
    return !(*this == other);
  }

operator==()

template<dim_t NumDimensions, typename SizeType = dash::default_size_t>

bool dash::CartesianSpace< NumDimensions, SizeType >::operator== ( const self_t &  other ) const

inlineinherited

Equality comparison operator.

Definition at line 92 of file Cartesian.h.

                                              {
    if (this == &other) {
      return true;
    }
    for(auto i = 0; i < NumDimensions; i++) {
      if (_extents[i] != other._extents[i]) {
        return false;
      }
    }
    // No need to compare _size as it is derived from _extents.
    return true;
  }

rank()

template<dim_t NumDimensions, typename SizeType = dash::default_size_t>

constexpr dim_t dash::CartesianSpace< NumDimensions, SizeType >::rank ( ) const

inlinenoexceptinherited

The number of dimension in the cartesian space with extent greater than 1.

See also

ndim

Returns

The number of dimensions in the coordinate

Definition at line 154 of file Cartesian.h.

                                        {
    return _rank;
  }

resize() [1/3]

template<dim_t NumDimensions, typename SizeType = dash::default_size_t>

template<typename... Args>

void dash::CartesianSpace< NumDimensions, SizeType >::resize ( SizeType  arg, Args...  args  )

inlineinherited

Change the extent of the cartesian space in every dimension.

Definition at line 116 of file Cartesian.h.

References dash::CartesianSpace< NumDimensions, SizeType >::extents().

Referenced by dash::CartesianIndexSpace< NumDimensions, ROW_MAJOR, dash::default_index_t >::CartesianIndexSpace(), dash::CartesianSpace< NumDimensions, SizeType >::CartesianSpace(), dash::CartesianSpace< NumDimensions, SizeType >::resize(), dash::CartesianIndexSpace< NumDimensions, ROW_MAJOR, dash::default_index_t >::resize(), and dash::LocalMemoryLayout< NumDimensions, Arrangement, IndexType >::resize().

                                          {
    static_assert(
      sizeof...(Args) == NumDimensions-1,
      "Invalid number of arguments");
    std::array<SizeType, NumDimensions> extents =
      {{ arg, (SizeType)(args)... }};
    resize(extents);
  }

resize() [2/3]

template<dim_t NumDimensions, typename SizeType = dash::default_size_t>

template<typename SizeType_ >

void dash::CartesianSpace< NumDimensions, SizeType >::resize ( const std::array< SizeType_, NumDimensions > &  extents )

inlineinherited

Change the extent of the cartesian space in every dimension.

Definition at line 129 of file Cartesian.h.

                                                                  {
    // Update size:
    _size = 1;
    for(auto i = 0; i < NumDimensions; i++ ) {
      _extents[i] = static_cast<SizeType>(extents[i]);
      _size      *= _extents[i];
    }
  }

resize() [3/3]

template<dim_t NumDimensions, typename SizeType = dash::default_size_t>

void dash::CartesianSpace< NumDimensions, SizeType >::resize ( dim_t  dim, SizeType  extent  )

inlineinherited

Change the extent of the cartesian space in the given dimension.

Definition at line 141 of file Cartesian.h.

References dash::CartesianSpace< NumDimensions, SizeType >::extent(), and dash::CartesianSpace< NumDimensions, SizeType >::resize().

                                          {
    _extents[dim] = extent;
    resize(_extents);
  }

size()

template<dim_t NumDimensions, typename SizeType = dash::default_size_t>

constexpr SizeType dash::CartesianSpace< NumDimensions, SizeType >::size ( ) const

inlinenoexceptinherited

The number of discrete elements within the space spanned by the coordinate.

Returns

The number of discrete elements in the coordinate's space

Definition at line 164 of file Cartesian.h.

Referenced by dash::CartesianIndexSpace< NumDimensions, ROW_MAJOR, dash::default_index_t >::coords(), and dash::TilePattern< NumDimensions, Arrangement, IndexType >::underfilled_blocksize().

                                           {
    return _size;
  }

---

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

• /tmp/tmporruphar/dash/include/dash/Cartesian.h