Epetra_LongLongVector: A class for constructing and using dense integer vectors on a parallel computer. More...

#include <Epetra_LongLongVector.h>

Inheritance diagram for Epetra_LongLongVector:

Private Member Functions
int	AllocateForCopy ()

int	DoCopy (long long *V)

int	AllocateForView ()

int	DoView (long long *V)

int	CheckSizes (const Epetra_SrcDistObject &A)
	Allows the source and target (this) objects to be compared for compatibility, return nonzero if not. More...

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

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

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)
	Perform any unpacking and combining after call to DoTransfer(). More...

Private Attributes
long long *	Values_

bool	UserAllocated_

bool	Allocated_

Constructors/destructors
	Epetra_LongLongVector (const Epetra_BlockMap &Map, bool zeroOut=true)
	Basic Epetra_LongLongVector constuctor. More...

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

	Epetra_LongLongVector (Epetra_DataAccess CV, const Epetra_BlockMap &Map, long long *V)
	Set vector values from user array. More...

virtual	~Epetra_LongLongVector ()
	Epetra_LongLongVector destructor. More...

Post-construction modification methods
int	PutValue (long long Value)
	Set all elements of the vector to Value. More...

Extraction methods
int	ExtractCopy (long long *V) const
	Put vector values into user-provided array. More...

int	ExtractView (long long **V) const
	Set user-provided address of V. More...

Mathematical methods
long long	MaxValue ()
	Find maximum value. More...

long long	MinValue ()
	Find minimum value. More...

Overloaded operators
Epetra_LongLongVector &	operator= (const Epetra_LongLongVector &Source)
	= Operator. More...

long long &	operator[] (int index)
	Element access function. More...

const long long &	operator[] (int index) const
	Element access function. More...

Attribute access functions
long long *	Values () const
	Returns a pointer to an array containing the values of this vector. More...

int	MyLength () const
	Returns the local vector length on the calling processor of vectors in the multi-vector. More...

long long	GlobalLength64 () const
	Returns the global vector length of vectors in the multi-vector. More...

I/O methods
virtual void	Print (std::ostream &os) const
	Print method. More...

Additional Inherited Members
Public Member Functions inherited from Epetra_DistObject
	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...

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...

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...

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_DistObject
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...

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

Protected Attributes inherited from Epetra_DistObject
Epetra_BlockMap	Map_

const Epetra_Comm *	Comm_

char *	Exports_

char *	Imports_

int	LenExports_

int	LenImports_

int *	Sizes_

Detailed Description

Epetra_LongLongVector: A class for constructing and using dense integer vectors on a parallel computer.

The Epetra_LongLongVector class enables the construction and use of integer
 dense vectors in a distributed memory environment.  The distribution of the dense
vector is determined in part by a Epetra_Comm object and a Epetra_Map (or Epetra_LocalMap
or Epetra_BlockMap).

Distributed Global vs. Replicated Local

Distributed Global Vectors - In most instances, a multi-vector 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 Vectors - Some algorithms use vectors that are too small to be distributed across all processors. Replicated local vectors handle these types of situation.

Constructing Epetra_LongLongVectors

There are four Epetra_LongLongVector constructors. The first is a basic constructor that allocates space and sets all values to zero, the second is a copy constructor. The third and fourth constructors work with user data. These constructors have two data access modes:

Copy mode - Allocates memory and makes a copy of the user-provided data. In this case, the user data is not needed after construction.
View mode - Creates a "view" of the user data. In this case, the user data is required to remain intact for the life of the vector.

Warning: View mode is extremely dangerous from a data hiding perspective. Therefore, we strongly encourage users to develop code using Copy mode first and only use the View mode in a secondary optimization phase.

All Epetra_LongLongVector constructors require a map argument that describes the layout of elements on the parallel machine. Specifically, map is a Epetra_Map, Epetra_LocalMap or Epetra_BlockMap object describing the desired memory layout for the vector.

There are four different Epetra_LongLongVector constructors:

Basic - All values are zero.
Copy - Copy an existing vector.
Copy from or make view of user int array.

Extracting Data from Epetra_LongLongVectors

Once a Epetra_LongLongVector is constructed, it is possible to extract a copy of the values or create a view of them.

Warning: ExtractView functions are extremely dangerous from a data hiding perspective. For both ExtractView fuctions, there is a corresponding ExtractCopy function. We strongly encourage users to develop code using ExtractCopy functions first and only use the ExtractView functions in a secondary optimization phase.

There are two Extract functions:

ExtractCopy - Copy values into a user-provided array.
ExtractView - Set user-provided array to point to Epetra_LongLongVector data.

Warning: A Epetra_Map, Epetra_LocalMap or Epetra_BlockMap object is required for all Epetra_LongLongVector constructors.

Definition at line 134 of file Epetra_LongLongVector.h.

Constructor & Destructor Documentation

Epetra_LongLongVector::Epetra_LongLongVector	(	const Epetra_BlockMap &	Map,
		bool	zeroOut = `true`
	)

Basic Epetra_LongLongVector constuctor.

Creates a Epetra_LongLongVector object and, by default, fills with zero values.

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	zeroOut - If `true` then the allocated memory will be zeroed out initialy. If `false` then this memory will not be touched which can be significantly faster.

