Reference documentation for deal.II version Git aba33d3846 2022-01-19 21:43:57 -0500
internal::hp::DoFHandlerImplementation Namespace Reference

## Classes

struct  Implementation

## Functions

template<int dim, int spacedim>
void communicate_future_fe_indices (DoFHandler< dim, spacedim > &dof_handler)

template<int dim, int spacedim = dim>
unsigned int dominated_future_fe_on_children (const typename DoFHandler< dim, spacedim >::cell_iterator &parent)

static ::ExceptionBaseExcNoDominatedFiniteElementOnChildren ()

## ◆ communicate_future_fe_indices()

template<int dim, int spacedim>
 void internal::hp::DoFHandlerImplementation::communicate_future_fe_indices ( DoFHandler< dim, spacedim > & dof_handler )

Given a DoFHandler object in hp-mode, make sure that the future FE indices that a user has set for locally owned cells are communicated to all other relevant cells as well.

For parallel::shared::Triangulation objects, this information is distributed on both ghost and artificial cells.

In case a parallel::distributed::Triangulation is used, indices are communicated only to ghost cells.

Public wrapper of Implementation::communicate_future_fe_indices().

Definition at line 2092 of file dof_handler.cc.

## ◆ dominated_future_fe_on_children()

template<int dim, int spacedim = dim>
 unsigned int internal::hp::DoFHandlerImplementation::dominated_future_fe_on_children ( const typename DoFHandler< dim, spacedim >::cell_iterator & parent )

Return the index of the finite element from the entire hp::FECollection that is dominated by those assigned as future finite elements to the children of parent.

We find the corresponding finite element among the future finite elements on the children of this cell. If none of them qualify, we extend our search on the whole hp::FECollection, which is the element that describes the smallest finite element space that includes all future finite elements assigned to the children. If the function is not able to find a finite element at all, an assertion will be triggered.

In this way, we determine the finite element of the parent cell in case of h-coarsening in the hp-context.

Note
This function can only be called on direct parent cells, i.e., non-active cells whose children are all active.
On parallel::shared::Triangulation objects where sibling cells can be ghost cells, make sure that future FE indices have been properly communicated with communicate_future_fe_indices() first. Otherwise, results might differ on different processors. There is no check for consistency of future FE indices.

Public wrapper of Implementation::dominated_future_fe_on_children().

Definition at line 2105 of file dof_handler.cc.