From 3b4e2ba843c8104e1d45cb7162445dc07c6fa07c Mon Sep 17 00:00:00 2001 From: Peter Munch Date: Fri, 17 Jun 2022 19:20:37 +0200 Subject: [PATCH] Improve documentation of MF::AD::cell_vectorization_category --- include/deal.II/matrix_free/matrix_free.h | 15 ++++++++++----- 1 file changed, 10 insertions(+), 5 deletions(-) diff --git a/include/deal.II/matrix_free/matrix_free.h b/include/deal.II/matrix_free/matrix_free.h index 68fb429be8..0b7d63bc54 100644 --- a/include/deal.II/matrix_free/matrix_free.h +++ b/include/deal.II/matrix_free/matrix_free.h @@ -498,13 +498,18 @@ public: /** * This data structure allows to assign a fraction of cells to different * categories when building the information for vectorization. It is used - * implicitly when working with hp-adaptivity but can also be useful in - * other contexts, such as in local time stepping where one would like to - * control which elements together form a batch of cells. + * implicitly when working with hp-adaptivity (with each active index + * being a category) but can also be useful in other contexts where one + * would like to control which cells together can form a batch of cells. + * Such an example is "local time stepping", where cells of different + * caterogries progress with different time-step sizes and, as a + * consequence, can only processed together with cells with the same + * cateogry. * * This array is accessed by the number given by cell->active_cell_index() - * when working on the active cells with @p mg_level set to numbers::invalid_unsigned_int and - * by cell->index() for the level cells. + * when working on the active cells (with + * @p mg_level set to numbers::invalid_unsigned_int) and by cell->index() + * for the level cells. * * @note This field is empty upon construction of AdditionalData. It is * the responsibility of the user to resize this field to -- 2.39.5