252-0867-00L SS21 Engineering Tool: Case Study Physics Simulations - Course Exercises

Exercise Overview

Exercise 1: Time Integration

Exercise 2: Rigid Body Dynamics

Exercise 3: Eulerian Fluid Solver

Exercise 4: SPH Solver

Installation

Git and CMAKE

Before we begin, you must have Git running, a distributed revision control system which you need to handin your assignments as well as keeping track of your code changes. We refer you to the online Pro Git book for more information. There you will also find instructions on how to to install it. On Windows, we suggest using git for windows.

CMake is the system this framework uses for cross-platform builds. If you are using Linux or macOS, I recommend installing it with a package manager instead of the CMake download page. E.g. on Debian/Ubuntu:

sudo apt-get install cmake

or with MacPorts on macOS:

sudo port install cmake.

On Windows, you can download it from: https://cmake.org/download/

Note for linux users

Many linux distributions do not include gcc and the basic development tools in their default installation. On Ubuntu, you need to install the following packages:

sudo apt-get install build-essential libx11-dev mesa-common-dev libgl1-mesa-dev libglu1-mesa-dev libxrandr-dev libxi-dev libxmu-dev libblas-dev libxinerama-dev libxcursor-dev

If you are using linux with a virtual machine on Windows, it is strongly recommended to use Visual Studio instead.

Note for Windows users

The code depends on libigl. It supports the Microsoft Visual Studio 2015 compiler and later, in 64bit mode. You can download Visual Studio 2019 Community for free from here.

Cloning the Exercise Repository

Before you are able to clone your private exercise repository, you need to have an active gitlab@ETH account. Then you can fork this project to create your own private online repository.

In the next step you need to clone it to your local hard drive:

git clone https://gitlab.ethz.ch/'Your_Git_Username'/engtool21.git

'Your_Git_Username' needs to be replaced accordingly. This can take a moment.

Next, cd into the newly created folder, and run the following commands inside the relevant subfolder to setup the build folder:

cd engtool21; mkdir build
cd build
cmake ..

On Windows, use the CMAKE gui with the buttons Configure and Generate.

Compile and run the executable, e.g. Ubuntu:

make && ./0_dummy/0_dummy

Or use your favorite IDE. In case of Visual Studio, you need to open build/PBS.sln file.

Update Your Forked Repository

To update your forked repository, check this page: how-do-i-update-a-github-forked-repository

Basically, you are required to add our repository as a remote to your own one:

git remote add upstream https://gitlab.ethz.ch/cglsim/engtool21.git

Then, fetch updates from it:

git fetch upstream

Lastly, move to your master branch and merge updates into yours:

git checkout master
git merge upstream/master

Note that you need to run the first line only once for adding, and the following steps (cmake as well!) should be done again for new updates.