Run SWE on the sphere with Graphical User Interface (GUI).

Activate environment

From the SWEET’s root directory, call

$ . ./activate.sh

Install libSDL

Install libSDL which is required for the GUI (if not yet done):

Go to the software management folder.

$ cd local_software

Install libSDL

$ ./install_sdl2.sh

Cleanup

$ make clean

Compile

Compile PDE_SWESphere2D program for the shallow-water equations on the sphere including the visualization

$ scons --program=programs/PDE_SWESphere2D --gui=enable

Run

Execute program with the following parameters:

$ ./build/programs/PDE_SWESphere2D_COMP_plspec_pldeal_spspec_spdeal_gui_fft_thomp_release  -M 128 --timestepping-method=ln_erk --timestepping-order=4 --dt=300 --benchmark-name=three_gaussian_bumps

The GUI is automatically enables if compiled with GUI enables.

The other program options are explained in a previous tutorial.

Troubleshooting

The GUI doesn’t show up, but the program is running

Very likely, the X11 dev headers or the GL header files are not installed. In Ubuntu, you need to install the packages libx11-dev libgl-dev

How to use the GUI?

  • [b]/[B] Cycle to next/previous visualization style (Cart2D / Sphere2D)

  • [v]/[V] Cycle to next/previous field for visualization

  • [1]-[9] Render only each [number]^2 frame

  • [space] Pause the simulation

  • [j] Run single time step (after pausing the simulation)

  • [e] Reset perspective

  • [r] Reset simulation

  • [q] Quit simulation