CFD

This page is currently a work in progress by Nik Lebedenko - if you want to ask questions / see a mistake / request more details to be added to this page, feel free to email me or message me on slack.

Computational Fluid Dynamics (CFD) is the process of solving fluid mechanics equations with the use of computers. Think F=ma, but like... more. (I will elaborate further)

Crash course on the Finite Volume Method (FVM)

This section is incomplete

There are many resources for learning how CFD works properly (linked below), but this is a crash course. This section is designed for people who would like to find out a bit more about how CFD works, beyond a "black-box" understanding, but without going too far in depth with all the details. So, here are the bare minimum requirements for understanding roughly what is going on under the hood in any CFD solver. I will assume you know:

• Some basic high-school physics about gases (e.g. what is pressure, how does it change with temperature)
• What a partial derivative is,
• What simultaneous equations are,
• How to write simultaneous equations as matrices, and
• What a vector is.

Sections marked "Optional" are not required for a basic level of understanding of how the software works, but give a bit more detail for those who want it.

Overview

Every CFD solver works by splitting up the region of interest (a process called "meshing" the "domain") into a bunch of small boxes (called the "cells" in the "mesh"), and solving a set of equations in each of those cells, taking into account how the flow variables (velocity, temperature, pressure) are related between neighbouring cells. Most commonly:

• The continuity equation: mass is not created or destroyed (conservation of mass).
• The momentum equation: "F=ma" but for fluids (conservation of momentum).
• The energy equation: energy is not created or destroyed (conservation of energy).

The continuity equation

To clarify this, consider the example below of a simple uniform pipe, with a cross-section shown in the left image. Now, let us "mesh" the "domain" into four "cells" (split the pipe into 4 boxes), image right.

• 

  2D pipe cross-section with a flow from left to right

• 

  Pipe split into cells, with cell centroids marked with circles

Note: the cells here are 3D - we are looking at a 2D cross section. We will assume that the velocity is purely in the x direction. Consider an arbitrary cell within this mesh labelled "C", with its western and eastern neighbours labelled "W" and "E" respectively. The faces between W & C and C & E are labelled WC and CE. The following abbreviations for variables will be used:

• X: Position,
• [math]\displaystyle{ \rho }[/math] (rho): Density,
• p: Pressure,
• U: Velocity (in the x-axis),
• V: Volume of the cell,
• A: Area of a face,
• Any variable with a subscript corresponds to the value of that variable at that location. E.g. U_W is the velocity of the fluid at W. The area of face WC is A_WC.

• 

  An arbitrary cell C neighboured by cells W and E on the west and east sides respectively

• 

  A graph showing cell values (grey circles) and the linear interpolated face values (dotted blue circles)

The continuity equation tells us that mass is not created or destroyed. For an arbitrary cell C, knowing that the mass flow rate through a given face is [math]\displaystyle{ {\rho}UA }[/math], we can write

Rate of change of mass in C = Mass flow rate in - Mass flow rate out

[math]\displaystyle{ \frac{\partial (\rho V)_c}{\partial t} = ({\rho}UA)_{wc} - ({\rho}UA)_{ce} }[/math]

If we assume an "incompressible" (constant density) fluid, e.g. water, we can divide by the density term [math]\displaystyle{ \rho }[/math] on both sides. If we assume a "steady" flow, then nothing changes with time, i.e. all time derivatives are zero. The equation becomes

[math]\displaystyle{ 0 = ({\rho}UA)_{wc} - ({\rho}UA)_{ce} }[/math]

[math]\displaystyle{ 0 = (UA)_{wc} - (UA)_{ce} }[/math] (1)

At the moment, we are using values of velocity at the faces between the cells. But in a CFD solver, we only store the values at the cell centroid. The process of calculating face values using cell values on either side of the face is called interpolation. The most obvious interpolation "scheme" (method) is linear interpolation - that is, assume that all variables vary linearly between two points, as in the image above. After this point, the continuity equation will only work for cells that aren't on the boundary. The continuity equation becomes

