From: Wolfgang Bangerth Date: Thu, 19 Mar 1998 10:23:11 +0000 (+0000) Subject: Add doc X-Git-Tag: v8.0.0~23166 X-Git-Url: https://gitweb.dealii.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=5a15e5f90a499c486738bfc43325124e471fe361;p=dealii.git Add doc git-svn-id: https://svn.dealii.org/trunk@85 0785d39b-7218-0410-832d-ea1e28bc413d --- diff --git a/deal.II/deal.II/include/grid/tria.h b/deal.II/deal.II/include/grid/tria.h index 72dc910872..a7eea19f2d 100644 --- a/deal.II/deal.II/include/grid/tria.h +++ b/deal.II/deal.II/include/grid/tria.h @@ -1359,48 +1359,80 @@ class Triangulation : public TriaDimensionInfo { /** * Return total number of used lines, * active or not. + * + * Regarding the computational effort of + * this function, the same applies as + * for the #n_cells()# function. */ unsigned int n_lines () const; /** * Return total number of used lines, * active or not on level #level#. + * + * Regarding the computational effort of + * this function, the same applies as + * for the #n_cells()# function. */ unsigned int n_lines (const unsigned int level) const; /** * Return total number of active lines, * active or not. + * + * Regarding the computational effort of + * this function, the same applies as + * for the #n_cells()# function. */ unsigned int n_active_lines () const; /** * Return total number of active lines, * active or not on level #level#. + * + * Regarding the computational effort of + * this function, the same applies as + * for the #n_cells()# function. */ unsigned int n_active_lines (const unsigned int level) const; /** * Return total number of used quads, * active or not. + * + * Regarding the computational effort of + * this function, the same applies as + * for the #n_cells()# function. */ unsigned int n_quads () const; /** * Return total number of used quads, * active or not on level #level#. + * + * Regarding the computational effort of + * this function, the same applies as + * for the #n_cells()# function. */ unsigned int n_quads (const unsigned int level) const; /** * Return total number of active quads, * active or not. + * + * Regarding the computational effort of + * this function, the same applies as + * for the #n_cells()# function. */ unsigned int n_active_quads () const; /** * Return total number of active quads, * active or not on level #level#. + * + * Regarding the computational effort of + * this function, the same applies as + * for the #n_cells()# function. */ unsigned int n_active_quads (const unsigned int level) const; @@ -1409,6 +1441,18 @@ class Triangulation : public TriaDimensionInfo { * active or not. * Maps to #n_lines()# in one space * dimension and so on. + * + * Be a bit careful with this function, + * since it needs quite some computational + * ressources: the number of cells is + * computed by looping over all cells, + * rather than by returning a pre-stored + * value. It is therefore often better + * to rewrite lines like + * #for (i=0; i { * active or not, on level #level#. * Maps to #n_lines(level)# in one space * dimension and so on. + * + * Regarding the computational effort of + * this function, the same applies as + * for the #n_cells()# function. */ unsigned int n_cells (const unsigned int level) const; /** * Return total number of active cells. * Maps to #n_active_lines()# in one space - * dimension and so on. + * dimension and so on. + * + * Regarding the computational effort of + * this function, the same applies as + * for the #n_cells()# function. */ unsigned int n_active_cells () const; @@ -1432,6 +1484,10 @@ class Triangulation : public TriaDimensionInfo { * on level #level#. * Maps to #n_active_lines(level)# in one space * dimension and so on. + * + * Regarding the computational effort of + * this function, the same applies as + * for the #n_cells()# function. */ unsigned int n_active_cells (const unsigned int level) const;