Returns: Pointer to a Epetra_LongLongVector.

Definition at line 52 of file Epetra_LongLongVector.cpp.

Epetra_LongLongVector::Epetra_LongLongVector ( const Epetra_LongLongVector & Source )

Epetra_LongLongVector copy constructor.

Definition at line 65 of file Epetra_LongLongVector.cpp.

Epetra_LongLongVector::Epetra_LongLongVector	(	Epetra_DataAccess	CV,
		const Epetra_BlockMap &	Map,
		long long *	V
	)

Set vector values from user array.

Parameters

In	Epetra_DataAccess - Enumerated type set to Copy or View.
In	Map - A Epetra_LocalMap, Epetra_Map or Epetra_BlockMap.
In	V - Pointer to an array of long long numbers..

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

See Detailed Description section for further discussion.

Definition at line 78 of file Epetra_LongLongVector.cpp.

Epetra_LongLongVector::~Epetra_LongLongVector ( )

virtual

Epetra_LongLongVector destructor.

Definition at line 97 of file Epetra_LongLongVector.cpp.

Member Function Documentation

int Epetra_LongLongVector::PutValue ( long long Value )

Set all elements of the vector to Value.

Definition at line 162 of file Epetra_LongLongVector.cpp.

int Epetra_LongLongVector::ExtractCopy ( long long * V ) const

Put vector values into user-provided array.

Parameters

Out	V - Pointer to memory space that will contain the vector values.

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

Definition at line 147 of file Epetra_LongLongVector.cpp.

int Epetra_LongLongVector::ExtractView ( long long ** V ) const

Set user-provided address of V.

Parameters

Out	V - Address of a pointer to that will be set to point to the values of the vector.

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

Definition at line 155 of file Epetra_LongLongVector.cpp.

long long Epetra_LongLongVector::MaxValue ( )

Find maximum value.

Returns: Maximum value across all processors.

Definition at line 168 of file Epetra_LongLongVector.cpp.

long long Epetra_LongLongVector::MinValue ( )

Find minimum value.

Returns: Minimum value across all processors.

Definition at line 178 of file Epetra_LongLongVector.cpp.

Epetra_LongLongVector & Epetra_LongLongVector::operator= ( const Epetra_LongLongVector & Source )

= Operator.

Parameters

In	A - Epetra_LongLongVector to copy.

Returns: Epetra_LongLongVector.

Definition at line 188 of file Epetra_LongLongVector.cpp.

long long& Epetra_LongLongVector::operator[] ( int index )

inline

Element access function.

Returns: V[Index].

Definition at line 245 of file Epetra_LongLongVector.h.

const long long& Epetra_LongLongVector::operator[] ( int index ) const

inline

Element access function.

Returns: V[Index].

Definition at line 250 of file Epetra_LongLongVector.h.

long long* Epetra_LongLongVector::Values ( ) const

inline

Returns a pointer to an array containing the values of this vector.

Definition at line 257 of file Epetra_LongLongVector.h.

int Epetra_LongLongVector::MyLength ( ) const

inline

Returns the local vector length on the calling processor of vectors in the multi-vector.

Definition at line 260 of file Epetra_LongLongVector.h.

long long Epetra_LongLongVector::GlobalLength64 ( ) const

inline

Returns the global vector length of vectors in the multi-vector.

Definition at line 263 of file Epetra_LongLongVector.h.

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

virtual

Print method.

Reimplemented from Epetra_DistObject.

Definition at line 200 of file Epetra_LongLongVector.cpp.

int Epetra_LongLongVector::AllocateForCopy ( void )

private

Definition at line 104 of file Epetra_LongLongVector.cpp.

int Epetra_LongLongVector::DoCopy ( long long * V )

private

Definition at line 121 of file Epetra_LongLongVector.cpp.

int Epetra_LongLongVector::AllocateForView ( void )

private

Definition at line 129 of file Epetra_LongLongVector.cpp.

int Epetra_LongLongVector::DoView ( long long * V )

private

Definition at line 139 of file Epetra_LongLongVector.cpp.

int Epetra_LongLongVector::CheckSizes ( const Epetra_SrcDistObject & Source )

privatevirtual

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

Implements Epetra_DistObject.

Definition at line 254 of file Epetra_LongLongVector.cpp.

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

privatevirtual

Perform ID copies and permutations that are on processor.

Implements Epetra_DistObject.

Definition at line 261 of file Epetra_LongLongVector.cpp.

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

privatevirtual

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

Implements Epetra_DistObject.

Definition at line 373 of file Epetra_LongLongVector.cpp.

int Epetra_LongLongVector::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
	)

privatevirtual

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

Implements Epetra_DistObject.

Definition at line 447 of file Epetra_LongLongVector.cpp.

Member Data Documentation

long long* Epetra_LongLongVector::Values_

private

Definition at line 310 of file Epetra_LongLongVector.h.

bool Epetra_LongLongVector::UserAllocated_

private

Definition at line 311 of file Epetra_LongLongVector.h.

bool Epetra_LongLongVector::Allocated_

private

Definition at line 312 of file Epetra_LongLongVector.h.

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

Private Member Functions

Private Attributes

Constructors/destructors

Post-construction modification methods

Extraction methods

Mathematical methods

Overloaded operators

Attribute access functions

I/O methods

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation