#include <BoxLayoutData.H>

Inheritance diagram for LevelData< T >:

[legend]

Classes
struct	ApplyFunctor

Public Member Functions
	LevelData ()

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

virtual	~LevelData ()

virtual void	define (const DisjointBoxLayout &dp, int comps, const IntVect &ghost=IntVect::Zero, 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	localCopyTo (const Interval &srcComps, LevelData< T > &dest, const Interval &destComps) const
	only works if source and dest have the same disjointboxlayout More...

virtual void	localCopyTo (LevelData< T > &dest) const
	assumes source and dest have same interval More...

virtual void	copyTo (BoxLayoutData< T > &dest) const
	Simplest case – assumes source and dest have same interval. More...

virtual void	copyTo (const Interval &srcComps, BoxLayoutData< T > &dest, const Interval &destComps, const Copier &copier, const LDOperator< T > &a_op=LDOperator< T >()) const

virtual void	copyTo (BoxLayoutData< T > &dest, const Copier &copier, const LDOperator< T > &a_op=LDOperator< T >()) const
	Simplest case – assumes source and dest have same interval. More...

virtual void	copyTo (const Interval &srcComps, LevelData< T > &dest, const Interval &destComps) const

virtual void	copyTo (LevelData< T > &dest) const
	Simplest case – assumes source and dest have same interval. More...

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	copyTo (LevelData< T > &dest, const Copier &copier, const LDOperator< T > &a_op=LDOperator< T >()) const
	Simplest case – assumes source and dest have same interval. More...

virtual void	exchange (void)
	Simplest case – do all components. More...

virtual void	exchange (const Copier &copier)
	Simplest case – do all components. Accepts a pre-built copier. More...

virtual void	exchange (const Interval &comps)
	Accepts an arbitrary component range. More...

virtual void	exchange (const Interval &comps, const Copier &copier, const LDOperator< T > &a_op=LDOperator< T >())

virtual void	exchangeBegin (const Copier &copier)
	asynchronous exchange start. load and fire off messages. More...

virtual void	exchangeEnd ()
	finish asynchronous exchange More...

virtual void	exchangeNoOverlap (const Copier &copier)

const IntVect &	ghostVect () const

const DisjointBoxLayout &	getBoxes () const

const DisjointBoxLayout &	disjointBoxLayout () const

virtual void	apply (void(*a_Function)(const Box &, int, T &))

virtual void	apply (const ApplyFunctor &)

void	degenerate (LevelData< T > &a_to, const SliceSpec &a_ss) const

void	degenerateLocalOnly (LevelData< T > &a_to, const SliceSpec &a_ss) const
	version of degenerate which does strictly local copying More...

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 its valid defines into runtime errors also and make its 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. More...

Public Member Functions inherited from BoxLayoutData< T >
	BoxLayoutData ()

virtual	~BoxLayoutData ()

	BoxLayoutData (const BoxLayout &boxes, int comps, const DataFactory< T > &factory=DefaultDataFactory< T >())

virtual bool	threadSafe () const

int	nComp () const

Interval	interval () const

void	generalCopyTo (const BoxLayout &a_destGrids, LayoutData< Vector< RefCountedPtr< T > > > &a_dest, const Interval &a_interval, const ProblemDomain &a_domain, const DataFactory< T > &factory=DefaultDataFactory< T >()) const
	General data copying operation. More...

void	generalCopyTo (const BoxLayout &a_destGrids, LayoutData< Vector< RefCountedPtr< T > > > &a_dest, const Interval &a_interval, const ProblemDomain &a_domain, const Copier &a_copier, const DataFactory< T > &factory=DefaultDataFactory< T >()) const

void	addTo (const Interval &a_srcComps, BoxLayoutData< T > &a_dest, const Interval &a_destComps, const ProblemDomain &a_domain) const

void	addTo (const Interval &a_srcComps, BoxLayoutData< T > &a_dest, const Interval &a_destComps, const ProblemDomain &a_domain, const Copier &a_copier) const

virtual void	apply (void(*a_Function)(const Box &box, int comps, T &t))

virtual bool	isDefined () const

virtual void	clear ()

Public Member Functions inherited from LayoutData< T >
	LayoutData ()

	LayoutData (const BoxLayout &a_dp)

virtual	~LayoutData ()

DataIterator	dataIterator () const

TimedDataIterator	timedDataIterator () const

const T &	operator[] (const DataIndex &a_index) const
	const accessor function More...

const T &	operator[] (const DataIterator &a_iterator) const
	const accessor function More...

T &	operator[] (const DataIndex &a_index)
	non-const accessor function More...

T &	operator[] (const DataIterator &a_iterator)
	non-const accessor function More...

Box	box (const DataIndex &a_index) const

Box	box (const DataIterator &a_iterator) const

const BoxLayout &	boxLayout () const

Protected Attributes
DisjointBoxLayout	m_disjointBoxLayout

IntVect	m_ghost

Copier	m_exchangeCopier

Protected Attributes inherited from BoxLayoutData< T >
int	m_comps

bool	m_threadSafe

bool	m_isdefined

CopierBuffer *	m_buff

Protected Attributes inherited from LayoutData< T >
BoxLayout	m_boxLayout

Vector< T * >	m_vector

bool	m_callDelete

Friends
void	aliasLevelData (LevelData< T > &a_alias, LevelData< T > *a_original, const Interval &a_interval)
	Data over a disjoint union of rectangles. More...

Additional Inherited Members
Static Public Attributes inherited from BoxLayoutData< T >
static int	s_verbosity = 0

Protected Member Functions inherited from BoxLayoutData< T >
void	setVector (const BoxLayoutData< T > &da, const Interval &srcComps, const Interval &destComps)

void	allocateGhostVector (const DataFactory< T > &factory, const IntVect &ghost=IntVect::Zero)

void	makeItSo (const Interval &a_srcComps, const BoxLayoutData< T > &a_src, BoxLayoutData< T > &a_dest, const Interval &a_destComps, const Copier &a_copier, const LDOperator< T > &a_op=LDOperator< T >()) const

void	makeItSoBegin (const Interval &a_srcComps, const BoxLayoutData< T > &a_src, BoxLayoutData< T > &a_dest, const Interval &a_destComps, const Copier &a_copier, const LDOperator< T > &a_op=LDOperator< T >()) const

void	makeItSoLocalCopy (const Interval &a_srcComps, const BoxLayoutData< T > &a_src, BoxLayoutData< T > &a_dest, const Interval &a_destComps, const Copier &a_copier, const LDOperator< T > &a_op=LDOperator< T >()) const

void	makeItSoEnd (BoxLayoutData< T > &a_dest, const Interval &a_destComps, const LDOperator< T > &a_op=LDOperator< T >()) const

void	completePendingSends () const

void	allocateBuffers (const BoxLayoutData< 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 BoxLayoutData< 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

void	unpackReceivesToMe_append (LayoutData< Vector< RefCountedPtr< T > > > &a_dest, const Interval &a_destComps, int ncomp, const DataFactory< T > &factory, const LDOperator< T > &a_op) const

Detailed Description

template<class T>
class LevelData< T >

new code

Constructor & Destructor Documentation

◆ LevelData() [1/2]

template<class T >

LevelData< T >::LevelData ( )

◆ LevelData() [2/2]

template<class T>

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

◆ ~LevelData()

template<class T >

LevelData< T >::~LevelData ( )

virtual

Member Function Documentation

◆ define() [1/7]

template<class T>

void LevelData< T >::define	(	const DisjointBoxLayout &	dp,
		int	comps,
		const IntVect &	ghost = `IntVect::Zero`,
		const DataFactory< T > &	a_factory = `DefaultDataFactory<T>()`
	)

virtual

Referenced by aliasLevelData(), blockRead(), PetscSolver< LevelData< FArrayBox > >::computeResidual(), LevelDataOps< FArrayBox >::create(), PetscSolver< LevelData< FArrayBox > >::create_mat_vec(), LevelData< BaseFab< int > >::degenerate(), LevelData< BaseFab< int > >::degenerateLocalOnly(), LevelData< BaseFab< int > >::ghostVect(), BaseLevelHeatSolver< LevelData< FArrayBox >, FluxBox, LevelFluxRegister >::incrementFlux(), and read().

◆ define() [2/7]

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

◆ define() [3/7]

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()]

◆ copyTo() [1/8]

template<class T>

void LevelData< T >::copyTo	(	const Interval &	srcComps,
		BoxLayoutData< T > &	dest,
		const Interval &	destComps
	)		const

virtual

Referenced by LevelDataOps< FArrayBox >::assign(), LevelData< BaseFab< int > >::copyTo(), LevelData< BaseFab< int > >::define(), LevelData< BaseFab< int > >::degenerate(), and MergeSolver< T >::solve().

◆ localCopyTo() [1/2]

template<class T>

void LevelData< T >::localCopyTo	(	const Interval &	srcComps,
		LevelData< T > &	dest,
		const Interval &	destComps
	)		const

virtual

only works if source and dest have the same disjointboxlayout

Referenced by LevelData< BaseFab< int > >::localCopyTo().

◆ localCopyTo() [2/2]

template<class T>

void LevelData< T >::localCopyTo ( LevelData< T > & dest ) const

virtual

assumes source and dest have same interval

◆ copyTo() [2/8]

template<class T>

void LevelData< T >::copyTo ( BoxLayoutData< T > & dest ) const

virtual

Simplest case – assumes source and dest have same interval.

◆ copyTo() [3/8]

template<class T>

void LevelData< T >::copyTo	(	const Interval &	srcComps,
		BoxLayoutData< T > &	dest,
		const Interval &	destComps,
		const Copier &	copier,
		const LDOperator< T > &	a_op = `LDOperator<T>()`
	)		const

virtual

FM MOD START ////////////////////////// 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

◆ copyTo() [4/8]

template<class T>

void LevelData< T >::copyTo	(	BoxLayoutData< T > &	dest,
		const Copier &	copier,
		const LDOperator< T > &	a_op = `LDOperator<T>()`
	)		const

virtual

Simplest case – assumes source and dest have same interval.

◆ copyTo() [5/8]

template<class T>

void LevelData< T >::copyTo	(	const Interval &	srcComps,
		LevelData< T > &	dest,
		const Interval &	destComps
	)		const

virtual

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

◆ copyTo() [6/8]

template<class T>

void LevelData< T >::copyTo ( LevelData< T > & dest ) const

virtual

Simplest case – assumes source and dest have same interval.

◆ copyTo() [7/8]

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

◆ copyTo() [8/8]

template<class T>

void LevelData< T >::copyTo	(	LevelData< T > &	dest,
		const Copier &	copier,
		const LDOperator< T > &	a_op = `LDOperator<T>()`
	)		const

virtual

Simplest case – assumes source and dest have same interval.

◆ exchange() [1/4]

template<class T >

void LevelData< T >::exchange ( void )

virtual

Simplest case – do all components.

Referenced by PetscSolver< LevelData< FArrayBox > >::computeResidual(), PetscSolver< LevelData< FArrayBox > >::create_mat_vec(), and LevelData< BaseFab< int > >::exchange().

◆ exchange() [2/4]

template<class T >

void LevelData< T >::exchange ( const Copier & copier )

virtual

Simplest case – do all components. Accepts a pre-built copier.

◆ exchange() [3/4]

template<class T >

void LevelData< T >::exchange ( const Interval & comps )

virtual

Accepts an arbitrary component range.

◆ exchange() [4/4]

template<class T>

void LevelData< T >::exchange	(	const Interval &	comps,
		const Copier &	copier,
		const LDOperator< T > &	a_op = `LDOperator<T>()`
	)

virtual

The most general case – can accept an arbitrary component range, a pre-built Copier object, and an arbitrary accumulation operator.

◆ exchangeBegin()

template<class T >

void LevelData< T >::exchangeBegin ( const Copier & copier )

virtual

asynchronous exchange start. load and fire off messages.

◆ exchangeEnd()

template<class T >

void LevelData< T >::exchangeEnd ( )

virtual

finish asynchronous exchange

◆ exchangeNoOverlap()

template<class T >

void LevelData< T >::exchangeNoOverlap ( const Copier & copier )

virtual

◆ ghostVect()

template<class T>

const IntVect& LevelData< T >::ghostVect ( ) const

inline

Referenced by aliasLevelData(), blockWrite(), PetscSolver< LevelData< FArrayBox > >::computeResidual(), LevelData< BaseFab< int > >::copyTo(), LevelDataOps< FArrayBox >::create(), LevelData< BaseFab< int > >::localCopyTo(), MergeSolver< T >::solve(), and write().

◆ define() [4/7]

template<class T>

void LevelData< T >::define	(	const BoxLayout &	dp,
		int	comps,
		const DataFactory< T > &	factory
	)

virtual

Reimplemented from BoxLayoutData< T >.

◆ define() [5/7]

template<class T>

void LevelData< T >::define	(	const BoxLayoutData< T > &	da,
		const DataFactory< T > &	factory = `DefaultDataFactory<T>()`
	)

virtual

Reimplemented from BoxLayoutData< T >.

◆ define() [6/7]

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

◆ define() [7/7]

template<class T>

void LevelData< T >::define ( const BoxLayout & boxes )

virtual

overridden and throws an error.

Reimplemented from BoxLayoutData< T >.

◆ getBoxes()

template<class T>

const DisjointBoxLayout& LevelData< T >::getBoxes ( ) const

inline

Referenced by LevelData< BaseFab< int > >::copyTo().

◆ disjointBoxLayout()

template<class T>

const DisjointBoxLayout& LevelData< T >::disjointBoxLayout ( ) const

inline

Referenced by aliasLevelData(), PetscSolver< LevelData< FArrayBox > >::computeResidual(), LevelDataOps< FArrayBox >::create(), ViscousTensorOp::diagonalScale(), NWOViscousTensorOp::diagonalScale(), VCAMRPoissonOp2::diagonalScale(), ViscousTensorOp::divideByIdentityCoef(), NWOViscousTensorOp::divideByIdentityCoef(), VCAMRPoissonOp2::divideByIdentityCoef(), LevelDataOps< FArrayBox >::dotProduct(), BCFunction::fillGhostCells(), LevelDataOps< FArrayBox >::incr(), LevelData< BaseFab< int > >::localCopyTo(), LevelDataOps< FArrayBox >::mDotProduct(), and MergeSolver< T >::solve().

◆ apply() [1/2]

template<class T>

virtual void LevelData< T >::apply ( void(*)(const Box &, int, T &) a_Function )

virtual

User writes a function with the signature:

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

They can then hand this off to LayoutData::apply, which invokes this function for every T. The argument "box" is the Box (as known to the DisjointBoxLayout here) associated with that T and the argument "n_comps" is the number of components in this LevelData.

Your function must not be inline.

For example:

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

Referenced by LevelData< BaseFab< int > >::define(), LevelData< BaseFab< int > >::disjointBoxLayout(), and LevelData< T >::ApplyFunctor::~ApplyFunctor().

◆ apply() [2/2]

template<class T>

void LevelData< T >::apply ( const ApplyFunctor & f )

virtual

Like the other apply(), but here the argument is an instance of a class derived from LevelData::ApplyFunctor, and which implements ApplyFunctor's pure virtual void operator()(const Box& box, int n_comps, T& t) const.

Going with an instance of such a class is more convenient if you want the thing you pass to apply() to have state.

For example:

class MyFunctor : public LevelData<FArrayBox>::ApplyFunctor
{
public:
  MyFunctor( Real x ) : m_x(x)
  {
    ...
  }
  virtual void operator()(const Box& box, int n_comps, FArrayBox& fab) const
  {
    fab.setVal( m_x, box, 0, n_comps );
  }
private:
  const Real m_x;
}
LevelData<FArrayBox> data(layout, 3, IntVect::Unit);
data.apply( MyFunctor(3.14, 0) );

◆ degenerate()

template<class T>

void LevelData< T >::degenerate	(	LevelData< T > &	a_to,
		const SliceSpec &	a_ss
	)		const

Referenced by LevelData< T >::ApplyFunctor::~ApplyFunctor().

◆ degenerateLocalOnly()

template<class T>

void LevelData< T >::degenerateLocalOnly	(	LevelData< T > &	a_to,
		const SliceSpec &	a_ss
	)		const

version of degenerate which does strictly local copying

this means that it maintains source ghost cell values in the destination

Referenced by LevelData< T >::ApplyFunctor::~ApplyFunctor().

Friends And Related Function Documentation

◆ aliasLevelData

template<class T>

void aliasLevelData	(	LevelData< T > &	a_alias,
		LevelData< T > *	a_original,
		const Interval &	a_interval
	)

friend

Data over a disjoint union of rectangles.

LevelData aliasing function.

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.

Parameters

a_alias	aliased LevelData<T> object. original data in a_alias is destroyed and new aliasing role assumed.
a_original	pointer to LevelData<T> that will be aliased.
a_interval	range of components of each T in a_original that will be created in the a_alias argument.

LevelData<FArrayBox> original(dbl, 4, 2*IntVect::Unit);
Interval             subcomps(2, 3);
LevelData<FArrayBox> alias;
aliasLevelData<FArrayBox>(alias, &original, subcomps);
// component 0 of every FArrayBox in alias references the same data as
// component 2 in original

The template class T must have an 'alias' constructor

class A
 {
public:
  A(const Interval& subcomps, A& original);// alias constructor
  ...
 };

Member Data Documentation

◆ m_disjointBoxLayout

template<class T>

DisjointBoxLayout LevelData< T >::m_disjointBoxLayout

protected

Referenced by LevelData< BaseFab< int > >::apply(), LevelData< BaseFab< int > >::copyTo(), LevelData< BaseFab< int > >::define(), LevelData< BaseFab< int > >::degenerate(), LevelData< BaseFab< int > >::degenerateLocalOnly(), LevelData< BaseFab< int > >::disjointBoxLayout(), LevelData< BaseFab< int > >::exchange(), LevelData< BaseFab< int > >::getBoxes(), and LevelData< BaseFab< int > >::LevelData().

◆ m_ghost

template<class T>

IntVect LevelData< T >::m_ghost

protected

Referenced by LevelData< BaseFab< int > >::copyTo(), LevelData< BaseFab< int > >::define(), LevelData< BaseFab< int > >::degenerate(), LevelData< BaseFab< int > >::degenerateLocalOnly(), LevelData< BaseFab< int > >::exchange(), LevelData< BaseFab< int > >::ghostVect(), and LevelData< BaseFab< int > >::LevelData().

◆ m_exchangeCopier

template<class T>

Copier LevelData< T >::m_exchangeCopier

protected

Referenced by LevelData< BaseFab< int > >::define(), LevelData< BaseFab< int > >::exchange(), and LevelData< BaseFab< int > >::LevelData().

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

Classes

Public Member Functions

Protected Attributes

Friends

Additional Inherited Members

Detailed Description

template<class T> class LevelData< T >

Constructor & Destructor Documentation

◆ LevelData() [1/2]

◆ LevelData() [2/2]

◆ ~LevelData()

Member Function Documentation

◆ define() [1/7]

◆ define() [2/7]

◆ define() [3/7]

◆ copyTo() [1/8]

◆ localCopyTo() [1/2]

◆ localCopyTo() [2/2]

◆ copyTo() [2/8]

◆ copyTo() [3/8]

◆ copyTo() [4/8]

◆ copyTo() [5/8]

◆ copyTo() [6/8]

◆ copyTo() [7/8]

◆ copyTo() [8/8]

◆ exchange() [1/4]

◆ exchange() [2/4]

◆ exchange() [3/4]

◆ exchange() [4/4]

◆ exchangeBegin()

◆ exchangeEnd()

◆ exchangeNoOverlap()

◆ ghostVect()

◆ define() [4/7]

◆ define() [5/7]

◆ define() [6/7]

◆ define() [7/7]

◆ getBoxes()

◆ disjointBoxLayout()

◆ apply() [1/2]

◆ apply() [2/2]

◆ degenerate()

◆ degenerateLocalOnly()

Friends And Related Function Documentation

◆ aliasLevelData

Member Data Documentation

◆ m_disjointBoxLayout

◆ m_ghost

◆ m_exchangeCopier

template<class T>
class LevelData< T >