Extend-bazaar/Toolkits/Fluid-structure interaction

1 Description

Quoting from here:

This toolkit supersedes the icoFsiElasticNonLinULSolidFoam FSI solver within the solidMechanics toolbox.
This framework was presented at the OpenFOAM Workshop 2014 in Zagreb: abstract and slides.
The major improvement with regard to FSI coupling is the implementation of the IQN-ILS algorithm.
Also, the plugin approach used for the solid and fluid solvers should allow easier extension to other fluid/solid models e.g. multi-phase, compressible, plasticity, etc.

2 Authors

This toolkit has been a continuous work from several authors, where some of the initial work comes from the solidMechanics toolbox, but the remaining work has been done in this FSI-toolkit.

The Fluid-Structure Interaction toolkit (later was renamed to "Fluid-Solid Interaction toolkit" with the release for foam-extend 4.0), has been the accumulative work of the following authors (from the slides mentioned in the Description section above):

Željko Tuković (main author of this Fluid-Structure Interaction toolkit)
Philip Cardiff
Aleksandar Karač
Hrvoje Jasak
Alojz Ivanković

For a more complete list of authors for all of the code, the following shell command within the folder src can provide some more insight:

find fluid* utilities solvers -name "*.[CH]" | xargs grep -C 3 "Author"

3 Installation

Valid versions:

First publicly available snapshot of the source code: Is available here on the wiki, which was designed to work with : Fsi_31.tar.gz; Git repository based on this source code and further updated for foam-extend 3.1 and 3.2 is available here: https://github.com/wyldckat/FluidStructureInteraction

Second publicly available snapshot of the source code: Is available here on the wiki, which was designed to work with : Fsi_40.tar.gz; Note: It's expected that this will be integrated into future versions of foam-extend.

The instructions are a bit different, depending on the version of foam-extend:

Install on foam-extend 3.0
Install on foam-extend 3.1
Install on foam-extend 3.2
Install on foam-extend 4.0

3.1 Install on foam-extend 3.0

To download and install, run the following commands:

mkdir -p $WM_PROJECT_USER_DIR
cd $WM_PROJECT_USER_DIR
wget http://openfoamwiki.net/images/5/52/Fsi_31.tar.gz
tar -xzf Fsi_31.tar.gz
cd FluidStructureInteraction/src/
./Allwmake

3.2 Install on foam-extend 3.1

First we have to download and unpack the source code:

mkdir -p $WM_PROJECT_USER_DIR
cd $WM_PROJECT_USER_DIR
wget http://openfoamwiki.net/images/5/52/Fsi_31.tar.gz
tar -xzf Fsi_31.tar.gz

Now we need to do some repairs in the source code:

cd FluidStructureInteraction/src/fluidStructureInteraction/stressModels/constitutiveModel
 
wget https://raw.githubusercontent.com/wyldckat/FluidStructureInteraction/fe31/src/fluidStructureInteraction/stressModels/constitutiveModel/constitutiveModel.C -O constitutiveModel.C
wget https://raw.githubusercontent.com/wyldckat/FluidStructureInteraction/fe31/src/fluidStructureInteraction/stressModels/constitutiveModel/constitutiveModel.H -O constitutiveModel.H
 
cd ../../..

Finally, we can build the toolkit:

./Allwmake

3.3 Install on foam-extend 3.2

WARNING: These instructions advise you to download and install an adapted and experimental source code. It has not been fully tested and it's probable that it won't work as intended.

The changes needed for foam-extend 3.2 are too many in order to reuse the file provided for foam-extend 3.0, therefore here are the instructions for getting from wyldckat's repository at Github:

Go into the assigned user folder:

mkdir -p $WM_PROJECT_USER_DIR
cd $WM_PROJECT_USER_DIR

Now, depending on whether you're able to use git or not:

For cloning from the git repository:

git clone https://github.com/wyldckat/FluidStructureInteraction.git

Then checkout the right branch:

cd FluidStructureInteraction
git checkout fe32

For downloading the ZIP package:

wget -O FluidStructureInteraction.fe32.zip https://github.com/wyldckat/FluidStructureInteraction/archive/fe32.zip

Then unpack, rename the unpacked folder and go into the folder:

unzip FluidStructureInteraction.fe32.zip
mv FluidStructureInteraction-fe32 FluidStructureInteraction
cd FluidStructureInteraction

Now build:
```
cd src
./Allwmake
```

3.4 Install on foam-extend-4.0

First we have to download and unpack the source code:

mkdir -p $WM_PROJECT_USER_DIR
cd $WM_PROJECT_USER_DIR
wget https://openfoamwiki.net/images/d/d6/Fsi_40.tar.gz
tar -xzf Fsi_40.tar.gz

Now we can build the toolkit:

cd FluidSolidInteraction/src
./Allwmake

Then, before we try running the tutorial cases, we need to fix a few dependencies:

cd ..
find run -name options | while read item
do
  sed -i -e 's=$(WM_PROJECT_DIR)/applications/solvers/FSI=$(WM_PROJECT_USER_DIR)/FluidSolidInteraction/src=' $item
  sed -i -e 's=$(WM_THIRD_PARTY_DIR)/packages/eigen3=$(WM_PROJECT_USER_DIR)/FluidSolidInteraction/src/ThirdParty/eigen3=' $item
done

4 Tutorials

The first version of the toolkit provides in the folder run the following examples:

fsiFoam
- 3dTube
- beamInCrossFlow
- HronTurekFsi3
stressFoam
- plateHole
thermalStressFoam
- flange

4.1 fsiFoam tutorial cases

Each tutorial case available in the fsiFoam folder is executed by running the following commands:

sed -i s/tcsh/sh/g *Links
./removeSerialLinks fluid solid
./makeSerialLinks fluid solid
cd fluid
./Allclean
./Allrun

4.2 stressFoam tutorial case

The tutorial case plateHole is executed by going into the case folder:

cd stressFoam/plateHole/plateHole/

And running:

./Allrun

4.3 thermalStressFoam tutorial case

The tutorial case flange is executed by going into the case folder:

cd thermalStressFoam/flange/