[math]\displaystyle{ 0 = (U_wi_w + U_c(1-i_w)) \cdot A_{wc} - (U_ci_e + U_e(1-i_e)) \cdot A_{ce} }[/math]

where [math]\displaystyle{ i_w = \frac{X_{wc} - X_w}{X_c - X_w} }[/math] and [math]\displaystyle{ i_e = \frac{X_{ce} - X_c}{X_e - X_c} }[/math]

We now expand and simplify the equation, combining the constants into single variables.

[math]\displaystyle{ 0 = U_wi_wA_{wc} + U_c(1-i_w)A_{wc} - U_ci_eA_{ce} - U_e(1-i_e)A_{ce} }[/math]

[math]\displaystyle{ 0 = U_wk_{c,w} + U_ck_{c,c} + U_ek_{c,e} }[/math]

where [math]\displaystyle{ k_{c,w} = i_wA_{wc}, k_{c,c} = (1-i_w)A_{wc} - i_eA_{ce}, k_{c,e} = -(1-i_e)A_{ce} }[/math].

We can now apply this equation for cells 2 and 3. However, we can't apply this equation to cells 1 and 4, as they are on the boundary of the domain - the linear interpolation step does not work on the boundary. Without knowing what the value of U is at the boundaries, we cannot solve the continuity equation. Therefore we must apply some special treatment at the boundaries (called boundary conditions) in order to solve this issue. Boundary conditions are specified by the CFD user. We will use these boundary conditions:

• Flow velocity on the left boundary is fixed at 5 m/s (called a Dirichlet boundary - mnemonic: kind of sounds like "directly").
  • Plugging this condition into equation (1) gives the equation [math]\displaystyle{ 0 = 5 - U_ci_eA_{ce} - U_e(1-i_e)A_{ce} }[/math]
• The gradient of velocity [math]\displaystyle{ \frac {\partial U}{\partial x} }[/math] on the right boundary is zero - so the velocity on the right boundary is the same as the velocity at cell centroid 4.
  • Plugging this condition into equation (1) gives the equation [math]\displaystyle{ 0 = U_wi_wA_{wc} + U_c(1-i_w)A_{wc} - U_cA_{ce} }[/math]

• The constants are again combined into [math]\displaystyle{ k }[/math] variables.Here is a summary of all the equations found so far:
• Cell 1: [math]\displaystyle{ 0 = 5 + U_1k_{1,1} + U_2k_{1,2} }[/math]
• Cell 2: [math]\displaystyle{ 0 = 0 + U_1k_{2,1} + U_2k_{2,2} + U_3k_{2,3} }[/math]
• Cell 3: [math]\displaystyle{ 0 = 0 + U_2k_{3,2} + U_3k_{3,3} + U_4k_{3,4} }[/math]
• Cell 4: [math]\displaystyle{ 0 = 0 + U_3k_{4,3} + U_4k_{4,4} }[/math]

We now have a set of four simultaneous equations to solve for four unknowns (the velocity at each cell centroid).

Let us simplify the notation a bit using matrices and vectors.

[math]\displaystyle{ \begin{bmatrix} 0 \\ 0 \\ 0 \\ 0 \end{bmatrix} = \begin{bmatrix} 5 \\ 0 \\ 0 \\ 0 \end{bmatrix} + \begin{bmatrix} k_{1,1} & k_{1,2} & 0 & 0 \\ k_{2,1} & k_{2,2} & k_{2,3} & 0 \\ 0 & k_{3,2} & k_{3,3} & k_{3,4} \\ 0 & 0 & k_{4,3} & k_{4,4} \end{bmatrix} \begin{bmatrix} U_1 \\ U_2 \\ U_3 \\ U_4 \end{bmatrix} }[/math]

