Main Page | Namespace List | Class Hierarchy | Alphabetical List | Compound List | File List | Compound Members | File Members

LevelData< T > Class Template Reference

Data over a disjoint union of rectangles. More...

#include <LevelData.H>

Inheritance diagram for LevelData< T >:

Inheritance graph
[legend]
Collaboration diagram for LevelData< T >:

Collaboration graph
[legend]
List of all members.

Public Member Functions

 LevelData ()
 LevelData (const DisjointBoxLayout &dp, int comps, const IntVect &ghost=IntVect::TheZeroVector(), const DataFactory< T > &a_factory=DefaultDataFactory< T >())
virtual ~LevelData ()
virtual void define (const DisjointBoxLayout &dp, int comps, const IntVect &ghost=IntVect::TheZeroVector(), const DataFactory< T > &a_factory=DefaultDataFactory< T >())
virtual void define (const LevelData< T > &da, const DataFactory< T > &a_factory=DefaultDataFactory< T >())
virtual void define (const LevelData< T > &da, const Interval &comps, const DataFactory< T > &a_factory=DefaultDataFactory< T >())
virtual void copyTo (const Interval &srcComps, BoxLayoutData< T > &dest, const Interval &destComps) const
virtual void copyTo (const Interval &srcComps, BoxLayoutData< T > &dest, const Interval &destComps, const Copier &copier) const
virtual void copyTo (const Interval &srcComps, LevelData< T > &dest, const Interval &destComps) const
virtual void copyTo (const Interval &srcComps, LevelData< T > &dest, const Interval &destComps, const Copier &copier, const LDOperator< T > &a_op=LDOperator< T >()) const
virtual void exchange (const Interval &comps)
virtual void exchange (const Interval &comps, const Copier &copier)
const IntVectghostVect () const
const DisjointBoxLayoutgetBoxes () const
const DisjointBoxLayoutdisjointBoxLayout () const
virtual void apply (void(*a_Function)(const Box &box, int comps, T &t))
overidden virtual functions
These functions will invoke error messages when invoked. C++ will ensure that constructors are not called for the base class by a user, but a 'define' function has no such protection, hence the need to prevent such usage. A runtime error is not a perfect solution...(strong construction gets around this *sigh*). classes that derive from LevelData will have to turn it's valid defines into runtime errors also and make it's own defines. Thus taking over the job of the compiler.

virtual void define (const BoxLayout &dp, int comps, const DataFactory< T > &factory)
virtual void define (const BoxLayoutData< T > &da, const DataFactory< T > &factory=DefaultDataFactory< T >())
virtual void define (const BoxLayoutData< T > &da, const Interval &comps, const DataFactory< T > &factory=DefaultDataFactory< T >())
virtual void define (const BoxLayout &deadFunction)
 overridden and throws an error.


Protected Member Functions

void makeItSo (const Interval &a_srcComps, const LevelData< T > &a_src, BoxLayoutData< T > &a_dest, const Interval &a_destComps, const Copier &a_copier, const LDOperator< T > &a_op=LDOperator< T >()) const
void completePendingSends () const
void allocateBuffers (const LevelData< T > &a_src, const Interval &a_srcComps, const BoxLayoutData< T > &a_dest, const Interval &a_destComps, const Copier &a_copier, const LDOperator< T > &a_op) const
void writeSendDataFromMeIntoBuffers (const LevelData< T > &a_src, const Interval &a_srcComps, const LDOperator< T > &a_op) const
void postSendsFromMe () const
void postReceivesToMe () const
void unpackReceivesToMe (BoxLayoutData< T > &a_dest, const Interval &a_destComps, const LDOperator< T > &a_op) const

Protected Attributes

DisjointBoxLayout m_disjointBoxLayout
IntVect m_ghost
Parallel messaging members
void * m_sendbuffer
size_t m_sendcapacity
void * m_recbuffer
size_t m_reccapacity

Detailed Description

template<class T>
class LevelData< T >

Data over a disjoint union of rectangles.

LevelData is-a BoxLayoutData. It is built from a DisjointBoxLayout instead though, thus making the data in a DisjointBoxLayout uniquely defined for all spatial indices defined by the underlying DisjointBoxLayout. It carries within it an inherent concept of ghost cells (which the user can choose to be empty).

Since LevelData is-a BoxLayoutData, all the methods required of the template class T for BoxLayoutData are also required for LevelData. LevelData does not have any extra requirements.


Constructor & Destructor Documentation

template<class T>
LevelData< T >::LevelData  ) 
 

template<class T>
LevelData< T >::LevelData const DisjointBoxLayout dp,
int  comps,
const IntVect ghost = IntVect::TheZeroVector(),
const DataFactory< T > &  a_factory = DefaultDataFactory< T >()
 

template<class T>
LevelData< T >::~LevelData  )  [virtual]
 


Member Function Documentation

template<class T>
void LevelData< T >::allocateBuffers const LevelData< T > &  a_src,
const Interval a_srcComps,
const BoxLayoutData< T > &  a_dest,
const Interval a_destComps,
const Copier a_copier,
const LDOperator< T > &  a_op
const [protected]
 

template<class T>
void LevelData< T >::apply void(*  a_Function)(const Box &box, int comps, T &t)  )  [virtual]
 

User writes a function with the signature:

     void myfunction(const Box& box, int comps, T& t){ your code here;}

