Static Public Member Functions | |
template<int dim, int spacedim> | |
static void | compute_row_length_vector (const MGDoFHandler< dim, spacedim > &dofs, const unsigned int level, std::vector< unsigned int > &row_lengths, const DoFTools::Coupling flux_couplings=DoFTools::none) |
template<int dim, int spacedim> | |
static void | compute_row_length_vector (const MGDoFHandler< dim, spacedim > &dofs, const unsigned int level, std::vector< unsigned int > &row_lengths, const Table< 2, DoFTools::Coupling > &couplings, const Table< 2, DoFTools::Coupling > &flux_couplings) |
template<int dim, class SparsityPattern , int spacedim> | |
static void | make_sparsity_pattern (const MGDoFHandler< dim, spacedim > &dof_handler, SparsityPattern &sparsity, const unsigned int level) |
template<int dim, class SparsityPattern , int spacedim> | |
static void | make_flux_sparsity_pattern (const MGDoFHandler< dim, spacedim > &dof_handler, SparsityPattern &sparsity, const unsigned int level) |
template<int dim, class SparsityPattern , int spacedim> | |
static void | make_flux_sparsity_pattern_edge (const MGDoFHandler< dim, spacedim > &dof_handler, SparsityPattern &sparsity, const unsigned int level) |
template<int dim, class SparsityPattern , int spacedim> | |
static void | make_flux_sparsity_pattern (const MGDoFHandler< dim, spacedim > &dof, SparsityPattern &sparsity, const unsigned int level, const Table< 2, DoFTools::Coupling > &int_mask, const Table< 2, DoFTools::Coupling > &flux_mask) |
template<int dim, class SparsityPattern , int spacedim> | |
static void | make_flux_sparsity_pattern_edge (const MGDoFHandler< dim, spacedim > &dof_handler, SparsityPattern &sparsity, const unsigned int level, const Table< 2, DoFTools::Coupling > &flux_mask) |
template<int dim, int spacedim> | |
static void | count_dofs_per_block (const MGDoFHandler< dim, spacedim > &mg_dof, std::vector< std::vector< unsigned int > > &result, std::vector< unsigned int > target_block=std::vector< unsigned int >()) |
template<int dim, int spacedim> | |
static void | count_dofs_per_component (const MGDoFHandler< dim, spacedim > &mg_dof, std::vector< std::vector< unsigned int > > &result, const bool only_once=false, std::vector< unsigned int > target_component=std::vector< unsigned int >()) |
template<int dim, int spacedim> | |
static void | count_dofs_per_component (const MGDoFHandler< dim, spacedim > &mg_dof, std::vector< std::vector< unsigned int > > &result, std::vector< unsigned int > target_component) |
template<int dim, int spacedim> | |
static void | make_boundary_list (const MGDoFHandler< dim, spacedim > &mg_dof, const typename FunctionMap< dim >::type &function_map, std::vector< std::set< unsigned int > > &boundary_indices, const std::vector< bool > &component_mask=std::vector< bool >()) |
template<typename number > | |
static void | apply_boundary_values (const std::set< unsigned int > &boundary_dofs, SparseMatrix< number > &matrix, const bool preserve_symmetry) |
template<typename number > | |
static void | apply_boundary_values (const std::set< unsigned int > &boundary_dofs, BlockSparseMatrix< number > &matrix, const bool preserve_symmetry) |
template<int dim, typename number , int spacedim> | |
static void | reinit_vector (const MGDoFHandler< dim, spacedim > &mg_dof, MGLevelObject< Vector< number > > &vector) |
template<int dim, typename number , int spacedim> | |
static void | reinit_vector (const MGDoFHandler< dim, spacedim > &mg_dof, MGLevelObject< BlockVector< number > > &vector) |
template<int dim, typename number , int spacedim> | |
static void | reinit_vector_by_blocks (const MGDoFHandler< dim, spacedim > &mg_dof, MGLevelObject< Vector< number > > &v, const unsigned int selected, std::vector< std::vector< unsigned int > > &cached_sizes) |
template<int dim, typename number , int spacedim> | |
static void | reinit_vector_by_blocks (const MGDoFHandler< dim, spacedim > &mg_dof, MGLevelObject< BlockVector< number > > &v, const std::vector< bool > &selected, std::vector< std::vector< unsigned int > > &cached_sizes) |
template<int dim, typename number , int spacedim> | |
static void | reinit_vector_by_components (const MGDoFHandler< dim, spacedim > &mg_dof, MGLevelObject< BlockVector< number > > &v, const std::vector< bool > &selected, const std::vector< unsigned int > &target_component, std::vector< std::vector< unsigned int > > &cached_sizes) |
template<int dim, typename number , int spacedim> | |
static void | reinit_vector_by_components (const MGDoFHandler< dim, spacedim > &mg_dof, MGLevelObject< Vector< number > > &v, const std::vector< bool > &selected, const std::vector< unsigned int > &target_component, std::vector< std::vector< unsigned int > > &cached_sizes) |
This is a collection of functions operating on, and manipulating the numbers of degrees of freedom in a multilevel triangulation. It is similar in purpose and function to the DoFTools
class, but operates on MGDoFHandler
objects instead of DoFHandler objects. See there and the documentation of the member functions for more information.
All member functions are static, so there is no need to create an object of class MGTools.
static void MGTools::compute_row_length_vector | ( | const MGDoFHandler< dim, spacedim > & | dofs, | |
const unsigned int | level, | |||
std::vector< unsigned int > & | row_lengths, | |||
const DoFTools::Coupling | flux_couplings = DoFTools::none | |||
) | [inline, static] |
Compute row length vector for multilevel methods.
static void MGTools::compute_row_length_vector | ( | const MGDoFHandler< dim, spacedim > & | dofs, | |
const unsigned int | level, | |||
std::vector< unsigned int > & | row_lengths, | |||
const Table< 2, DoFTools::Coupling > & | couplings, | |||
const Table< 2, DoFTools::Coupling > & | flux_couplings | |||
) | [inline, static] |
Compute row length vector for multilevel methods with optimization for block couplings.
static void MGTools::make_sparsity_pattern | ( | const MGDoFHandler< dim, spacedim > & | dof_handler, | |
SparsityPattern & | sparsity, | |||
const unsigned int | level | |||
) | [inline, static] |
Write the sparsity structure of the matrix belonging to the specified level
. The sparsity pattern is not compressed, so before creating the actual matrix you have to compress the matrix yourself, using SparseMatrixStruct::compress()
.
There is no need to consider hanging nodes here, since only one level is considered.
static void MGTools::make_flux_sparsity_pattern | ( | const MGDoFHandler< dim, spacedim > & | dof_handler, | |
SparsityPattern & | sparsity, | |||
const unsigned int | level | |||
) | [inline, static] |
Make a sparsity pattern including fluxes of discontinuous Galerkin methods. make_sparsity_pattern DoFTools
static void MGTools::make_flux_sparsity_pattern_edge | ( | const MGDoFHandler< dim, spacedim > & | dof_handler, | |
SparsityPattern & | sparsity, | |||
const unsigned int | level | |||
) | [inline, static] |
Create sparsity pattern for the fluxes at refinement edges. The matrix maps a function of the fine level space level
to the coarser space.
static void MGTools::make_flux_sparsity_pattern | ( | const MGDoFHandler< dim, spacedim > & | dof, | |
SparsityPattern & | sparsity, | |||
const unsigned int | level, | |||
const Table< 2, DoFTools::Coupling > & | int_mask, | |||
const Table< 2, DoFTools::Coupling > & | flux_mask | |||
) | [inline, static] |
This function does the same as the other with the same name, but it gets two additional coefficient matrices. A matrix entry will only be generated for two basis functions, if there is a non-zero entry linking their associated components in the coefficient matrix.
There is one matrix for couplings in a cell and one for the couplings occuring in fluxes.
static void MGTools::make_flux_sparsity_pattern_edge | ( | const MGDoFHandler< dim, spacedim > & | dof_handler, | |
SparsityPattern & | sparsity, | |||
const unsigned int | level, | |||
const Table< 2, DoFTools::Coupling > & | flux_mask | |||
) | [inline, static] |
Create sparsity pattern for the fluxes at refinement edges. The matrix maps a function of the fine level space level
to the coarser space. This is the version restricting the pattern to the elements actually needed.
static void MGTools::count_dofs_per_block | ( | const MGDoFHandler< dim, spacedim > & | mg_dof, | |
std::vector< std::vector< unsigned int > > & | result, | |||
std::vector< unsigned int > | target_block = std::vector< unsigned int >() | |||
) | [inline, static] |
Count the dofs block-wise on each level.
Result is a vector containing for each level a vector containing the number of dofs for each block (access is result[level][block]
).
static void MGTools::count_dofs_per_component | ( | const MGDoFHandler< dim, spacedim > & | mg_dof, | |
std::vector< std::vector< unsigned int > > & | result, | |||
const bool | only_once = false , |
|||
std::vector< unsigned int > | target_component = std::vector< unsigned int >() | |||
) | [inline, static] |
Count the dofs component-wise on each level.
Result is a vector containing for each level a vector containing the number of dofs for each component (access is result[level][component]
).
static void MGTools::count_dofs_per_component | ( | const MGDoFHandler< dim, spacedim > & | mg_dof, | |
std::vector< std::vector< unsigned int > > & | result, | |||
std::vector< unsigned int > | target_component | |||
) | [inline, static] |
static void MGTools::make_boundary_list | ( | const MGDoFHandler< dim, spacedim > & | mg_dof, | |
const typename FunctionMap< dim >::type & | function_map, | |||
std::vector< std::set< unsigned int > > & | boundary_indices, | |||
const std::vector< bool > & | component_mask = std::vector< bool >() | |||
) | [inline, static] |
Generate a list of those degrees of freedom at the boundary which should be eliminated from the matrix.
This is the multilevel equivalent of VectorTools::interpolate_boundary_values, but since the multilevel method does not have its own right hand side, the function values are ignored.
boundary_indices
is a vector which on return contains all indices of boundary constraint degrees of freedom for each level. Its length has to match the number of levels. static void MGTools::apply_boundary_values | ( | const std::set< unsigned int > & | boundary_dofs, | |
SparseMatrix< number > & | matrix, | |||
const bool | preserve_symmetry | |||
) | [inline, static] |
static void MGTools::apply_boundary_values | ( | const std::set< unsigned int > & | boundary_dofs, | |
BlockSparseMatrix< number > & | matrix, | |||
const bool | preserve_symmetry | |||
) | [inline, static] |
static void MGTools::reinit_vector | ( | const MGDoFHandler< dim, spacedim > & | mg_dof, | |
MGLevelObject< Vector< number > > & | vector | |||
) | [inline, static] |
Ajust vectors on all levels to correct size. Here, we just count the numbers of degrees of freedom on each level and reinit
each level vector to this length.
static void MGTools::reinit_vector | ( | const MGDoFHandler< dim, spacedim > & | mg_dof, | |
MGLevelObject< BlockVector< number > > & | vector | |||
) | [inline, static] |
Ajust vectors on all levels to correct size. Here, we just count the numbers of degrees of freedom on each level and reinit
each level vector to this length.
static void MGTools::reinit_vector_by_blocks | ( | const MGDoFHandler< dim, spacedim > & | mg_dof, | |
MGLevelObject< Vector< number > > & | v, | |||
const unsigned int | selected, | |||
std::vector< std::vector< unsigned int > > & | cached_sizes | |||
) | [inline, static] |
Adjust vectors on all levels to correct size. The degrees of freedom on each level are counted by block and only the block selected is used.
static void MGTools::reinit_vector_by_blocks | ( | const MGDoFHandler< dim, spacedim > & | mg_dof, | |
MGLevelObject< BlockVector< number > > & | v, | |||
const std::vector< bool > & | selected, | |||
std::vector< std::vector< unsigned int > > & | cached_sizes | |||
) | [inline, static] |
Adjust block vectors on all levels to correct size. The degrees of freedom on each level are counted by block.
static void MGTools::reinit_vector_by_components | ( | const MGDoFHandler< dim, spacedim > & | mg_dof, | |
MGLevelObject< BlockVector< number > > & | v, | |||
const std::vector< bool > & | selected, | |||
const std::vector< unsigned int > & | target_component, | |||
std::vector< std::vector< unsigned int > > & | cached_sizes | |||
) | [inline, static] |
Adjust block-vectors on all levels to correct size. Count the numbers of degrees of freedom on each level component-wise. Then, assign each block of vector
the corresponding size.
The boolean field selected
allows restricting this operation to certain components. In this case, vector
will only have as many blocks as there are true values in selected
(no blocks of length zero are padded in). If this argument is omitted, all blocks will be considered.
Degrees of freedom must be sorted by component in order to obtain reasonable results from this function.
The argument target_component
allows to re-sort and group components as in DoFRenumbering::component_wise.
static void MGTools::reinit_vector_by_components | ( | const MGDoFHandler< dim, spacedim > & | mg_dof, | |
MGLevelObject< Vector< number > > & | v, | |||
const std::vector< bool > & | selected, | |||
const std::vector< unsigned int > & | target_component, | |||
std::vector< std::vector< unsigned int > > & | cached_sizes | |||
) | [inline, static] |
Adjust vectors on all levels to correct size. Count the numbers of degrees of freedom on each level component-wise in a single component. Then, assign vector
the corresponding size.
The boolean field selected
may be nonzero in a single component, indicating the block of a block vector the argument v
corresponds to.
Degrees of freedom must be sorted by component in order to obtain reasonable results from this function.
The argument target_component
allows to re-sort and groupt components as in DoFRenumbering::component_wise.