From c5b2ff469001b3b2e146b8d89e8d389e1c137bf7 Mon Sep 17 00:00:00 2001 From: Wolfgang Bangerth Date: Tue, 8 Aug 2017 12:03:07 -0600 Subject: [PATCH] Update documentation about setting active FE indices. --- include/deal.II/hp/dof_handler.h | 22 +++++++++++++++++++++- 1 file changed, 21 insertions(+), 1 deletion(-) diff --git a/include/deal.II/hp/dof_handler.h b/include/deal.II/hp/dof_handler.h index c4be7e907a..4608bbaa85 100644 --- a/include/deal.II/hp/dof_handler.h +++ b/include/deal.II/hp/dof_handler.h @@ -127,10 +127,30 @@ namespace hp * are coarsened away, the old value is no longer available on the * parent cell. * + * + *

Active FE indices and parallel meshes

+ * + * When this class is used with either a parallel::shared::Triangulation + * or a parallel::distributed::Triangulation, you can only set active + * FE indices on cells that are locally owned or that are ghost cells, + * using a call such as cell-@>set_active_fe_index(...). + * On the other hand, setting the active FE index on artificial cells + * is not allowed. + * + * However, setting the index on ghost cells has no real effect: whenever + * you call hp::DoFHandler::distribute_dofs(), all processors that + * participate in the parallel mesh exchange information in such a way + * that the active FE index on ghost cells equals the active FE index + * that was set on that processor that owned that particular ghost cell. + * In other words, information that may have previously been set on + * ghost cells is overwritten so that the active FE index there is + * consistent with the value on the processor that owns the cell. + * + * * @ingroup dofs * @ingroup hp * - * @author Wolfgang Bangerth, Oliver Kayser-Herold, 2003, 2004 + * @author Wolfgang Bangerth, Oliver Kayser-Herold, 2003, 2004, 2017 */ template class DoFHandler : public Subscriptor -- 2.39.5