From: Wolfgang Bangerth Date: Tue, 8 Aug 2017 18:03:07 +0000 (-0600) Subject: Update documentation about setting active FE indices. X-Git-Tag: v9.0.0-rc1~1340^2 X-Git-Url: https://gitweb.dealii.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=c5b2ff469001b3b2e146b8d89e8d389e1c137bf7;p=dealii.git Update documentation about setting active FE indices. --- 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