[math]\displaystyle{ \begin{bmatrix} k_{1,1} & k_{1,2} & 0 & 0 \\ k_{2,1} & k_{2,2} & k_{2,3} & 0 \\ 0 & k_{3,2} & k_{3,3} & k_{3,4} \\ 0 & 0 & k_{4,3} & k_{4,4} \end{bmatrix} \begin{bmatrix} U_1 \\ U_2 \\ U_3 \\ U_4 \end{bmatrix} = \begin{bmatrix} -5 \\ 0 \\ 0 \\ 0 \end{bmatrix} }[/math].

Abbreviated with a matrix of coefficients [math]\displaystyle{ \boldsymbol{M} }[/math], a solution vector [math]\displaystyle{ \boldsymbol{U} }[/math], and a right-hand-side vector [math]\displaystyle{ \boldsymbol{B} }[/math]:

[math]\displaystyle{ \boldsymbol{MU=B} }[/math], where

[math]\displaystyle{ \boldsymbol{M}= \begin{bmatrix} k_{1,1} & k_{1,2} & 0 & 0 \\ k_{2,1} & k_{2,2} & k_{2,3} & 0 \\ 0 & k_{3,2} & k_{3,3} & k_{3,4} \\ 0 & 0 & k_{4,3} & k_{4,4} \end{bmatrix} }[/math], [math]\displaystyle{ \boldsymbol{U} = \begin{bmatrix} U_1 \\ U_2 \\ U_3 \\ U_4 \end{bmatrix} }[/math], and [math]\displaystyle{ \boldsymbol{B} = \begin{bmatrix} -5 \\ 0 \\ 0 \\ 0 \end{bmatrix} }[/math]

At this point a CFD solver would calculate each of the coefficients of the matrix. Here we have a uniform cell spacing and uniform face areas.

[math]\displaystyle{ \boldsymbol{M}= \begin{bmatrix} -0.5 & -0.5 & 0 & 0 \\ 0.5 & 0 & -0.5 & 0 \\ 0 & 0.5 & 0 & -0.5 \\ 0 & 0 & 0.5 & -0.5 \end{bmatrix} }[/math]

We could now invert the matrix [math]\displaystyle{ \boldsymbol{M} }[/math], and calculate the solution vector [math]\displaystyle{ \boldsymbol{U} }[/math] using [math]\displaystyle{ \boldsymbol{U=M^{-1}B} }[/math]. This yields a solution of U = 5 m/s everywhere. Hooray!

Think: does this result make sense, given our assumptions?

Why matrix inversion rarely happens

The matrix [math]\displaystyle{ \boldsymbol{M} }[/math] always has size n x n, where n is the number of cells in the mesh (in this case 4). But typical CFD cases will have n in the thousands or millions - inverting matrices of this size becomes very time consuming. So instead, CFD solvers use an iterative approach on the equation [math]\displaystyle{ \boldsymbol{MU=B} }[/math], where they start with a guess for [math]\displaystyle{ \boldsymbol{U} }[/math], and improve their guess with successive iterations of an algorithm until the solution vector [math]\displaystyle{ \boldsymbol{U} }[/math] is "close enough" (this threshold is determined by the CFD user). The error in a solution for a variable is characterised by the "residual". A small residual means the solution has only a small error, and vice versa. The CFD user specifies what residual value qualifies as "close enough".

The momentum equation

In a similar process to the continuity equation, we can convert "F=ma but for fluids" into an actual equation, with the intermediate equation: rate of change of momentum at any point = rate of momentum flow in - rate of momentum flow out. For an arbitrary cell C experiencing pressure forces and an external force F, noting that

[math]\displaystyle{ UA = }[/math] the rate of flow of volume through a face, and

[math]\displaystyle{ \frac{mU}{V} = \frac{\rho U V}{V} = \rho U = }[/math] the momentum per unit volume of fluid, we can write

[math]\displaystyle{ \frac{\partial (\rho V U)_c}{\partial t} = ({\rho}UUA)_{wc} - ({\rho}UUA)_{ce} + (pA)_{wc} - (pA)_{ce} + F }[/math]

