feelpp_toolbox_solid(1)

1. NAME

feelpp_toolbox_solid - solid mechanics toolbox application

2. SYNOPSIS

feelpp_toolbox_solid --case <directory to model case>
  [--case.dim 3]
  [--case.discretization P1]
  [--solid.ksp-monitor=<0,1>]
  [--solid.ksp-view=<0,1>]
  [--solid.ksp-type=<see below>]
  [--solid.pc-view=<0,1>]
  [--solid.pc-type=<see below>]
  [--solid.snes-monitor=<0,1>]
  [--solid.ksp-type=<see below>]

3. DESCRIPTION

feelpp_toolbox_solid is an application which can run solid mechanics model defined by a set of files : a geometry or mesh, a config file(.cfg) and a model file(.json)

The execution steps are as follows:

  • load the model

  • load the mesh

  • setup model (materials, initial and boundary condition)

  • execute the steady or unsteady simulation

  • post-process the results, viewable in paraview or ensight

3.1. Options

feelpp_toolbox_solid requires some options.

Table 1. Table of command-line feelpp_toolbox_solid options
Name Description Default value Possible Values

case.dim

dimension of problem

3

2,3

case.discretization

discretization of problem

P1

P1,P2

solid.ksp-monitor

monitor the Krylov Subspace iterations

0

0,1

solid.ksp-view

view the Krylov Subspace structure

0

0,1

solid.ksp-type

change the Krylov Subspace method

gmres

see PETSc documentation

solid.pc-view

view the Krylov Subspace structure

0

0,1

solid.pc-type

change the Krylov Subspace strategy

lu

see PETSc documentation

solid.snes-monitor

if applicable, monitor the non-linear solver iterations

0

0,1

solid.snes-type

if applicable, change the non-linear solver iterations

newtonls

see PETSc documentation

NOTE

0 as option value means that the option is not enable, 1 means it is enabled.

4. EXAMPLES

We are now using the feelpp/feelpp-toolboxes:latest docker images as described in docs.feelpp.org/user/0.108/install/containers/#_docker to demonstrate feelpp_toolbox_solid usage.

Starting the docker feelpp/feelpp-toolboxes:latest
docker run --rm -ti -v $HOME/feel:/feel feelpp/feelpp-toolboxes
Explanations about the command line
docker run (1)
--rm (2)
-ti (3)
-v $HOME/feel:/feel (4)
feelpp/feelpp-toolboxes (5)
1 run docker executable
2 remove container from docker once execution is done
3 run in interactive mode and enter the docker container
4 mount $HOME/feel on host to /feel/ in docker: the results will be exported there
5 the docker container to execute, by default it uses the latest tag
Example of a command line to execute feelpp_toolbox_solid
mpirun --bind-to core -np 10 feelpp_toolbox_solid --case "github:{path:toolboxes/solid/cantilever}"
Explantion of the command line to execute feelpp_toolbox_solid
mpirun --bind-to core (1)
  -np 10 (2)
  (3)
  --case "github:{path:toolboxes/solid/cantilever}" (4)
1 execute in parallel using MPI with processes bound to cores
2 execute in parallel usisng 10 processes
3 the name of the toolbox application
4 case directory containing the model files (geometry, config and json). This case file is available remotely on github.

Other test cases can be found

5. RESOURCES

Feel++ Docs

docs.feelpp.org/toolboxes/0.108/

Feel++ Cases for feelpp_toolbox_solid

docs.feelpp.org/cases/0.108/csm/README

Feel++ Toolbox Docs for feelpp_toolbox_solid

docs.feelpp.org/toolboxes/0.108/csm/

6. SEE ALSO

Feel++ Mesh Partitioner

Mesh partitioner for Feel++ Toolboxes docs.feelpp.org/user/0.108/using/mesh_partitioner/

Feel++ Remote Tool

Access remote data(model cases, meshes) on Github and Girder in Feel++ applications. docs.feelpp.org/user/0.108/using/remotedata/

7. COPYING

Copyright (C) 2020 Feel++ Consortium.
Free use of this software is granted under the terms of the GPLv3 License.