From b62e6b6b514da3c27916f18c5228b62e2d018370 Mon Sep 17 00:00:00 2001 From: Wolfgang Bangerth Date: Sat, 23 Jul 2016 22:37:24 -0500 Subject: [PATCH] Update documentation of QCollection::push_back(). This clarifies that FECollection and QCollection do not have to have matching/corresponding elements. --- include/deal.II/hp/q_collection.h | 20 ++++++++++++++------ 1 file changed, 14 insertions(+), 6 deletions(-) diff --git a/include/deal.II/hp/q_collection.h b/include/deal.II/hp/q_collection.h index e18f865ad8..42983b33f3 100644 --- a/include/deal.II/hp/q_collection.h +++ b/include/deal.II/hp/q_collection.h @@ -66,13 +66,21 @@ namespace hp QCollection (const QCollection &q_collection); /** - * Adds a new quadrature rule to the QCollection. The quadrature rules - * have to be added in the same order as for the FECollection for which - * this quadrature rule collection is meant. Thus the reference to the - * quadrature rule for active_fe_index 0 has to be added first, followed - * by the quadrature rule for active_fe_index 1. + * Adds a new quadrature rule to the QCollection. In most cases, you will + * want to add quadrature rules in the same order as the elements were + * added to the hp::FECollection for which this quadrature rule collection is + * meant. If done this way, the hp::FEValues objects with which you will + * use both hp::FECollection and hp::QCollection objects will automatically + * choose corresponding elements and quadrature formulas. On the other hand, + * it is possible to use arbitrary combinations of elements and quadrature + * formulas in hp::FECollection and hp::QCollection objects when specifically + * specifying appropriate indices in calls to hp::FEValues::reinit() + * or hp::FEFaceValues::reinit(). In those cases, there need not be a + * correspondence between elements of the hp::FECollection and + * hp::QCollection objects; they need not even be of the same size in this + * case. * - * This class creates a copy of the given quadrature object, i.e. you can + * This class creates a copy of the given quadrature object, i.e., you can * do things like push_back(QGauss(3));. The internal copy * is later destroyed by this object upon destruction of the entire * collection. -- 2.39.5