From: Wolfgang Bangerth Date: Fri, 6 Mar 2015 21:00:52 +0000 (-0600) Subject: Update documentation in a small way. X-Git-Tag: v8.3.0-rc1~383^2 X-Git-Url: https://gitweb.dealii.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=a62c6447cb3b295246139a3b429e305f9e3a64fe;p=dealii.git Update documentation in a small way. --- diff --git a/include/deal.II/numerics/error_estimator.h b/include/deal.II/numerics/error_estimator.h index fee55c4c78..f92e5bbd47 100644 --- a/include/deal.II/numerics/error_estimator.h +++ b/include/deal.II/numerics/error_estimator.h @@ -40,11 +40,12 @@ namespace hp /** - * Implementation of the error indicator by Kelly, Gago, Zienkiewicz and + * Implementation of the error indicator by Kelly, De S. R. Gago, Zienkiewicz and * Babuska. This error indicator tries to approximate the error per cell by * integration of the jump of the gradient of the solution along the faces of * each cell. It can be understood as a gradient recovery estimator; see the - * survey of Ainsworth for a complete discussion. + * survey of Ainsworth and Oden, "A Posteriori Error Estimation in Finite Element + * Analysis" (Wiley, 2000) for a complete discussion. * * @note In spite of the name, this is not truly an a posteriori error * estimator, even if applied to the Poisson problem only. It gives good hints @@ -58,10 +59,25 @@ namespace hp * the conormal derivative $a\frac{du}{dn} = g$. * * The error estimator returns a vector of estimated errors per cell which can - * be used to feed the Triangulation::refine_* functions. This + * be used to feed the GridRefinement::refine_fixed_fraction, + * GridRefinement::refine_fixed_number, and similar functions. This * vector contains elements of data type @p float, rather than @p double, - * since accuracy is not so important here, and since this can save rather a - * lot of memory, when using many cells. + * since accuracy is not important in the current context. + * + * The full reference for the paper in which this error estimator is defined + * is as follows: + * @code + * @Article{KGZB83, + * author = {Kelly, D. W. and {De S. R. Gago}, J. P. and Zienkiewicz, O. C. + * and Babu\v{s}ka, I.}, + * title = {A posteriori error analysis and adaptive processes + * in the finite element method: Part {I}--Error Analysis}, + * journal = {Int. J. Num. Meth. Engrg.}, + * year = {1983}, + * volume = {19}, + * pages = {1593--1619} + * } + * @endcode * * *

Implementation