Epetra_DistObject: A class for constructing and using dense multi-vectors, vectors and matrices in parallel. More...

#include <Epetra_DistObject.h>

Inheritance diagram for Epetra_DistObject:

Protected Attributes
Epetra_BlockMap	Map_

const Epetra_Comm *	Comm_

char *	Exports_

char *	Imports_

int	LenExports_

int	LenImports_

int *	Sizes_

Private Member Functions
Epetra_DistObject &	operator= (const Epetra_DistObject &src)

Constructors/Destructor
	Epetra_DistObject (const Epetra_BlockMap &Map)
	Basic Epetra_DistObject constuctor. More...

	Epetra_DistObject (const Epetra_BlockMap &Map, const char *const Label)

	Epetra_DistObject (const Epetra_DistObject &Source)
	Epetra_DistObject copy constructor. More...

virtual	~Epetra_DistObject ()
	Epetra_DistObject destructor. More...

Import/Export Methods
int	Import (const Epetra_SrcDistObject &A, const Epetra_Import &Importer, Epetra_CombineMode CombineMode, const Epetra_OffsetIndex *Indexor=0)
	Imports an Epetra_DistObject using the Epetra_Import object. More...

int	Import (const Epetra_SrcDistObject &A, const Epetra_Export &Exporter, Epetra_CombineMode CombineMode, const Epetra_OffsetIndex *Indexor=0)
	Imports an Epetra_DistObject using the Epetra_Export object. More...

int	Export (const Epetra_SrcDistObject &A, const Epetra_Import &Importer, Epetra_CombineMode CombineMode, const Epetra_OffsetIndex *Indexor=0)
	Exports an Epetra_DistObject using the Epetra_Import object. More...

int	Export (const Epetra_SrcDistObject &A, const Epetra_Export &Exporter, Epetra_CombineMode CombineMode, const Epetra_OffsetIndex *Indexor=0)
	Exports an Epetra_DistObject using the Epetra_Export object. More...

Attribute accessor methods
const Epetra_BlockMap &	Map () const
	Returns the address of the Epetra_BlockMap for this multi-vector. More...

const Epetra_Comm &	Comm () const
	Returns the address of the Epetra_Comm for this multi-vector. More...

bool	DistributedGlobal () const
	Returns true if this multi-vector is distributed global, i.e., not local replicated. More...

Miscellaneous
virtual void	Print (std::ostream &os) const
	Print method. More...

Internal utilities
virtual int	DoTransfer (const Epetra_SrcDistObject &A, Epetra_CombineMode CombineMode, int NumSameIDs, int NumPermuteIDs, int NumRemoteIDs, int NumExportIDs, int PermuteToLIDs, int PermuteFromLIDs, int RemoteLIDs, int ExportLIDs, int &LenExports, char &Exports, int &LenImports, char &Imports, Epetra_Distributor &Distor, bool DoReverse, const Epetra_OffsetIndex *Indexor)
	Perform actual transfer (redistribution) of data across memory images, using Epetra_Distributor object. More...

Virtual methods to be implemented by derived class
virtual int	CheckSizes (const Epetra_SrcDistObject &Source)=0
	Allows the source and target (this) objects to be compared for compatibility, return nonzero if not. More...

virtual int	CopyAndPermute (const Epetra_SrcDistObject &Source, int NumSameIDs, int NumPermuteIDs, int PermuteToLIDs, int PermuteFromLIDs, const Epetra_OffsetIndex *Indexor, Epetra_CombineMode CombineMode=Zero)=0
	Perform ID copies and permutations that are on processor. More...

virtual int	PackAndPrepare (const Epetra_SrcDistObject &Source, int NumExportIDs, int ExportLIDs, int &LenExports, char &Exports, int &SizeOfPacket, int *Sizes, bool &VarSizes, Epetra_Distributor &Distor)=0
	Perform any packing or preparation required for call to DoTransfer(). More...

virtual int	UnpackAndCombine (const Epetra_SrcDistObject &Source, int NumImportIDs, int ImportLIDs, int LenImports, char Imports, int &SizeOfPacket, Epetra_Distributor &Distor, Epetra_CombineMode CombineMode, const Epetra_OffsetIndex *Indexor)=0
	Perform any unpacking and combining after call to DoTransfer(). More...

