Class LocallyActiveDataRefinePatchStrategy is an abstract base class that defines a Strategy pattern interface for operations that a user may supply for application-specific refining of locally-active data between levels in an AMR patch hierarchy and filling of physical boundary values.
A concrete subclass must define four member functions to perform the following tasks: More...

#include <LocallyActiveDataRefinePatchStrategy.h>

Inheritance diagram for SAMRAI::xfer::LocallyActiveDataRefinePatchStrategy< DIM >:

[legend]

Public Member Functions
	LocallyActiveDataRefinePatchStrategy ()

virtual	~LocallyActiveDataRefinePatchStrategy ()

virtual hier::IntVector< DIM >	getRefineOpStencilWidth () const =0

virtual void	setPhysicalBoundaryConditions (hier::Patch< DIM > &patch, const tbox::List< int > &scratch_data_ids, const double fill_time, const hier::IntVector< DIM > &ghost_width_to_fill)=0

virtual void	preprocessRefine (hier::Patch< DIM > &fine, const hier::Patch< DIM > &coarse, const tbox::List< int > &scratch_data_ids, const hier::Box< DIM > &fine_box, const hier::IntVector< DIM > &ratio)=0

virtual void	postprocessRefine (hier::Patch< DIM > &fine, const hier::Patch< DIM > &coarse, const tbox::List< int > &scratch_data_ids, const hier::Box< DIM > &fine_box, const hier::IntVector< DIM > &ratio)=0

void	setPhysicalBoundaryConditions (hier::Patch< DIM > &patch, const tbox::List< const typename xfer::RefineClasses< DIM >::Data * > &refine_data, const double fill_time, const hier::IntVector< DIM > &ghost_width_to_fill)

void	preprocessRefineBoxes (hier::Patch< DIM > &fine, const hier::Patch< DIM > &coarse, const xfer::LocallyActiveDataFillBoxSet< DIM > &fine_boxes, const hier::IntVector< DIM > &ratio)

void	postprocessRefineBoxes (hier::Patch< DIM > &fine, const hier::Patch< DIM > &coarse, const xfer::LocallyActiveDataFillBoxSet< DIM > &fine_boxes, const hier::IntVector< DIM > &ratio)

Detailed Description

template<int DIM>
class SAMRAI::xfer::LocallyActiveDataRefinePatchStrategy< DIM >

define maximum stencil width for user-defined refine operations
fill physical boundary conditions
preprocess the interpolation
postprocess the interpolation

Note that the preprocess member function is called before standard data refine using RefineOperators and the postprocessor member function is called afterwards.

There are two versions of the preprocess and postprocess functions. The default abstract function only takes a single box. The user may also over-ride preprocess and postprocess functions that take a box list and process an entire patch at one time. By default, the box list version loops over all of the boxes in the box list and calls the other version.

See also: xfer::LocallyActiveDataRefineAlgorithm; xfer::RefineSchedule

Constructor & Destructor Documentation

◆ LocallyActiveDataRefinePatchStrategy()

template<int DIM>

SAMRAI::xfer::LocallyActiveDataRefinePatchStrategy< DIM >::LocallyActiveDataRefinePatchStrategy ( )

The constructor for patch strategy does nothing interesting.

◆ ~LocallyActiveDataRefinePatchStrategy()

template<int DIM>

virtual SAMRAI::xfer::LocallyActiveDataRefinePatchStrategy< DIM >::~LocallyActiveDataRefinePatchStrategy ( )

virtual

The virtual destructor for refine strategy does nothing interesting.

Member Function Documentation

◆ getRefineOpStencilWidth()

template<int DIM>

virtual hier::IntVector<DIM> SAMRAI::xfer::LocallyActiveDataRefinePatchStrategy< DIM >::getRefineOpStencilWidth ( ) const

pure virtual

Pure virtual function to return maximum stencil width needed over user-defined data interpolation operations. This is needed to determine the correct interpolation data dependencies.

◆ setPhysicalBoundaryConditions() [1/2]

template<int DIM>

virtual void SAMRAI::xfer::LocallyActiveDataRefinePatchStrategy< DIM >::setPhysicalBoundaryConditions	(	hier::Patch< DIM > &	patch,
		const tbox::List< int > &	scratch_data_ids,
		const double	fill_time,
		const hier::IntVector< DIM > &	ghost_width_to_fill
	)

pure virtual

Pure virtual function to set data associated with the given list of patch data indices at patch boundaries that intersect the physical domain boundary. The specific boundary conditions are determined by the user. The patch data components set in this routine correspond to the "scratch" components specified in calls to the registerRefine() function in the LocallyActiveDataRefineAlgorithm class.

Parameters

patch	Patch on which to fill boundary data.
scratch_data_ids	List of integer patch data ids to set.
fill_time	Double simulation time for boundary filling.
ghost_width_to_fill	Integer vector describing maximum ghost width to fill over all registered scratch components.

◆ preprocessRefine()

template<int DIM>

virtual void SAMRAI::xfer::LocallyActiveDataRefinePatchStrategy< DIM >::preprocessRefine	(	hier::Patch< DIM > &	fine,
		const hier::Patch< DIM > &	coarse,
		const tbox::List< int > &	scratch_data_ids,
		const hier::Box< DIM > &	fine_box,
		const hier::IntVector< DIM > &	ratio
	)

pure virtual

Pure virtual function to perform user-defined preprocess data refine operations. This member function is called before standard refine operations (expressed using concrete subclasses of the RefineOperator<DIM> base class). The preprocess function must refine data from the scratch components of the coarse patch into the scratch components of the fine patch on the specified fine box region. Recall that the scratch components are specified in calls to the registerRefine() function in the LocallyActiveDataRefineAlgorithm<DIM> class.

