SAMRAI::algs::MblkPatchBoundaryNodeSum< DIM > Class Template Reference

Class MblkPatchBoundaryNodeSum provides operations for summing node data values at nodes that are shared by multiple patches on a single level or across multiple hierarchy levels. More...

#include <source/algorithm/femutils/standard/MblkPatchBoundaryNodeSum.h>

List of all members.

Public Member Functions
	MblkPatchBoundaryNodeSum (const std::string &object_name, tbox::Pointer< hier::MultiblockPatchHierarchy< DIM > > hierarchy)
	Constructor initializes object to default (mostly undefined) state.
	~MblkPatchBoundaryNodeSum ()
	Destructor for the schedule releases all internal storage.
void	registerSum (int node_data_id)
	Register node data with given patch data identifier for summing.
void	setupSum (tbox::Pointer< hier::MultiblockPatchLevel< DIM > > level)
	Set up summation operations for node data across shared nodes on a single level.
void	computeSum (const bool fill_hanging_nodes=false) const
	Compute sum of node values at each shared node and replace each such node value with the corresponding sum.

---

Detailed Description

template<int DIM>
class SAMRAI::algs::MblkPatchBoundaryNodeSum< DIM >

Class MblkPatchBoundaryNodeSum provides operations for summing node data values at nodes that are shared by multiple patches on a single level or across multiple hierarchy levels.

Usage of a patch boundry node sum involves the following sequence of steps:

1. Construct a patch boundry node sum object. For example,

    *         MblkPatchBoundaryNodeSum<DIM> my_node_sum("My Node Sum");
    *     

2. Register node data quantities to sum. For example,

    *         my_node_sum.registerSum(node_data_id1);
    *         my_node_sum.registerSum(node_data_id2);
    *         etc...
    *     

3. Setup the sum operations for either single level or a range of levels in a patch hierarchy. For example,

    *         my_node_sum.setupSum(level);    // single level
    *         -- or --
    *         my_node_sum.setupSum(hierarchy, coarsest_ln, finest_ln);  // multiple levels
    *     

4. Execute the sum operation. For example,

    *         my_node_sum.computeSum()
    *     

The result of these operations is that each node patch data value associated with the registered ids at patch boundaries, on either the single level or range of hierarchy levels, is replaced by the sum of all data values at the node.

Note that only one of the setupSum() functions may be called once a MblkPatchBoundaryNodeSum<DIM> object is created.

---

Constructor & Destructor Documentation

template<int DIM>

SAMRAI::algs::MblkPatchBoundaryNodeSum< DIM >::MblkPatchBoundaryNodeSum	(	const std::string &	object_name,
		tbox::Pointer< hier::MultiblockPatchHierarchy< DIM > >	hierarchy
	)

Constructor initializes object to default (mostly undefined) state.

Parameters:

	object_name	const std::string reference for name of object used in error reporting. When assertion checking is on, the string cannot be empty.
	hierarchy	the hierarchy.

template<int DIM>

SAMRAI::algs::MblkPatchBoundaryNodeSum< DIM >::~MblkPatchBoundaryNodeSum

(

)

Destructor for the schedule releases all internal storage.

---

Member Function Documentation

template<int DIM>

void SAMRAI::algs::MblkPatchBoundaryNodeSum< DIM >::registerSum

(

int

node_data_id

)

Register node data with given patch data identifier for summing.

Parameters:

node_data_id

integer patch data index for node data to sum

The node data id must be a valid patch data id (>=0) and must correspond to node-centered double data. If not, an error will result.

template<int DIM>

void SAMRAI::algs::MblkPatchBoundaryNodeSum< DIM >::setupSum

(

tbox::Pointer< hier::MultiblockPatchLevel< DIM > >

level

)

Set up summation operations for node data across shared nodes on a single level.

If the other setupSum() function for a range of hierarchy levels has been called previously for this object, an error will result.

Parameters:

level

pointer to level on which to perform node sum

When assertion checking is active, the level pointer cannot be null.

template<int DIM>

void SAMRAI::algs::MblkPatchBoundaryNodeSum< DIM >::computeSum

(

const bool

fill_hanging_nodes = false

)

const

Compute sum of node values at each shared node and replace each such node value with the corresponding sum.

At the end of this method, all values at shared node locations on patch boundaries (on levels indicated by the call to one of the setupSum() routines) will have the same value.

When the setupSum() method taking a range of patch levels in a hierarchy is called, this method will compute the sum of nodal quantities at all the specified patch boundaries. For nodes at a coarse-fine boundary, nodal sums will only be performed where the coarse and fine nodes overlap. A node on a fine level that is not also a node on the next coarser level (a so-called "hanging node") will not be summed.

The boolean "fill_hanging_nodes" argument specifies whether the the hanging nodes should be filled using linearly interpolated values from neighboring non-hanging nodes (i.e. those that overlap nodes on a coarse level). The correct steps required to deal with hanging nodes is algorithm dependent so, if left unspecified, values at the hanging nodes will not be adjusted. However, because many algorithms average hanging nodes we provide the capability to do it here. Note that the hanging node interpolation provided does not take into consideration the spatial location of the nodes. So the interpolation may not be correct for coordinate systems other than standard Cartesian grid geometry.

Parameters:

fill_hanging_nodes

Optional boolean value specifying whether hanging node values should be set to values interpolated from neighboring non-hanging node values. The default is false.

---

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

• source/algorithm/femutils/standard/MblkPatchBoundaryNodeSum.h
• source/algorithm/femutils/standard/MblkPatchBoundaryNodeSum.C

---