Studies and solvers

Study steps, parametric sweeps and solver configurations (Study ribbon).

Study

Study ribbon

Setting Symbol Unit Default Choices / type

Study Settings

Generate default plots

On

Check box

Generate convergence plots

On

Check box

Parallel Computing

Number of MPI processes
Requires an MPI-enabled Elmer (ElmerSolver_mpi and mpiexec).

1

Integer

Study Settings

When nonlinear or coupling iterations do not converge
A linear solver that runs out of iterations always stops the study. Nonlinear (Newton) and segregated coupling iterations that reach their maximum without meeting the tolerance stop it too, unless kept: then the solution is shown, marked not converged.

Stop with an error

Stop with an error, Keep the solution, marked not converged

Stationary

Study ribbon

Setting Symbol Unit Default Choices / type

Study Settings

Max coupling iterations
Steady State Max Iterations when several physics are solved together

30

Integer

Coupling tolerance
Relative change at which the segregated (physics-by-physics) iteration stops

1e-6

Text

Coupling damping factor
Under-relaxation of every coupled physics between segregated iterations; lower it (e.g. 0.5, 0.25) when the coupled iteration oscillates and grows (a loop gain G > 1 needs a factor below 2/(1+G))

1

Text

Physics and Variables Selection

Physics and Variables Selection

Table

Values of Dependent Variables

Initial values from the solution of
Start from another study’s last solution (same mesh): the initial state of a time-dependent study, or the initial guess of a nonlinear stationary one. The other study is computed first.

Study

Time Dependent

Study ribbon

Setting Symbol Unit Default Choices / type

Study Settings

Time unit

s

s, ms, min, h, d

Output times
range(start,step,stop), a list of times, or several ranges with growing steps, e.g. range(0,0.01,0.1) range(0.2,0.1,1) range(2,1,100); the solver steps from one output time to the next

range(0,0.1,1)

Text

Solver steps per output step

1

Integer

BDF order

2

1 (backward Euler), 2

Max coupling iterations per step

10

Integer

Physics and Variables Selection

Physics and Variables Selection

Table

Values of Dependent Variables

Initial values from the solution of
Start from another study’s last solution (same mesh): the initial state of a time-dependent study, or the initial guess of a nonlinear stationary one. The other study is computed first.

Study

Eigenfrequency

Study ribbon

Setting Symbol Unit Default Choices / type

Study Settings

Desired number of eigenfrequencies

6

Integer

Search for eigenfrequencies around

Hz

0

Expression

Physics and Variables Selection

Physics and Variables Selection

Table

Frequency Domain

Study ribbon

Setting Symbol Unit Default Choices / type

Study Settings

Frequency unit

Hz

Hz, kHz, MHz

Frequencies
A single value, a list, or range(start,step,stop)

500

Text

Physics and Variables Selection

Physics and Variables Selection

Table

Parametric Sweep

Study ribbon

Setting Symbol Unit Default Choices / type

Study Settings

Sweep type
Specified: the i-th values of every parameter go together; All: every combination

Specified combinations

Specified combinations, All combinations

Parameter name

Text

Parameter value list

range(1,1,3)

Text

Parameter unit

Text

More parameters

Table (columns: Parameter name, Parameter value list, Parameter unit)

Reuse solution from previous step
Stationary steps start from the previous parameter’s solution when the mesh is unchanged (continuation); Off starts every run from the initial values

Automatic

Automatic, Off

Solver Configurations

Study ribbon

No settings.

Solver

Study ribbon

Setting Symbol Unit Default Choices / type

Linear Solver

Linear solver

Automatic (direct for small, iterative for large)

Automatic (direct for small, iterative for large), Direct, Iterative

Direct solver

UMFPACK

UMFPACK, MUMPS, Banded (LAPACK)

Iterative method

BiCGStab(l)

BiCGStab, BiCGStab(l), GCR, Conjugate gradients, GMRES, TFQMR, IDR(s)

Preconditioner

ILU(1)

ILU(0), ILU(1), ILU(2), ILUT, Jacobi, None

Relative tolerance

1e-10

Expression

Maximum number of iterations

1000

Integer

Nonlinear Solver

Maximum nonlinear iterations
0 = interface default

0

Integer

Nonlinear tolerance

1e-7

Expression

Damping (relaxation) factor

1

Expression

Advanced

Additional SIF keywords

Text (multi-line)