From: Peter Munch <peterrmuench@gmail.com>
Date: Sun, 7 Jan 2024 12:33:50 +0000 (+0100)
Subject: Rename FPE::real_point() to FPE::quadrature_point()
X-Git-Tag: v9.6.0-rc1~464^2
X-Git-Url: https://gitweb.dealii.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=refs%2Fpull%2F16423%2Fhead;p=dealii.git

Rename FPE::real_point() to FPE::quadrature_point()
---

diff --git a/doc/news/changes/incompatibilities/20240107Munch b/doc/news/changes/incompatibilities/20240107Munch
new file mode 100644
index 0000000000..81d756c5cb
--- /dev/null
+++ b/doc/news/changes/incompatibilities/20240107Munch
@@ -0,0 +1,5 @@
+Removed: The function FEPointEvaluation::real_point() has been
+renamed to FEPointEvaluation::quadrature_point(). The old function
+has been deprecated.
+<br>
+(Peter Munch, 2024/01/01)
diff --git a/include/deal.II/matrix_free/fe_point_evaluation.h b/include/deal.II/matrix_free/fe_point_evaluation.h
index e7f1426163..230602f823 100644
--- a/include/deal.II/matrix_free/fe_point_evaluation.h
+++ b/include/deal.II/matrix_free/fe_point_evaluation.h
@@ -845,12 +845,21 @@ public:
   Number
   JxW(const unsigned int point_index) const;
 
+  /**
+   * Return the position in real coordinates of the given point index among
+   * the points passed to reinit().
+   *
+   * @deprecated Use the function quadrature_point() instead.
+   */
+  DEAL_II_DEPRECATED_EARLY Point<spacedim, Number>
+                           real_point(const unsigned int point_index) const;
+
   /**
    * Return the position in real coordinates of the given point index among
    * the points passed to reinit().
    */
   Point<spacedim, Number>
-  real_point(const unsigned int point_index) const;
+  quadrature_point(const unsigned int point_index) const;
 
   /**
    * Return the position in unit/reference coordinates of the given point
@@ -2245,6 +2254,17 @@ template <int n_components_, int dim, int spacedim, typename Number>
 inline Point<spacedim, Number>
 FEPointEvaluationBase<n_components_, dim, spacedim, Number>::real_point(
   const unsigned int point_index) const
+{
+  return quadrature_point(point_index);
+  ;
+}
+
+
+
+template <int n_components_, int dim, int spacedim, typename Number>
+inline Point<spacedim, Number>
+FEPointEvaluationBase<n_components_, dim, spacedim, Number>::quadrature_point(
+  const unsigned int point_index) const
 {
   AssertIndexRange(point_index, n_q_points);
   Assert(real_point_ptr != nullptr,
diff --git a/tests/matrix_free/point_evaluation_12.cc b/tests/matrix_free/point_evaluation_12.cc
index 7b532ac73f..6452d29caa 100644
--- a/tests/matrix_free/point_evaluation_12.cc
+++ b/tests/matrix_free/point_evaluation_12.cc
@@ -13,7 +13,7 @@
 // ------------------------------------------------------------------------
 
 
-// check FEPointEvaluation::real_point(), FEPointEvaluation::unit_point(),
+// check FEPointEvaluation::quadrature_point(), FEPointEvaluation::unit_point(),
 // FEPointEvaluation::jacobian(), FEPointEvaluation::inverse_jacobian(),
 // FEPointEvaluation::get_unit_gradient().
 
@@ -97,7 +97,7 @@ test(const unsigned int degree)
         deallog << "unit point " << unit_points[i] << std::endl
                 << "unit point via evaluator: " << evaluator.unit_point(i)
                 << std::endl
-                << "real point: " << evaluator.real_point(i) << std::endl
+                << "real point: " << evaluator.quadrature_point(i) << std::endl
                 << "jacobian: " << Tensor<2, dim>(evaluator.jacobian(i))
                 << std::endl
                 << "inverse jacobian: "