Next we apply the assumptions of steady incompressible flow and zero external force.

[math]\displaystyle{ 0 = ({\rho}UUA)_{wc} - ({\rho}UUA)_{ce} + (pA)_{wc} - (pA)_{ce} + F }[/math]

[math]\displaystyle{ 0 = (UUA)_{wc} - (UUA)_{ce} + \frac{(pA)_{wc}}{\rho} - \frac{(pA)_{ce}}{\rho} + \frac{F}{\rho} }[/math]

[math]\displaystyle{ 0 = (UUA)_{wc} - (UUA)_{ce} + \frac{(pA)_{wc}}{\rho} - \frac{(pA)_{ce}}{\rho} }[/math]

At this point, we would continue by applying either

• Boundary conditions for faces on the boundary, or
• An interpolation scheme (often linear) for internal faces.

Then we would calculate the coefficients of the matrix, and either invert the matrix or use an iterative method to solve it. For brevity, I will not go through this process, as the general process is similar with the continuity equation.

Optional exercise: try applying these steps with

• Zero pressure gradient on the left boundary,
• Fixed pressure of 0 on the right boundary,
• The solution found in the previous section for U.

You should find that the pressure everywhere is 0 Pa.

Optional: The energy equation

In case we also wanted to find the temperature of the fluid throughout the domain, we could solve the energy equation: rate of change of energy at a given point = rate of energy flow in - rate of energy flow out. I will not go through the derivation here - it is enough to know that the CFD solver performs an iterative approach to solve for temperature using the conservation of energy until the residual is low enough.

In the case of an incompressible flow, this isn't necessary, since density is constant. But for a compressible flow, the density at a given location is a function of temperature, so it is necessary to find the temperature everywhere in the fluid, so that the density can be found.

Optional: Higher dimensions

• In this example, we have been solving for velocity in the x direction by applying conservation of momentum in just one direction - the x axis.
• In 2D, we must also solve for velocity in the y direction. For this, we will apply conservation of momentum in the y axis.
• Similarly in 3D, we need to solve the momentum equation in all three axes: x, y, and z to obtain the components of velocity in each direction.
• The momentum equation can be generalised to work in arbitrary dimensions - the process isn't important for now, although you should know that the spatial derivatives (e.g. [math]\displaystyle{ \frac{\partial}{\partial x} }[/math]) are written with different notation, resulting in some terms called the "gradient", the "divergence", and the "laplacian" of a variable. This is called vector calculus - I recommend this Khan Academy course, if you have not yet learned this in the engineering course at Cambridge.

Optional: Viscosity and turbulence

We ignored the effects of viscosity, but this is straightforward to include in the momentum equation, simply by adding an extra force to the equation to account for viscosity.

We ignored turbulence in the momentum equation for this example, but real flows often exhibit turbulence ("random" fluctuations), especially at high speeds and low viscosities. Since the effect of turbulence is to increase mixing between layers, it can be modelled using a modified viscosity. This modified viscosity is the sum of the ordinary viscosity and the "turbulent viscosity" - this turbulent viscosity is calculated at every location in the mesh by a turbulence model. The turbulence models calculate some variables which quantify the turbulence at every location, and use those variables to calculate the turbulent viscosity. Some common turbulence models include (along with some broad pros & cons):

• K-epsilon model: best for use when the cells are quite large ("coarse") near the walls, and for preliminary simulations.
• K-omega model: requires smaller (finer) cells near the walls in order to work best. Generally more accurate than K-epsilon, but more computationally expensive, and requires a finer mesh. Is also more sensitive to boundary conditions than K-epsilon.
• K-omega SST (Shear Stress Transport) model: a combination of the K-epsilon and K-omega models, with an added shear stress transport model. Generally more accurate than K-omega and K-epsilon, but requires a finer mesh and is more computationally expensive than K-epsilon.

Optional: Stability tips