Parameters

fine	Fine patch containing destination data.
coarse	Coarse patch containing source data.
scratch_data_ids	List of integer patch data ids to preprocess.
fine_box	Box region on fine patch into which data is refined.
ratio	Integer vector containing ratio relating index space between coarse and fine patches.

◆ postprocessRefine()

template<int DIM>

virtual void SAMRAI::xfer::LocallyActiveDataRefinePatchStrategy< DIM >::postprocessRefine	(	hier::Patch< DIM > &	fine,
		const hier::Patch< DIM > &	coarse,
		const tbox::List< int > &	scratch_data_ids,
		const hier::Box< DIM > &	fine_box,
		const hier::IntVector< DIM > &	ratio
	)

pure virtual

Pure virtual function to perform user-defined preprocess data refine operations. This member function is called after standard refine operations (expressed using concrete subclasses of the RefineOperator<DIM> base class). The postprocess function must refine data from the scratch components of the coarse patch into the scratch components of the fine patch on the specified fine box region. Recall that the scratch components are specified in calls to the registerRefine() function in the LocallyActiveDataRefineAlgorithm<DIM> class.

Parameters

fine	Fine patch containing destination data.
coarse	Coarse patch containing source data.
scratch_data_ids	List of integer patch data ids to preprocess.
fine_box	Box region on fine patch into which data is refined.
ratio	Integer vector containing ratio relating index space between coarse and fine patches.

◆ setPhysicalBoundaryConditions() [2/2]

template<int DIM>

void SAMRAI::xfer::LocallyActiveDataRefinePatchStrategy< DIM >::setPhysicalBoundaryConditions	(	hier::Patch< DIM > &	patch,
		const tbox::List< const typename xfer::RefineClasses< DIM >::Data * > &	refine_data,
		const double	fill_time,
		const hier::IntVector< DIM > &	ghost_width_to_fill
	)

Virtual function to set data associated with the given list of patch data indices at patch boundaries that intersect the physical domain boundary. The specific boundary conditions are determined by the user. The patch data components set in this routine correspond to the "scratch" data indices specified in calls to the registerRefine() function in the LocallyActiveDataRefineAlgorithm class.

Typically, only the pure virtual members of this class are implemented in user-defined subclasses of this base class. This version of the boundary data function calls the single-box version, which is a pure virtual function.

Parameters

patch	Patch on which to fill boundary data.
refine_data	List of refine class items to set.
fill_time	Double simulation time for boundary filling.
ghost_width_to_fill	Integer vector describing maximum ghost width to fill over all registered scratch components.

◆ preprocessRefineBoxes()

template<int DIM>

void SAMRAI::xfer::LocallyActiveDataRefinePatchStrategy< DIM >::preprocessRefineBoxes	(	hier::Patch< DIM > &	fine,
		const hier::Patch< DIM > &	coarse,
		const xfer::LocallyActiveDataFillBoxSet< DIM > &	fine_boxes,
		const hier::IntVector< DIM > &	ratio
	)

Virtual function to perform user-defined refine operations. This member function is called before standard refining operations (expressed using concrete subclasses of the RefineOperator<DIM> base class). The preprocess function must refine data from the scratch components of the coarse patch into the scratch components of the fine patch on the specified fine box regions.

Typically, only the pure virtual members of this class are implemented in user-defined subclasses of this base class. This version of the preprocess function operates on an entire box list. By default, this version simply loops over the box list and calls the single-box version, which is a pure virtual function.

Parameters

fine	Fine patch containing destination data.
coarse	Coarse patch containing source data.
fine_boxes	Fill box set containing box regions and information about which data is to be refined.
ratio	Integer vector containing ratio relating index space between coarse and fine patches.

◆ postprocessRefineBoxes()

template<int DIM>

void SAMRAI::xfer::LocallyActiveDataRefinePatchStrategy< DIM >::postprocessRefineBoxes	(	hier::Patch< DIM > &	fine,
		const hier::Patch< DIM > &	coarse,
		const xfer::LocallyActiveDataFillBoxSet< DIM > &	fine_boxes,
		const hier::IntVector< DIM > &	ratio
	)

Virtual function to perform user-defined refine operations. This member function is called after standard refining operations (expressed using concrete subclasses of the RefineOperator<DIM> base class). The postprocess function must refine data from the scratch components of the coarse patch into the scratch components of the fine patch on the specified fine box regions.

Typically, only the pure virtual members of this class are implemented in user-defined subclasses of this base class. This version of the postprocess function operates on an entire box list. By default, this version simply loops over the box list and calls the single-box version, which is a pure virtual function.

Parameters

fine	Fine patch containing destination data.
coarse	Coarse patch containing source data.
fine_boxes	Fill box set containing box regions and information about which data is to be refined.
ratio	Integer vector containing ratio relating index space between coarse and fine patches.

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

/samrai/include/LocallyActiveDataRefinePatchStrategy.h

Public Member Functions

Detailed Description

template<int DIM> class SAMRAI::xfer::LocallyActiveDataRefinePatchStrategy< DIM >

Constructor & Destructor Documentation

◆ LocallyActiveDataRefinePatchStrategy()

◆ ~LocallyActiveDataRefinePatchStrategy()

Member Function Documentation

◆ getRefineOpStencilWidth()

◆ setPhysicalBoundaryConditions() [1/2]

◆ preprocessRefine()

◆ postprocessRefine()

◆ setPhysicalBoundaryConditions() [2/2]

◆ preprocessRefineBoxes()

◆ postprocessRefineBoxes()

template<int DIM>
class SAMRAI::xfer::LocallyActiveDataRefinePatchStrategy< DIM >