Additional Inherited Members
Public Member Functions inherited from Epetra_Object
	Epetra_Object (int TracebackModeIn=-1, bool set_label=true)
	Epetra_Object Constructor. More...

	Epetra_Object (const char *const Label, int TracebackModeIn=-1)
	Epetra_Object Constructor. More...

	Epetra_Object (const Epetra_Object &Object)
	Epetra_Object Copy Constructor. More...

virtual	~Epetra_Object ()
	Epetra_Object Destructor. More...

virtual void	SetLabel (const char *const Label)
	Epetra_Object Label definition using char *. More...

virtual const char *	Label () const
	Epetra_Object Label access funtion. More...

virtual int	ReportError (const std::string Message, int ErrorCode) const
	Error reporting method. More...

Public Member Functions inherited from Epetra_SrcDistObject
virtual	~Epetra_SrcDistObject ()
	Epetra_SrcDistObject destructor. More...

Static Public Member Functions inherited from Epetra_Object
static void	SetTracebackMode (int TracebackModeValue)
	Set the value of the Epetra_Object error traceback report mode. More...

static int	GetTracebackMode ()
	Get the value of the Epetra_Object error report mode. More...

static std::ostream &	GetTracebackStream ()
	Get the output stream for error reporting. More...

Static Public Attributes inherited from Epetra_Object
static int	TracebackMode

Protected Member Functions inherited from Epetra_Object
std::string	toString (const int &x) const

std::string	toString (const long long &x) const

std::string	toString (const double &x) const

Detailed Description

Epetra_DistObject: A class for constructing and using dense multi-vectors, vectors and matrices in parallel.

The Epetra_DistObject is a base class for all Epetra distributed global objects.  It provides the basic
mechanisms and interface specifications for importing and exporting operations using Epetra_Import and
Epetra_Export objects.

Distributed Global vs. Replicated Local.

Distributed Global objects - In most instances, a distributed object will be partitioned across multiple memory images associated with multiple processors. In this case, there is a unique copy of each element and elements are spread across all processors specified by the Epetra_Comm communicator.
Replicated Local Objects - Some algorithms use objects that are too small to be distributed across all processors, the Hessenberg matrix in a GMRES computation. In other cases, such as with block iterative methods, block dot product functions produce small dense matrices that are required by all processors. Replicated local objectss handle these types of situation.

Definition at line 88 of file Epetra_DistObject.h.

Constructor & Destructor Documentation

Epetra_DistObject::Epetra_DistObject ( const Epetra_BlockMap & Map )

Basic Epetra_DistObject constuctor.

Creates a Epetra_DistObject object.

Parameters

In	Map - A Epetra_LocalMap, Epetra_Map or Epetra_BlockMap.

Warning: Note that, because Epetra_LocalMap derives from Epetra_Map and Epetra_Map derives from Epetra_BlockMap, this constructor works for all three types of Epetra map classes.

Returns: Pointer to a Epetra_DistObject.

Definition at line 54 of file Epetra_DistObject.cpp.

Epetra_DistObject::Epetra_DistObject	(	const Epetra_BlockMap &	Map,
		const char *const	Label
	)

Creates a Epetra_DistObject object.

Parameters

In	Map - A Epetra_LocalMap, Epetra_Map or Epetra_BlockMap.

Warning: Note that, because Epetra_LocalMap derives from Epetra_Map and Epetra_Map derives from Epetra_BlockMap, this constructor works for all three types of Epetra map classes.

Parameters

In	Label - An identifier for this object. By default, set to the name of the object class.

Returns: Pointer to a Epetra_DistObject.

Definition at line 68 of file Epetra_DistObject.cpp.

Epetra_DistObject::Epetra_DistObject ( const Epetra_DistObject & Source )

Epetra_DistObject copy constructor.

Definition at line 82 of file Epetra_DistObject.cpp.

Epetra_DistObject::~Epetra_DistObject ( )

virtual

Epetra_DistObject destructor.

Definition at line 94 of file Epetra_DistObject.cpp.

Member Function Documentation