• CFD simulations can sometimes have variables blow up to infinity or show unphysical oscillations in the flow, if care is not taken with the setup process. The stability of a simulation (i.e. how likely it is to avoid blowing up) can be influenced by choice of numerical scheme, the quality of the mesh, and the selection of boundary conditions.
• In OpenFOAM, each operation has its own numerical scheme selection - for example:
  • Interpolation (we used the linear scheme for this operation in the example above),
  • Gradient,
  • Divergence - this one is particularly influential to stability,
  • Laplacian.
• Details on the selection of which scheme to use is beyond the scope of this section, but a good rule-of-thumb is that less accurate schemes (e.g. upwind interpolation) tend to be more stable, and vice versa. Gradient limiters can also be used to add stability at the expense of accuracy.
• Meshing is not as straightforward as shown here, especially with more complicated geometries. Sometimes, poor quality meshes can cause problems with the simulation. There are numbers that meshing software can calculate to represent the quality of a mesh (called a mesh quality metric).
  • For example, meshes with orthogonal cells perform better than those with non-orthogonal cells. In our example, all the cells were perfectly orthogonal - that is, the faces were perpendicular to the lines between the adjacent cell centroids.
  • How close the cells are to having perpendicular faces is called the "orthogonal quality" in ANSYS.
  • In OpenFOAM, the opposite of this is given as the "non-orthogonality angle".
  • Other examples include cell skewness (lower is better) and cell aspect ratio (closer to 1 is better). It is important to ensure these quality metrics are not too bad, otherwise the stability and accuracy of the simulation can be affected.

Optional: Common tripping points

The solution vector [math]\displaystyle{ \boldsymbol{U} }[/math] does not store the components of velocity, i.e. [math]\displaystyle{ U_x, U_y, U_z }[/math], but instead stores the velocities at each cell centroid, i.e. [math]\displaystyle{ U_1, U_2, U_3, U_4 }[/math]. Indeed, the solution vector [math]\displaystyle{ \boldsymbol{U} }[/math] summarises the x-velocity at every point in our domain, while hypothetically the scalars [math]\displaystyle{ U_x, U_y, U_z }[/math] would only specify the 3D velocity at one point. Since we are currently only concerned with x-velocity, this might be more clear, but in higher dimensions it is important not to get confused.

The term [math]\displaystyle{ p/\rho }[/math] is sometimes called the "kinematic pressure". When an incompressible fluid is used, it is sometimes what the CFD software (e.g. OpenFOAM) will confusingly call p. So when finding the pressure drop, you may have to multiply by density. The best way to check whether you need to multiply by density, is to look at the units of p that the CFD software gives you. Ordinary pressure has units [math]\displaystyle{ kgm^{-1}s^{-2} }[/math], while kinematic pressure has units [math]\displaystyle{ m^{2}s^{-2} }[/math].

Optional: Further reading

Hopefully this has been an understandable / intuitive explanation of roughly what most CFD solvers do. If you want to explore the topics mentioned here in more detail, here are some resources that might help:

• An Introduction to Computational Fluid Dynamics: The Finite Volume Method - https://books.google.co.uk/books/about/An_Introduction_to_Computational_Fluid_D.html?id=RvBZ-UMpGzIC
  • I highly recommend this book for further reading - it is usually behind a paywall, but you can sometimes find an old freely available copy by simply googling: versteeg cfd filetype:pdf
• Fluid Mechanics 101 - YouTube channel: https://www.youtube.com/channel/UCcqQi9LT0ETkRoUu8eYaEkg/
  • Has some very well explained and illustrated videos on a random selection of CFD topics.
• ANSYS Fluent Theory Guide - find it with google.
  • Usually a bit easier to find a copy of, but isn't ideal for someone who isn't already familiar with CFD and the finite volume method.
