As a usual user on your workstation, open 2 command terminals. Instructions to be typed in each of them will be given in the following using a specific color for each one.

Make a escabooz project

In the first terminal, log on your Supélec account. Let us suppose here that the machine hosting your account is perso.metz.supelec.fr, and that your login is smith. Let suppose that you use fred.ic as a frontal to the cluster.

ssh -Y smith@perso.metz.supelec.fr
ssh -Y fred.ic

Now, your are on fred on this terminal. Let us create one of the tutorial escabooz projects at your home directory.

You’re now at the project directory level, having a Makefile that is a copy of a default one. Edit this makefile, and consider to customize only the first part, between the two arrows. The current project is 2D. We will split first dimension into 3 parts, and second into 2 parts, which makes 6 subdivisions of the simulation space. The evaluation mode has to be synchronous for that project. The savings will be done by cutting the simulation space in 5x5 subregions. The resulting configuration should appear like this

Start the simulation

Now, we have to compile the project. Since we are on some frontal machine (fred.ic), generated executables will fit the cluster architecture.

make info

This recalls your settings for a check. Typing "make" provides you with a help. We can start to run on the cluster itself, reserving 6 nodes (SPLIT = 3 2).

make launch

The server machine you’ve been given is displayed. Keep that name in mind. Let suppose that it is "ic187".

Interact with a running simulation

On your workstation, open another terminal. We will suppose that your supelec account isn’t accessible from your worksation (no nfs mounting).

First, copy the project directory on your worksation disk, and clean it :

In order to communicate with the cluster, you need to open an encrypted ssh tunnel toward the server, that is "ic187" in our example.

make NODE=ic187.ic.metz.supelec.fr tunnel

A terminal that handles the tunnelling appears, you have to enter your cluster password in it. If, you restart a new simulation, it may not be lauched twice on ic187... so you’ll have to close the terminal that handles the tunnelling.

Let us now interact with the simulation.

make control
make view

The rendering is described in file "3Dview.config". Edit "/usr/share/booz-gui-1.0/3Dview.config" to have an example of what this file can contain.

The simulation isn’t initialized with starting values. This can be done by posting those values to the server. For this project, wave.init contains the values.

make INIT=wave.init init

In the 3D viewer, set size to 100x100, and display every 10 steps.

Now, with the controller, you can run (play button) or command step by step (next button) the simulation.

Saving can be done in an internal format by using the related icons on the controller. You can obtain smarter datafiles files (text files) by using the escabooz saving facilities instead. Using the latter, to save or load your data, first stop the simulation (next button of the controller), and then

make save

or

make load

Quitting current simulation

You have first to kill the simuation properly, by pressing the red button (stop) of the controller.

You should also quit the ssh tunnelling terminal.

Your own simulation

The use of sage-based PDE solving provides you with a set of files, that are similar to the ones in escabooz-wave-tutorial, so you may proceed as presented here.