int Epetra_DistObject::Import	(	const Epetra_SrcDistObject &	A,
		const Epetra_Import &	Importer,
		Epetra_CombineMode	CombineMode,
		const Epetra_OffsetIndex *	Indexor = `0`
	)

Imports an Epetra_DistObject using the Epetra_Import object.

Parameters

In	Source - Distributed object that will be imported into the "\e this" object.
In	Importer - A Epetra_Import object specifying the communication required.
In	CombineMode - A Epetra_CombineMode enumerated type specifying how results should be combined on the receiving processor.

Returns: Integer error code, set to 0 if successful.

Definition at line 113 of file Epetra_DistObject.cpp.

int Epetra_DistObject::Import	(	const Epetra_SrcDistObject &	A,
		const Epetra_Export &	Exporter,
		Epetra_CombineMode	CombineMode,
		const Epetra_OffsetIndex *	Indexor = `0`
	)

Imports an Epetra_DistObject using the Epetra_Export object.

Parameters

In	Source - Distributed object that will be imported into the "\e this" object.
In	Exporter - A Epetra_Export object specifying the communication required.
In	CombineMode - A Epetra_CombineMode enumerated type specifying how results should be combined on the receiving processor.

Returns: Integer error code, set to 0 if successful.

Definition at line 170 of file Epetra_DistObject.cpp.

int Epetra_DistObject::Export	(	const Epetra_SrcDistObject &	A,
		const Epetra_Import &	Importer,
		Epetra_CombineMode	CombineMode,
		const Epetra_OffsetIndex *	Indexor = `0`
	)

Exports an Epetra_DistObject using the Epetra_Import object.

Parameters

In	Source - Distributed object that will be exported to the "\e this" object.
In	Importer - A Epetra_Import object specifying the communication required.
In	CombineMode - A Epetra_CombineMode enumerated type specifying how results should be combined on the receiving processor.

Returns: Integer error code, set to 0 if successful.

Definition at line 198 of file Epetra_DistObject.cpp.

int Epetra_DistObject::Export	(	const Epetra_SrcDistObject &	A,
		const Epetra_Export &	Exporter,
		Epetra_CombineMode	CombineMode,
		const Epetra_OffsetIndex *	Indexor = `0`
	)

Exports an Epetra_DistObject using the Epetra_Export object.

Parameters

In	Source - Distributed object that will be exported to the "\e this" multivector.
In	Exporter - A Epetra_Export object specifying the communication required.
In	CombineMode - A Epetra_CombineMode enumerated type specifying how results should be combined on the receiving processor.

Returns: Integer error code, set to 0 if successful.

Definition at line 142 of file Epetra_DistObject.cpp.

const Epetra_BlockMap& Epetra_DistObject::Map ( ) const

inlinevirtual

Returns the address of the Epetra_BlockMap for this multi-vector.

Implements Epetra_SrcDistObject.

Reimplemented in Epetra_VbrMatrix.

Definition at line 200 of file Epetra_DistObject.h.

const Epetra_Comm& Epetra_DistObject::Comm ( ) const

inline

Returns the address of the Epetra_Comm for this multi-vector.

Definition at line 203 of file Epetra_DistObject.h.

bool Epetra_DistObject::DistributedGlobal ( ) const

inline

Returns true if this multi-vector is distributed global, i.e., not local replicated.

Definition at line 206 of file Epetra_DistObject.h.

void Epetra_DistObject::Print ( std::ostream & os ) const

virtual

Print method.

Reimplemented from Epetra_Object.

Reimplemented in Epetra_CrsMatrix, Epetra_VbrMatrix, Epetra_CrsGraph, Epetra_MultiVector, Epetra_IntMultiVector, Epetra_IntVector, Epetra_LongLongVector, Epetra_MapColoring, and Epetra_FECrsMatrix.

Definition at line 294 of file Epetra_DistObject.cpp.

int Epetra_DistObject::DoTransfer	(	const Epetra_SrcDistObject &	A,
		Epetra_CombineMode	CombineMode,
		int	NumSameIDs,
		int	NumPermuteIDs,
		int	NumRemoteIDs,
		int	NumExportIDs,
		int *	PermuteToLIDs,
		int *	PermuteFromLIDs,
		int *	RemoteLIDs,
		int *	ExportLIDs,
		int &	LenExports,
		char *&	Exports,
		int &	LenImports,
		char *&	Imports,
		Epetra_Distributor &	Distor,
		bool	DoReverse,
		const Epetra_OffsetIndex *	Indexor
	)