• OpenFOAM: A little user manual - https://www.researchgate.net/publication/340174689_OpenFoam_-_a_little_user_manual
  • Click "Download full-text PDF", since the preview isn't available.
  • More specific to OpenFOAM and its code syntax, but contains some discussion of the fundamental algorithms which are used everywhere, e.g. SIMPLE, PISO, PIMPLE, as well as some turbulence models.
• OpenFOAM wiki - http://openfoamwiki.net/index.php/Main_Page
  • Contains some useful derivations of equations as well as tips & tricks, but is a bit hit-and-miss in quality and ease of navigation.

Fluid-structure interaction (FSI)

IMPORTANT: Although I hope that these instructions will be easily understood by anyone, this is not a beginner's project! If you want a proper introduction to CFD, this is not it. (I am in the process of creating a beginner's guide which will be available soon™)

This technique allows complex interactions between flexible structures and fluid flows. This has been used to predict fin flutter at hypersonic speeds for Griffin 1.

Simulations of this kind are achievable with the combination of the following free open-source software packages:

• OpenFOAM (website, install on Ubuntu) - a C/C++ library for the solution of fluid mechanics problems formulated with the Finite Volume Method (FVM),
  • Important: there are two main versions of OpenFOAM, provided at OpenFOAM.com and OpenFOAM.org. I have only used the .com version, but everything here should also be possible with the .org version.
• FEniCS (website, install on Ubuntu) - a Python interface to the DOLFIN C++ library for the solution of solid mechanics problems formulated with the Finite Element Method (FEM), and
• preCICE (website, install on Ubuntu) - a very powerful library which allows the coupling of arbitrary solvers using human-readable syntax.
  • Note: in order to use OpenFOAM and FEniCS with preCICE, it is also necessary to download their respective adapters. See this page for OpenFOAM and this page for FEniCS from the preCICE website for further information.

Step-by-step instructions

IMPORTANT: Although I include the links to the official websites for Ubuntu installation instructions, I recommend you follow my instructions for installation (unless my instructions no longer work, or you are a masochist), since the official instructions contain some mistakes and omissions.

Install Ubuntu

If you are running a Windows machine (Windows 10 or above), I recommend installing Windows Subsystem for Linux (WSL - use WSL1, discussion of WSL2 below) instead of setting up a dual-boot partition.

• Note: there is a choice between WSL1 and WSL2, with the main difference being that WSL2 has significantly improved read-write speeds compared with WSL1 while staying within the Linux file system, but WSL2 has significantly worse read-write speeds when moving between the Linux and Windows file systems. In practical terms, this means that the Linux-based software (OpenFOAM, FEniCS) will read and write faster, at the expense of Windows-based ParaView installations loading results much slower when post-processing. Since OpenFOAM spends significantly more time solving equations than reading and writing files, and gigabytes of data need to be loaded across file systems for post-processing in Windows, I recommend sticking with WSL1. If you prefer WSL2, you can install ParaView on Ubuntu, installing XMing to view the GUI (see this page and this page for further information)

Install OpenFOAM on Ubuntu

The Ubuntu installation instructions as of 31/12/2021 are summarised below (adapted from this website):

curl -s https://dl.openfoam.com/add-debian-repo.sh | sudo bash
sudo apt-get install openfoam2012-default

Ensure that your ~/.bashrc file has the following line appended (with XXXX replaced with your version number):

source /usr/lib/openfoam/openfoamXXXX/etc/bashrc

Restart your Ubuntu. Now check the installation completed correctly by running a tutorial case:

cd ~
mkdir -p OpenFOAM-sims/tutorials
cp -r $FOAM_TUTORIALS/incompressible OpenFOAM-sims/tutorials
cd OpenFOAM-sims/tutorials/incompressible/icoFoam/cavity/cavity/
blockMesh > log.blockMesh
icoFoam > log.icoFoam

Note: I use OpenFOAMv2012, but later versions should also work.

Install FEniCS on Ubuntu

The Ubuntu installation instructions as of 31/12/2021 are summarised below (adapted from this website):

