Reference documentation for deal.II version Git 5c5b3d5 20141218 22:38:04 +0100

#include <deal.II/dofs/function_map.h>
Public Types  
typedef std::map < types::boundary_id, const Function< dim, Number > * >  type 
This class declares a local typedef that denotes a mapping between a boundary indicator (see GlossBoundaryIndicator) that is used to describe what kind of boundary condition holds on a particular piece of the boundary, and the function describing the actual function that provides the boundary values on this part of the boundary. This type is required in many functions in the library where, for example, we need to know about the functions \(h_i(\mathbf x)\) used in boundary conditions
\begin{align*} \mathbf n \cdot \nabla u = h_i \qquad \qquad \text{on}\ \Gamma_i\subset\partial\Omega. \end{align*}
An example is the function KellyErrorEstimator::estimate() that allows us to provide a set of functions \(h_i\) for all those boundary indicators \(i\) for which the boundary condition is supposed to be of Neumann type. Of course, the same kind of principle can be applied to cases where we care about Dirichlet values, where one needs to provide a map from boundary indicator \(i\) to Dirichlet function \(h_i\) if the boundary conditions are given as
\begin{align*} u = h_i \qquad \qquad \text{on}\ \Gamma_i\subset\partial\Omega. \end{align*}
This is, for example, the case for the VectorTools::interpolate() functions.
Tutorial programs step6, step7 and step8 show examples of how to use function arguments of this type in situations where we actually have an empty map (i.e., we want to describe that no part of the boundary is a Neumann boundary). step16 actually uses it in a case where one of the parts of the boundary uses a boundary indicator for which we want to use a function object.
It seems odd at first to declare this typedef inside a class, rather than declaring a typedef at global scope. The reason is that C++ does not allow to define templated typedefs, where here in fact we want a typdef that depends on the space dimension. (Defining templated typedefs is something that is possible starting with the C++11 standard, but that wasn't possible within the C++98 standard in place when this programming pattern was conceived.)
Definition at line 66 of file function_map.h.
typedef std::map<types::boundary_id, const Function<dim,Number>*> FunctionMap< dim, Number >::type 
Declare the type as discussed above. Since we can't name it FunctionMap (as that would ambiguate a possible constructor of this class), name it in the fashion of the STL local typedefs.
Definition at line 73 of file function_map.h.