QUESO::Map Class Reference

A class for partitioning vectors and matrices. More...

#include <Map.h>

Collaboration diagram for QUESO::Map:

Public Member Functions
Constructor/Destructor methods
	Map ()
	Default constructor. Do not call this directly. More...
	Map (int numGlobalElements, int indexBase, const MpiComm &comm)
	Constructor for a uniform linear distribution of elements. More...
	Map (const Map &src)
	Copy constructor. More...
	~Map ()
	Destructor. More...
Set methods
Map &	operator= (const Map &rhs)
	Assignment operator. More...
Size, dimension and local ID accessor methods
int	NumGlobalElements () const
	Returns the total number of elements across all processors. More...
int	IndexBase () const
int	NumMyElements () const
	Returns the number of elements owned by the calling processor. More...
int	MinMyGID () const
	The minimum global index value on the calling processor. More...
Miscellaneous methods
const MpiComm &	Comm () const
	Access function for MpiComm communicator. More...

Private Member Functions
void	copy (const Map &src)
	Copies the map. More...

Private Attributes
MpiComm	m_MpiComm
	This communicator can be queried for processor rank and size information. More...
int	m_numGlobalElements
	Total number of elements across all processors. More...
int	m_indexBase
	Base integer value for indexed array references. More...
int	m_numMyElements
	Number of elements owned by the calling processor. More...

Detailed Description

A class for partitioning vectors and matrices.

It is often the case that multiple matrix and vector objects have an identical distribution of elements on a parallel machine. The Map keeps information that describes this distribution for matrices and vectors. Inspired by Trilinos Epetra_Map class.

Definition at line 49 of file Map.h.

Constructor & Destructor Documentation

QUESO::Map::Map

(

)

Default constructor. Do not call this directly.

Definition at line 34 of file Map.C.

References UQ_FATAL_TEST_MACRO, and QUESO::UQ_UNAVAILABLE_RANK.

  :
  m_MpiComm() // *(new MpiComm()) )
{
  UQ_FATAL_TEST_MACRO(true,
                      UQ_UNAVAILABLE_RANK,
                      "Map::constructor()",
                      "should not be called");
}

QUESO::Map::Map	(	int	numGlobalElements,
		int	indexBase,
		const MpiComm &	comm
	)

Constructor for a uniform linear distribution of elements.

Definition at line 45 of file Map.C.

  :
  m_MpiComm        (comm),
#ifdef QUESO_HAS_TRILINOS
  m_epetraMap        ( new Epetra_Map(numGlobalElements,0,comm.epetraMpiComm()) )
#else
  m_numGlobalElements(numGlobalElements),
  m_indexBase        (indexBase),
  m_numMyElements    (numGlobalElements)
#endif
{
}

QUESO::Map::Map

(

const Map &

src

)

Copy constructor.

Definition at line 62 of file Map.C.

References copy().

  :
  m_MpiComm(src.m_MpiComm)
#ifdef QUESO_HAS_TRILINOS
  ,
  m_epetraMap(NULL)
#endif
{
  this->copy(src);
}

QUESO::Map::~Map

(

)

Destructor.

Definition at line 74 of file Map.C.

{
#ifdef QUESO_HAS_TRILINOS
  delete m_epetraMap;
  m_epetraMap = NULL;
#else
  // Nothing to do
#endif
}

Member Function Documentation

const MpiComm & QUESO::Map::Comm

(

)

const

Access function for MpiComm communicator.

Definition at line 142 of file Map.C.

References m_MpiComm.

Referenced by QUESO::Matrix::numOfProcsForStorage(), and QUESO::Vector::numOfProcsForStorage().

{
  return m_MpiComm;
}

void QUESO::Map::copy ( const Map &  src )

private

Copies the map.

Definition at line 157 of file Map.C.

References m_indexBase, m_MpiComm, m_numGlobalElements, and m_numMyElements.

Referenced by Map(), and operator=().

{
  m_MpiComm         = src.m_MpiComm;
#ifdef QUESO_HAS_TRILINOS
  delete m_epetraMap;
  m_epetraMap         = new Epetra_Map(*src.m_epetraMap);
#else
  m_numGlobalElements = src.m_numGlobalElements;
  m_indexBase         = src.m_indexBase;
  m_numMyElements     = src.m_numMyElements;
#endif

  return;
}

int QUESO::Map::IndexBase

(

)

const

Returns the base integer value for indexed array references. The first position in the global processor in my processors.

Definition at line 107 of file Map.C.

References m_indexBase.

{
#ifdef QUESO_HAS_TRILINOS
  return m_epetraMap->IndexBase();
#else
  return m_indexBase;
#endif
}

int QUESO::Map::MinMyGID

(

)

const

The minimum global index value on the calling processor.

Definition at line 129 of file Map.C.

{
#ifdef QUESO_HAS_TRILINOS
  return m_epetraMap->MinMyGID();
#else
  return 0;
#endif
}

int QUESO::Map::NumGlobalElements

(

)

const

Returns the total number of elements across all processors.

Definition at line 96 of file Map.C.

References m_numGlobalElements.

Referenced by QUESO::DistArray< T >::DistArray(), QUESO::GslVector::GslVector(), QUESO::GslVector::sizeGlobal(), and QUESO::VectorSpace< V, M >::VectorSpace().

{
#ifdef QUESO_HAS_TRILINOS
  return m_epetraMap->NumGlobalElements();
#else
  return m_numGlobalElements;
#endif
}

int QUESO::Map::NumMyElements

(

)

const

Returns the number of elements owned by the calling processor.

Definition at line 118 of file Map.C.

References m_numMyElements.

Referenced by QUESO::GslVector::GslVector(), and QUESO::GslVector::sizeLocal().

{
#ifdef QUESO_HAS_TRILINOS
  return m_epetraMap->NumMyElements();
#else
  return m_numMyElements;
#endif
}

Map & QUESO::Map::operator=

(

const Map &

rhs

)

Assignment operator.

Definition at line 87 of file Map.C.

References copy().

{
  this->copy(rhs);
  return *this;
}

Member Data Documentation

int QUESO::Map::m_indexBase

private

Base integer value for indexed array references.

Definition at line 119 of file Map.h.

Referenced by copy(), and IndexBase().

MpiComm QUESO::Map::m_MpiComm

private

This communicator can be queried for processor rank and size information.

Definition at line 109 of file Map.h.

Referenced by Comm(), and copy().

int QUESO::Map::m_numGlobalElements

private

Total number of elements across all processors.

Definition at line 116 of file Map.h.

Referenced by copy(), and NumGlobalElements().

int QUESO::Map::m_numMyElements

private

Number of elements owned by the calling processor.

Definition at line 122 of file Map.h.

Referenced by copy(), and NumMyElements().

---

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

• src/core/inc/Map.h
• src/core/src/Map.C