So far doxygen did not process this file since
`HAVE_SUITESPARSE_CHOLMOD` was missing.
This also adds the missing editor hints.

Allow to use CHOLMOD with 'long int' integer type

See merge request core/dune-istl!485

CHOLMOD supports this, it just wasn't exposed in the interface.
It is needed for large problems.

Improve performance of MatrixIndexSet

See merge request core/dune-istl!527

Using `std::uint_least32_t` instead of `std::size_t` halves the required memory
and thus also improves performance.
Notice that `std::uint32_t` is optional and `std::uint_fast32_t` is intended to be
fast in terms of computations and may have 64 bits. Here we're interested in reducing
memory and thus bandwith. Hence `std::uint_least32_t`, which is the smallest sufficient
type is most appropriate.

This replaces the `std::set` used to store the column indices for each
rows by a `std::vector` based implementation. The `std::vector` is
kept sorted when inserting such that we can avoid duplicates. This
can improve assembly time of matrices significantly (if `MatrixIndexSet` is used).

In the worst case (insertion in reverse) this may lead to O(n^2) complexity
when inserting n entries in a row compared to O(n log(n)) for `std::set`.
However, the sorted `std::vector` implementation still wins for relatively
large n. To avoid the worst case complexity when using very dense rows,
the implementation is switched to `std::set` if the size exceeds the threshold
value `maxVectorSize`. The default `maxVectorSize=2048` was selected based
on benchmark results.

Fix build guard for solverfactorytest_*_direct

See merge request core/dune-istl!528

The CMAKE_GUARD for multiple guarding variables requires a
porper boolean statement.

Add FastAMG constructor with shared_ptr arguments

See merge request core/dune-istl!524

Adjust sequential and both parallel cases in istl-solver-playground

See merge request core/dune-istl!526

Do same thing, independent of paralellel, distributed, or
sequential.
This fixes the test in the sequential case.

[python] Silence false positive self assigment warning

See merge request core/dune-istl!523

Possible bug in clang is tracked here:
https://bugs.llvm.org/show_bug.cgi?id=43124

[bugfix][SuiteSparse] Fix index type conversion problem.

See merge request core/dune-istl!521

Robert K authored 2 years ago and Andreas Dedner committed 2 years ago

use using and SizeType to size_type to adhere to istl conventions

[bugfix] Add missing specialization FieldTraits<MultiTypeBlockMatrix>

See merge request core/dune-istl!516

Notice that this also fixes an incorrect `MultiTypeBlockMatrix::field_type`
in a special setting: If you have a nested matrix
`MultiTypeBlockMatrix< MultiTypeBlockVector<MultiTypeBlockMatrix<...>>>`,
the outer `MultiTypeBlockMatrix::field_type` forwards to the `MultiTypeBlockVector::field_type`
which forwards to the inner `FieldTraits<MultiTypeBlockMatrix>::field_type`.

Add CI pipeline running the codespell tool

See merge request core/dune-istl!515

And fix all spelling errors that codespell currently finds.

typo: offests -> offsets

See merge request core/dune-istl!514

Specialize std::tuple_size for MultiTypeBlock*

See merge request core/dune-istl!512

... because we also specialize `std::tuple_element` and
it derives from `std::tuple` after all.

[bugfix] Fixes implicit build mode of BCRSMatrix with zero rows.

See merge request core/dune-istl!510

Corner case that sometimes happens and produced a segmentation fault.

Remove all deprecated code

See merge request core/dune-istl!508