They can then hand this off to LayoutData::apply. This class then cycles through all the T objects and invokes this function. Function must not be inline. (I'm still trying to figure out a nice way to send in non-static member functions).

for example:

  LevelData<FArrayBox> data(layout, 3, IntVect::Unit);
  struct val{
  static void set1(const Box& box, int comps, const FArrayBox& f)
  {
    f.setVal(box, box.smallEnd(0));
  }

  data.apply(val::set1);

Reimplemented from BoxLayoutData< T >.

template<class T>
void LevelData< T >::completePendingSends  )  const [protected]
 

template<class T>
void LevelData< T >::copyTo const Interval srcComps,
LevelData< T > &  dest,
const Interval destComps,
const Copier copier,
const LDOperator< T > &  a_op = LDOperator< T >()
const [virtual]
 

same as copyTo that takes a BoxLayoutData, except that it fills the ghost cells of 'dest' with data from 'this' also. USer passes in a prebuilt Copier object

template<class T>
void LevelData< T >::copyTo const Interval srcComps,
LevelData< T > &  dest,
const Interval destComps
const [virtual]
 

same as copyTo that takes a BoxLayoutData, except that it fills the ghost cells of 'dest' with data from 'this' also.

template<class T>
void LevelData< T >::copyTo const Interval srcComps,
BoxLayoutData< T > &  dest,
const Interval destComps,
const Copier copier
const [virtual]
 

template<class T>
void LevelData< T >::copyTo const Interval srcComps,
BoxLayoutData< T > &  dest,
const Interval destComps
const [virtual]
 

template<class T>
void LevelData< T >::define const BoxLayout deadFunction  )  [virtual]
 

overridden and throws an error.

Reimplemented from BoxLayoutData< T >.

template<class T>
void LevelData< T >::define const BoxLayoutData< T > &  da,
const Interval comps,
const DataFactory< T > &  factory = DefaultDataFactory< T >()
[virtual]
 

Define this BoxLayoutData to be the subset of the data in da defined by the Interval comps.

Reimplemented from BoxLayoutData< T >.

template<class T>
void LevelData< T >::define const BoxLayoutData< T > &  da,
const DataFactory< T > &  factory = DefaultDataFactory< T >()
[virtual]
 

Reimplemented from BoxLayoutData< T >.

template<class T>
void LevelData< T >::define const BoxLayout dp,
int  comps,
const DataFactory< T > &  factory
[virtual]
 

Reimplemented from BoxLayoutData< T >.

template<class T>
void LevelData< T >::define const LevelData< T > &  da,
const Interval comps,
const DataFactory< T > &  a_factory = DefaultDataFactory< T >()
[virtual]
 

Copy definer. 'this' LevelData thrown away and da's LevelData copied. This LevelData is now defined for the range [0, comps.size()] and filled with the data in da from [comps.begin(), comps.end()]

template<class T>
void LevelData< T >::define const LevelData< T > &  da,
const DataFactory< T > &  a_factory = DefaultDataFactory< T >()
[virtual]
 

copy definer. this LevelData thrown away and da's LevelData copied

template<class T>
void LevelData< T >::define const DisjointBoxLayout dp,
int  comps,
const IntVect ghost = IntVect::TheZeroVector(),
const DataFactory< T > &  a_factory = DefaultDataFactory< T >()
[virtual]
 

template<class T>
const DisjointBoxLayout& LevelData< T >::disjointBoxLayout  )  const [inline]
 

template<class T>
void LevelData< T >::exchange const Interval comps,
const Copier copier
[virtual]
 

template<class T>
void LevelData< T >::exchange const Interval comps  )  [virtual]
 

template<class T>
const DisjointBoxLayout& LevelData< T >::getBoxes  )  const [inline]
 

template<class T>
const IntVect& LevelData< T >::ghostVect  )  const [inline]
 

template<class T>
void LevelData< T >::makeItSo const Interval a_srcComps,
const LevelData< T > &  a_src,
BoxLayoutData< T > &  a_dest,
const Interval a_destComps,
const Copier a_copier,
const LDOperator< T > &  a_op = LDOperator< T >()
const [protected]
 

template<class T>
void LevelData< T >::postReceivesToMe  )  const [protected]
 

template<class T>
void LevelData< T >::postSendsFromMe  )  const [protected]
 

template<class T>
void LevelData< T >::unpackReceivesToMe BoxLayoutData< T > &  a_dest,
const Interval a_destComps,
const LDOperator< T > &  a_op
const [protected]
 

template<class T>
void LevelData< T >::writeSendDataFromMeIntoBuffers const LevelData< T > &  a_src,
const Interval a_srcComps,
const LDOperator< T > &  a_op
const [protected]
 


Member Data Documentation

template<class T>
DisjointBoxLayout LevelData< T >::m_disjointBoxLayout [protected]
 

template<class T>
IntVect LevelData< T >::m_ghost [protected]
 

template<class T>
void* LevelData< T >::m_recbuffer [mutable, protected]
 

template<class T>
size_t LevelData< T >::m_reccapacity [mutable, protected]
 

template<class T>
void* LevelData< T >::m_sendbuffer [mutable, protected]
 

template<class T>
size_t LevelData< T >::m_sendcapacity [mutable, protected]
 


The documentation for this class was generated from the following files:
Generated on Wed Jun 2 13:58:42 2004 for Chombo&INSwithParticles by doxygen 1.3.2