There are now two solve function overloads, on without timeLoop that does one newton run,
and one with a timeloop that decreases the time step and tries again.

Need to pass the `TimeLoop`.

Bernd Flemisch authored 7 years ago and Timo Koch committed 7 years ago

Transfer the partial reassembly functionality to the current
structure.

The `NewtonSolver` is responsible for the partial reassembly.
It owns a `unique_ptr` to an object of a new class
`PartialReassembler` which is invoked in the constructor as well as
in the methods `solve`, `newtonUpdate` and `assembleLinearSystem`.
The `PartialReassembler` object is created only if the parameter
`Newton.EnablePartialReassembly` is set to true.

After each Newton iteration, the `PartialReassembler` colors the
geometrical degrees of freedom depending on the shift of the
primary variables from the last time that the derivatives have been
calculated. This shift is updated by the function
`updateDistanceFromLastLinearization_` of the `NewtonSolver` and
passed to the function `computeColors` of the `PartialReassembler`
for the actual coloring. For green-colored entities, the entries in
the Jacobian are kept, while for the other entities, they are
recalculated.

Use an enum class `EntityColor` for the coloring, enable read
access to the color of an entity via the `PartialReassembler`.

Pass a pointer to the `PartialReassembler` when calling the routine
`assembleJacobianAndResidual` of the `Assembler`. Use SFINAE and
`enable_if` so that only assemblers accepting the additional
argument are invoked. The correspnding local assemblers have to be
adapted such that no calculations are performed for green elements.
Implement the functionality for Box, TPFA and MPFA; adapt the
`FVAssembler` as well as the `Box`/`CCLocalAssembler`
correspondingly.

The `PartialReassembler` throws if constructed with a discretization
method equal to None or Staggered. All `BoxLocalAssembler`s apart
from the implicit numeric one throw if called with a non-nullptr
to a `PartialReassembler`.

Allow for a default `nullptr` parameter to the assembly functions
that take a `PartialReassembler`. This requires a new class
`DefaultPartialReassembler` to be passed as a default template
parameter for these functions. This makes it possible to use the
functions `assembleJacobianAndResidual` of the global and local
assemblers as before without the additional argument.

Allow to set the thresholds and the weight for the calculation of
the effective reassembly threshold as parameters. Try to explain
the corresponding formula in a comment.

Use the functionality in the two-phase incompressible tests.

* isValid can be used to generate a functor that can check whether an operation done with a type is valid
* this patch also provides examples in form of a test and documentation

* this is the only test that failed after the changes in momentum upwind, thus the use of inertia terms is disabled
* use fixed times to write output
* do some clean-up

Somehow the upwinding and changes in navierstokes led to an additional Newton step

* rename old test for low Re testing

* 1p2c, 2p2c, test_donea (NavierStokes)

[2pncmin] beautification, new reference solution, changed to scalar permeability as setup is isotropic