protectedvirtual

Perform actual transfer (redistribution) of data across memory images, using Epetra_Distributor object.

Definition at line 226 of file Epetra_DistObject.cpp.

virtual int Epetra_DistObject::CheckSizes ( const Epetra_SrcDistObject & Source )

protectedpure virtual

Allows the source and target (this) objects to be compared for compatibility, return nonzero if not.

Implemented in Epetra_CrsMatrix, Epetra_VbrMatrix, Epetra_CrsGraph, Epetra_MultiVector, Epetra_IntMultiVector, Epetra_IntVector, Epetra_LongLongVector, and Epetra_MapColoring.

virtual int Epetra_DistObject::CopyAndPermute	(	const Epetra_SrcDistObject &	Source,
		int	NumSameIDs,
		int	NumPermuteIDs,
		int *	PermuteToLIDs,
		int *	PermuteFromLIDs,
		const Epetra_OffsetIndex *	Indexor,
		Epetra_CombineMode	CombineMode = `Zero`
	)

protectedpure virtual

Perform ID copies and permutations that are on processor.

Implemented in Epetra_CrsMatrix, Epetra_VbrMatrix, Epetra_CrsGraph, Epetra_MultiVector, Epetra_IntMultiVector, Epetra_IntVector, Epetra_LongLongVector, and Epetra_MapColoring.

virtual int Epetra_DistObject::PackAndPrepare	(	const Epetra_SrcDistObject &	Source,
		int	NumExportIDs,
		int *	ExportLIDs,
		int &	LenExports,
		char *&	Exports,
		int &	SizeOfPacket,
		int *	Sizes,
		bool &	VarSizes,
		Epetra_Distributor &	Distor
	)

protectedpure virtual

Perform any packing or preparation required for call to DoTransfer().

Implemented in Epetra_CrsMatrix, Epetra_VbrMatrix, Epetra_CrsGraph, Epetra_MultiVector, Epetra_IntMultiVector, Epetra_IntVector, Epetra_LongLongVector, and Epetra_MapColoring.

virtual int Epetra_DistObject::UnpackAndCombine	(	const Epetra_SrcDistObject &	Source,
		int	NumImportIDs,
		int *	ImportLIDs,
		int	LenImports,
		char *	Imports,
		int &	SizeOfPacket,
		Epetra_Distributor &	Distor,
		Epetra_CombineMode	CombineMode,
		const Epetra_OffsetIndex *	Indexor
	)

protectedpure virtual

Perform any unpacking and combining after call to DoTransfer().

Implemented in Epetra_CrsMatrix, Epetra_VbrMatrix, Epetra_CrsGraph, Epetra_MultiVector, Epetra_IntMultiVector, Epetra_IntVector, Epetra_LongLongVector, and Epetra_MapColoring.

Epetra_DistObject & Epetra_DistObject::operator= ( const Epetra_DistObject & src )

private

Definition at line 310 of file Epetra_DistObject.cpp.

Member Data Documentation

Epetra_BlockMap Epetra_DistObject::Map_

protected

Definition at line 278 of file Epetra_DistObject.h.

const Epetra_Comm* Epetra_DistObject::Comm_

protected

Definition at line 279 of file Epetra_DistObject.h.

char* Epetra_DistObject::Exports_

protected

Definition at line 280 of file Epetra_DistObject.h.

char* Epetra_DistObject::Imports_

protected

Definition at line 281 of file Epetra_DistObject.h.

int Epetra_DistObject::LenExports_

protected

Definition at line 282 of file Epetra_DistObject.h.

int Epetra_DistObject::LenImports_

protected

Definition at line 283 of file Epetra_DistObject.h.

int* Epetra_DistObject::Sizes_

protected

Definition at line 284 of file Epetra_DistObject.h.

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

Protected Attributes

Private Member Functions

Constructors/Destructor

Import/Export Methods

Attribute accessor methods

Miscellaneous

Internal utilities

Virtual methods to be implemented by derived class

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation