From: Wolfgang Bangerth Date: Sat, 18 Mar 2023 00:01:05 +0000 (-0600) Subject: Update documentation for DataPostprocessor. X-Git-Tag: v9.5.0-rc1~453^2 X-Git-Url: https://gitweb.dealii.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=refs%2Fpull%2F14909%2Fhead;p=dealii.git Update documentation for DataPostprocessor. --- diff --git a/include/deal.II/numerics/data_postprocessor.h b/include/deal.II/numerics/data_postprocessor.h index 2188864ab4..8da0e93609 100644 --- a/include/deal.II/numerics/data_postprocessor.h +++ b/include/deal.II/numerics/data_postprocessor.h @@ -222,10 +222,18 @@ namespace DataPostprocessorInputs * This array is only filled if a user-derived class overloads the * DataPostprocessor::get_needed_update_flags(), and the function * returns (possibly among other flags) - * UpdateFlags::update_quadrature_points. Alternatively, a class + * UpdateFlags::update_quadrature_points. Alternatively, a class * derived from DataPostprocessorScalar, DataPostprocessorVector, * or DataPostprocessorTensor may pass this flag to the constructor of * these three classes. + * + * @note In the current context, the flag UpdateFlags::update_quadrature_points + * is misnamed because we are not actually performing any quadrature. + * Rather, we are *evaluating* the solution at specific evaluation + * points, but these points are unrelated to quadrature (i.e., + * to computing integrals) and will, in general, not be located + * at Gauss points or the quadrature points of any of the typical + * quadrature rules.) */ std::vector> evaluation_points; @@ -661,6 +669,14 @@ public: * DataPostprocessor is to be used in combination with DataOutFaces, you may * also ask for a update of normals via the @p update_normal_vectors flag. * The description of the flags can be found at dealii::UpdateFlags. + * + * @note In the current context, the flag UpdateFlags::update_quadrature_points + * is misnamed because we are not actually performing any quadrature. + * Rather, we are *evaluating* the solution at specific evaluation + * points, but these points are unrelated to quadrature (i.e., + * to computing integrals) and will, in general, not be located + * at Gauss points or the quadrature points of any of the typical + * quadrature rules.) */ virtual UpdateFlags get_needed_update_flags() const = 0; @@ -715,6 +731,14 @@ public: * DataPostprocessor is to be used in combination with DataOutFaces, you may * also ask for a update of normals via the @p update_normal_vectors flag. * The description of the flags can be found at dealii::UpdateFlags. + * + * @note In the current context, the flag UpdateFlags::update_quadrature_points + * is misnamed because we are not actually performing any quadrature. + * Rather, we are *evaluating* the solution at specific evaluation + * points, but these points are unrelated to quadrature (i.e., + * to computing integrals) and will, in general, not be located + * at Gauss points or the quadrature points of any of the typical + * quadrature rules.) */ DataPostprocessorScalar(const std::string &name, const UpdateFlags update_flags); @@ -923,6 +947,16 @@ private: * does not adequately resolve this interface. This, however, is not * important to the current discussion. * + * @note In the current context, the flag UpdateFlags::update_quadrature_points + * is misnamed because we are not actually performing any quadrature. + * Rather, we are *evaluating* the solution at specific evaluation + * points, but these points are unrelated to quadrature (i.e., + * to computing integrals) and will, in general, not be located + * at Gauss points or the quadrature points of any of the typical + * quadrature rules.) In the example above, we need the location + * of these evaluation points because we need to evaluate the + * coefficients at these points. + * * *

Extension to the gradients of vector-valued problems

* @@ -959,6 +993,14 @@ public: * DataPostprocessor is to be used in combination with DataOutFaces, you may * also ask for a update of normals via the @p update_normal_vectors flag. * The description of the flags can be found at dealii::UpdateFlags. + * + * @note In the current context, the flag UpdateFlags::update_quadrature_points + * is misnamed because we are not actually performing any quadrature. + * Rather, we are *evaluating* the solution at specific evaluation + * points, but these points are unrelated to quadrature (i.e., + * to computing integrals) and will, in general, not be located + * at Gauss points or the quadrature points of any of the typical + * quadrature rules.) */ DataPostprocessorVector(const std::string &name, const UpdateFlags update_flags); @@ -1217,6 +1259,14 @@ public: * DataPostprocessor is to be used in combination with DataOutFaces, you may * also ask for a update of normals via the @p update_normal_vectors flag. * The description of the flags can be found at dealii::UpdateFlags. + * + * @note In the current context, the flag UpdateFlags::update_quadrature_points + * is misnamed because we are not actually performing any quadrature. + * Rather, we are *evaluating* the solution at specific evaluation + * points, but these points are unrelated to quadrature (i.e., + * to computing integrals) and will, in general, not be located + * at Gauss points or the quadrature points of any of the typical + * quadrature rules.) */ DataPostprocessorTensor(const std::string &name, const UpdateFlags update_flags);