]> https://gitweb.dealii.org/ - dealii.git/commitdiff
SparsityPattern: improve documentation 10913/head
authorTimo Heister <timo.heister@gmail.com>
Mon, 14 Sep 2020 13:53:31 +0000 (09:53 -0400)
committerTimo Heister <timo.heister@gmail.com>
Mon, 14 Sep 2020 13:59:10 +0000 (09:59 -0400)
My students rightfully complained, that it is very difficult to find
begin() (hidden in the base class) and the accessor functions (hidden
behind using).

include/deal.II/lac/sparsity_pattern.h

index ef22b9a26630e44d87dc48a083c38b31a0075fae..f76681dd6c135ea3a679d7a67484ebde87daa746 100644 (file)
@@ -847,13 +847,20 @@ protected:
  * is square (the first item will be the diagonal, followed by the other
  * entries sorted by column index).
  *
- * @note While this class forms the basis upon which SparseMatrix objects base
+ * While this class forms the basis upon which SparseMatrix objects base
  * their storage format, and thus plays a central role in setting up linear
  * systems, it is rarely set up directly due to the way it stores its
  * information. Rather, one typically goes through an intermediate format
  * first, see for example the step-2 tutorial program as well as the
  * documentation module
  * @ref Sparsity.
+ *
+ * You can iterate over entries in the pattern using begin(), end(),
+ * begin(row), and end(row). These functions return an iterator of type
+ * SparsityPatternIterators::Iterator. When dereferencing an iterator @p it,
+ * you have access to the member functions in
+ * SparsityPatternIterators::Accessor, like <tt>it->column()</tt> and
+ * <tt>it->row()</tt>.
  */
 class SparsityPattern : public SparsityPatternBase
 {

In the beginning the Universe was created. This has made a lot of people very angry and has been widely regarded as a bad move.

Douglas Adams


Typeset in Trocchi and Trocchi Bold Sans Serif.