sudo apt-get install software-properties-common
sudo add-apt-repository ppa:fenics-packages/fenics
sudo apt-get update
sudo apt-get install fenics

Install preCICE on Ubuntu

The Ubuntu installation instructions as of 31/12/2021 are summarised below (adapted from this website):

sudo apt update
sudo apt install build-essential cmake libeigen3-dev libxml2-dev libboost-all-dev petsc-dev python3-dev python3-numpy
cd ~
mkdir FSI
cd FSI

Now either install the Ubuntu package directly with the instructions below (which did not work for me)...

wget https://github.com/precice/precice/releases/download/v2.3.0/libprecice2_2.3.0_focal.deb
sudo apt install ./libprecice2_2.3.0_focal.deb

... or install from source:

tar -xzf v2.3.0.tar.gz
cd precice-2.3.0
mkdir build
cd build
cmake -DBUILD_SHARED_LIBS=ON -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=~/FSI/precice-2.3.0 -DPRECICE_MPICommunication=ON .. ### IMPORTANT! INCLUDE THE TWO DOTS!
make -j 4

Test that the cmake command worked as expected:

cd ~/FSI/precice-2.3.0/build
ctest --output-on-failure

If no errors were shown, install the software and test it worked:

make install
make test_install

Note: I used preCICE v2.3.0, but later versions should also work.

Install the OpenFOAM-preCICE adapter

The Ubuntu installation instructions as of 31/12/2021 are summarised below (adapted from this website):

cd ~/FSI
wget https://github.com/precice/openfoam-adapter/releases/download/v1.0.0/openfoam-adapter_v1.0.0_OpenFOAMv1812-v2012.tar.gz
tar -xzf openfoam-adapter_v1.0.0_OpenFOAMv1812-v2012.tar.gz
cd openfoam-adapter_v1.0.0_OpenFOAMv1812-v2012/
export LD_LIBRARY_PATH=/usr/lib/x86_64-linux-gnu:$LD_LIBRARY_PATH ### This line may-or-may-not be needed. YMMV.
./Allwmake

Note: this is for OpenFOAMv2012. Please see the preCICE website for information on adapters for later versions.

Install the FEniCS-preCICE adapter

The Ubuntu installation instructions as of 31/12/2021 are summarised below (adapted from this website). This requires Python3, which should already be installed if you followed my previous instructions:

(optional, should not need this line) python3 -m pip install scipy
python3 -m pip install --user fenicsprecice

Test the installation ran correctly

... by running this tutorial case:

cd ~/FSI
git clone --branch=master --depth 1 https://github.com/precice/tutorials.git
cd ~/FSI/tutorials/perpendicular-flap/fluid-openfoam
./run.sh

The command line output should have paused after this output. If it did not pause, something went wrong.

---[precice]  I am participant "Fluid"
---[precice]  Setting up master communication to coupling partner/s

Now open another Ubuntu terminal, and run these commands:

cd ~/FSI/tutorials/perpendicular-flap/solid-fenics
./run.sh

Both terminals should now have log outputs flying. After around 1 minute of computation, both terminals should finish at (roughly) the same time. You can view the results with the following commands, assuming you have installed ParaView on Windows and added the folder containing its .exe file to the Windows PATH environment variable:

cd ~/FSI/tutorials/perpendicular-flap/fluid-openfoam
paraview.exe fluid-openfoam.foam

Congratulations! You should now have a functional FSI installation.

Note that as of 31/12/2021, the unmodified FEniCS-preCICE adapter only works in 2D, so you will have to edit the adapter (or download my edited version, TODO add link here) in order to add 3D FSI functionality. Or just wait a few months until I get around to submitting a pull request for my version.

TODO:

• ParaView install instructions
• Resources for learning CFD and FEM
• A complete line-by-line breakdown of simpleFoam
• rhoCentralFoam resources
• rhoCentralFoam rotating reference frame
• Tips and Tricks from experience
• How to do 3D hypersonic fin flutter