Epetra_Directory Class Reference

Epetra_Directory: This class is a pure virtual class whose interface allows Epetra_Map and Epetr_BlockMap objects to reference non-local elements. More...

#include <Epetra_Directory.h>

Inheritance diagram for Epetra_Directory:

Constructors/Destructor
virtual	~Epetra_Directory ()
	Epetra_Directory destructor. More...

Query method
virtual int	GetDirectoryEntries (const Epetra_BlockMap &Map, const int NumEntries, const int *GlobalEntries, int *Procs, int *LocalEntries, int *EntrySizes, bool high_rank_sharing_procs=false) const =0
	GetDirectoryEntries : Returns proc and local id info for non-local map entries. More...
virtual int	GetDirectoryEntries (const Epetra_BlockMap &Map, const int NumEntries, const long long *GlobalEntries, int *Procs, int *LocalEntries, int *EntrySizes, bool high_rank_sharing_procs=false) const =0
virtual bool	GIDsAllUniquelyOwned () const =0
	GIDsAllUniquelyOwned: returns true if all GIDs appear on just one processor. More...

Detailed Description

Epetra_Directory: This class is a pure virtual class whose interface allows Epetra_Map and Epetr_BlockMap objects to reference non-local elements.

For Epetra_BlockMap objects, a Epetra_Directory object must be created by a call to the Epetra_Comm CreateDirectory method. The Directory is needed to allow referencing of non-local elements.

Definition at line 59 of file Epetra_Directory.h.

Constructor & Destructor Documentation

virtual Epetra_Directory::~Epetra_Directory ( )

inlinevirtual

Epetra_Directory destructor.

Definition at line 66 of file Epetra_Directory.h.

Member Function Documentation

virtual int Epetra_Directory::GetDirectoryEntries ( const Epetra_BlockMap &  Map, const int  NumEntries, const int *  GlobalEntries, int *  Procs, int *  LocalEntries, int *  EntrySizes, bool  high_rank_sharing_procs = false  ) const

pure virtual

GetDirectoryEntries : Returns proc and local id info for non-local map entries.

Given a list of Global Entry IDs, this function returns the list of processor IDs and local IDs on the owning processor that correspond to the list of entries. If LocalEntries is 0, then local IDs are not returned. If EntrySizes is nonzero, it will contain a list of corresponding element sizes for the requested global entries.

Parameters

In	NumEntries - Number of Global IDs being passed in.
In	GlobalEntries - List of Global IDs being passed in.
InOut	Procs - User allocated array of length at least NumEntries. On return contains list of processors owning the Global IDs in question.
InOut	LocalEntries - User allocated array of length at least NumEntries. On return contains the local ID of the global on the owning processor. If LocalEntries is zero, no local ID information is returned.
InOut	EntrySizes - User allocated array of length at least NumEntries. On return contains the size of the object associated with this global ID. If LocalEntries is zero, no size information is returned.
In	high_rank_sharing_procs Optional argument, defaults to true. If any GIDs appear on multiple processors (referred to as "sharing procs"), this specifies whether the lowest-rank proc or the highest-rank proc is chosen as the "owner".

Returns

Integer error code, set to 0 if successful.

Implemented in Epetra_BasicDirectory.

virtual int Epetra_Directory::GetDirectoryEntries ( const Epetra_BlockMap &  Map, const int  NumEntries, const long long *  GlobalEntries, int *  Procs, int *  LocalEntries, int *  EntrySizes, bool  high_rank_sharing_procs = false  ) const

pure virtual

Implemented in Epetra_BasicDirectory.

virtual bool Epetra_Directory::GIDsAllUniquelyOwned ( ) const

pure virtual

GIDsAllUniquelyOwned: returns true if all GIDs appear on just one processor.

If any GIDs are owned by multiple processors, returns false.

Implemented in Epetra_BasicDirectory.

---

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

• Epetra_Directory.h