Zoltan2
Public Types | Public Member Functions
Zoltan2::BaseAdapter< User > Class Template Reference

BaseAdapter defines methods required by all Adapters. More...

#include <Zoltan2_Adapter.hpp>

Inheritance diagram for Zoltan2::BaseAdapter< User >:
Inheritance graph
[legend]

List of all members.

Public Types

typedef InputTraits< User >::zgid_t zgid_t
typedef InputTraits< User >
::scalar_t 
scalar_t
typedef InputTraits< User >::part_t part_t

Public Member Functions

virtual enum BaseAdapterType adapterType () const =0
 Returns the type of adapter.
virtual ~BaseAdapter ()
 Destructor.
virtual size_t getLocalNumIDs () const =0
 Returns the number of objects on this process.
virtual void getIDsView (const zgid_t *&Ids) const =0
 Provide a pointer to this process' identifiers.
virtual int getNumWeightsPerID () const =0
 Returns the number of weights per object. Number of weights per object should be zero or greater. If zero, then it is assumed that all objects are equally weighted.
virtual void getWeightsView (const scalar_t *&wgt, int &stride, int idx=0) const =0
 Provide pointer to a weight array with stride.
void getPartsView (const part_t *&inputPart) const
 Provide pointer to an array containing the input part assignment for each ID. The input part information may be used for re-partitioning to reduce data movement, or for mapping parts to processes. Adapters may return NULL for this pointer (the default behavior); if NULL is returned, algorithms will assume the rank.
template<typename Adapter >
void applyPartitioningSolution (const User &in, User *&out, const PartitioningSolution< Adapter > &solution) const
 Apply a PartitioningSolution to an input.

Detailed Description

template<typename User>
class Zoltan2::BaseAdapter< User >

BaseAdapter defines methods required by all Adapters.

Adapters provide access from Zoltan2 to the user's data. The methods in the interface must be defined by users. Many built-in adapters are already defined for common data structures, such as Tpetra and Epetra objects and C-language pointers to arrays.

Definition at line 94 of file Zoltan2_Adapter.hpp.


Member Typedef Documentation

template<typename User>
typedef InputTraits<User>::zgid_t Zoltan2::BaseAdapter< User >::zgid_t
template<typename User>
typedef InputTraits<User>::scalar_t Zoltan2::BaseAdapter< User >::scalar_t
template<typename User>
typedef InputTraits<User>::part_t Zoltan2::BaseAdapter< User >::part_t

Constructor & Destructor Documentation

template<typename User>
virtual Zoltan2::BaseAdapter< User >::~BaseAdapter ( ) [inline, virtual]

Destructor.

Definition at line 108 of file Zoltan2_Adapter.hpp.


Member Function Documentation

template<typename User>
virtual enum BaseAdapterType Zoltan2::BaseAdapter< User >::adapterType ( ) const [pure virtual]
template<typename User>
virtual size_t Zoltan2::BaseAdapter< User >::getLocalNumIDs ( ) const [pure virtual]

Returns the number of objects on this process.

Objects may be coordinates, graph vertices, matrix rows, etc. They are the objects to be partitioned, ordered, or colored.

Implemented in Zoltan2::MeshAdapter< User >, Zoltan2::MatrixAdapter< User, UserCoord >, Zoltan2::GraphAdapter< User, UserCoord >, Zoltan2::BasicVectorAdapter< User >, Zoltan2::XpetraMultiVectorAdapter< User >, and Zoltan2::BasicIdentifierAdapter< User >.

template<typename User>
virtual void Zoltan2::BaseAdapter< User >::getIDsView ( const zgid_t *&  Ids) const [pure virtual]

Provide a pointer to this process' identifiers.

Parameters:
Idswill on return point to the list of the global Ids for this process.

Implemented in Zoltan2::MeshAdapter< User >, Zoltan2::MatrixAdapter< User, UserCoord >, Zoltan2::GraphAdapter< User, UserCoord >, Zoltan2::XpetraMultiVectorAdapter< User >, and Zoltan2::BasicIdentifierAdapter< User >.

template<typename User>
virtual int Zoltan2::BaseAdapter< User >::getNumWeightsPerID ( ) const [pure virtual]

Returns the number of weights per object. Number of weights per object should be zero or greater. If zero, then it is assumed that all objects are equally weighted.

Implemented in Zoltan2::MatrixAdapter< User, UserCoord >, Zoltan2::MeshAdapter< User >, Zoltan2::GraphAdapter< User, UserCoord >, Zoltan2::BasicVectorAdapter< User >, Zoltan2::XpetraMultiVectorAdapter< User >, and Zoltan2::BasicIdentifierAdapter< User >.

template<typename User>
virtual void Zoltan2::BaseAdapter< User >::getWeightsView ( const scalar_t *&  wgt,
int &  stride,
int  idx = 0 
) const [pure virtual]

Provide pointer to a weight array with stride.

Parameters:
wgton return a pointer to the weights for this idx
strideon return, the value such that the nth weight should be found at wgt[n*stride] .
idxthe weight index, zero or greater

Implemented in Zoltan2::MatrixAdapter< User, UserCoord >, Zoltan2::MeshAdapter< User >, Zoltan2::GraphAdapter< User, UserCoord >, Zoltan2::BasicVectorAdapter< User >, Zoltan2::XpetraMultiVectorAdapter< User >, and Zoltan2::BasicIdentifierAdapter< User >.

template<typename User>
void Zoltan2::BaseAdapter< User >::getPartsView ( const part_t *&  inputPart) const [inline]

Provide pointer to an array containing the input part assignment for each ID. The input part information may be used for re-partitioning to reduce data movement, or for mapping parts to processes. Adapters may return NULL for this pointer (the default behavior); if NULL is returned, algorithms will assume the rank.

Parameters:
inputParton return a pointer to input part numbers

Definition at line 148 of file Zoltan2_Adapter.hpp.

template<typename User>
template<typename Adapter >
void Zoltan2::BaseAdapter< User >::applyPartitioningSolution ( const User &  in,
User *&  out,
const PartitioningSolution< Adapter > &  solution 
) const [inline]

Apply a PartitioningSolution to an input.

This is not a required part of the InputAdapter interface. However if the Caller calls a Problem method to redistribute data, it needs this method to perform the redistribution.

Parameters:
inAn input object with a structure and assignment of of global Ids to processes that matches that of the input data that instantiated this Adapter.
outOn return this should point to a newly created object with the specified partitioning.
solutionThe Solution object created by a Problem should be supplied as the third argument. It must have been templated on user data that has the same global ID distribution as this user data.
Returns:
Returns the number of local Ids in the new partition.

Reimplemented in Zoltan2::XpetraCrsGraphAdapter< User, UserCoord >, Zoltan2::XpetraCrsMatrixAdapter< User, UserCoord >, Zoltan2::XpetraRowMatrixAdapter< User, UserCoord >, and Zoltan2::XpetraMultiVectorAdapter< User >.

Definition at line 174 of file Zoltan2_Adapter.hpp.


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