Gerris examples
Version 1.3.2 (131206-130125)

December 6, 2013


1  Introduction

This document is a collection of examples contributed by Gerris users and intended to illustrate the range of applications where Gerris is applicable. It should also serve as a useful starting point for customised applications.

The sections in this document are a rough classification of the various applications. In particular, an example appearing in a subsection usually indicates that this example is a relatively small incremental change over the parent example appearing in the section above it.

Gerris parameter files are commented and cross-linked with the Object Hierarchy documentation. As a rule, the first examples in the document contain comments for most of the instructions in the parameter file. Latter examples only contain comments for the relevant new instructions or for more complex usage of already introduced instructions.

The indicative running times given are representative of the running time on an Intel 2.4 GHz processor.

The usefulness and quality of this document very much depend on the contributions of users. If you think you have used Gerris in an interesting way which is not already covered by the existing examples, you are very welcome to contribute. Have a look at section 7 for instructions on how to do so.

2  2D

3  3D

4  Shallow-water

5  Saint-Venant (non-linear shallow-water)

6  Waves

7  How to write examples

This document is generated automatically using self-documenting Gerris parameter files. If you look at any of the .gfs files in this document you will see that apart from comments on specific instructions, the top of the file contains fields which describe the simulation. They are:

the title of the simulation.
a Latex block of text describing the simulation. It can contain figures, tables, equations etc…
the exact command needed to run the example.
the version of Gerris you used (output of gerris2D -V).
Required files:
any file (e.g. GTS files etc…) other than the Gerris simulation file required to run the simulation. Try to keep the total size of these files reasonable.
Running time:
the approximate total running time of the simulation. This is of course machine-dependent but must be appropriately scaled to be representative of the running time on an Intel 2.4 GHz processor.
Generated files:
any file (movies, images, curves etc…) generated by the simulation.

Apart from the “Description:” field all the fields must fit on a single line just after the field name.

Any extra data you need for the description (e.g. figures as EPS files) must be generated by the simulation. Have a look at other examples to see how this can be done.

Once you have an initial draft for your documented parameter file, you need to package it like this:

  1. Choose a short name for your example. This short name should not already be used by any of the examples in this document. Let’s say myexample.
  2. Create a directory myexample.
  3. Copy your parameter file in myexample/myexample.gfs. You must use the same name for the directory and the parameter file.
  4. Copy any other file you need (as listed in the “Required files:” field) in myexample.
  5. Cd to myexample and re-run the simulation (using the command listed in the “Command:” field) or alternatively copy the previously generated files listed in the “Generated files:” field into myexample.
  6. Cd to myexample/..
  7. Generate the HTML and PDF documentation for your example using:
    % gfs2doc myexample
    Note that this script requires hevea.
  8. Check that the myexample_html/index.html and myexample.pdf files are to your liking. If they are not, edit your parameter file and return to 7.
  9. Send me (s.popinet at your example (myexample.tgz as an attachment). Tell me which section, subsection you think it would most naturally fit in (or request a new section). I will then review it and integrate it in this document.


Hyunuk An and Soonyoung Yu. Well-balanced shallow water flow simulation on quadtree cut cell grids. Advances in Water Resources, 39:60–70, 2012.
H. Glauert. The Elements of Aerofoil and Airscrew Theory. Cambridge University Press, 1926.
S.T. Grilli, M. Ioualalen, J. Asavanant, F. Shi, J.T. Kirby, and P. Watts. Source constraints and model simulation of the December 26, 2004, Indian Ocean Tsunami. Journal of Waterway, Port, Coastal, and Ocean Engineering, 133:414–428, 2007.
N.R. Hanson. A picture theory of theory meaning. The nature and function of scientific theories, pages 233–274, 1970.
E. N. Jacobs, K. E. Ward, and R. M. Pinkerton. The characteristics of 78 related airfoil sections from tests in the variable-density wind tunnel. Technical report, NACA Technical Report 460, 1933.
P.-Y. Lagrée, L. Staron, and S. Popinet. The granular column collapse as a continuum: validity of a Navier–Stokes model with a µ(i)-rheology. Journal of Fluid Mechanics, 2011.
R.J. LeVeque and D.L. George. High-resolution finite volume methods for the shallow water equations with bathymetry and dry states. Advanced numerical models for simulating tsunami waves and runup, 10:43–73, 2006.
L.M. Milne-Thomson. Theoretical aerodynamics (4th ed.). Dover, New York, 1973.
S. Popinet. Quadtree-adaptive tsunami modelling. Ocean Dynamics, 61(9):1261–1285, 2011.
C. Rosales and C. Meneveau. Linear forcing in numerical simulations of isotropic turbulence: Physical space implementations and convergence properties. Physics of Fluids, 17:095106, 2005.
L. Staron and E. J. Hinch. Study of the collapse of granular columns using two-dimensional discrete-grain simulation. Journal of Fluid Mechanics, 545:1–27, 2005.
J. J. Videler. Avian Flight. Oxford Ornithological Studies. Oxford University Press, 2006.

This document was translated from LATEX by HEVEA.